Skill v1.0.0
currentAutomated scan100/100name: project-charter description: "Trigger: project charter, acta de proyecto, arrancar proyecto nuevo, definir alcance, objetivos, criterios de aceptacion, riesgos. Pregunta antes de escribir." license: Apache-2.0 metadata: author: "axioma (fork de gentle-ai)" version: "1.0"
Project Charter — fase 0 del flujo
Activation Contract
Use when a project is starting and there is no agreed statement of what gets built, for whom, with what scope, and under which acceptance criteria. The failure mode this skill exists to prevent: inventing an answer the user never gave, so the whole downstream chain — educciones, mockups, code — is built on a fabricated premise.
The charter is written in Spanish and lives at docs/charter/00-PROJECT-CHARTER.md, versioned with the code.
Hard Rules
- First ask whether the user already has requirement documents. If they do, tell them to drop them in
docs/requisitos-existentes/, Markdown preferred, and read them before asking anything already answered there. - Every value in the charter comes from the user or from a document they supplied. Nothing is inferred from the project name, the stack, or what "projects like this usually want".
- Ask in rounds of at most 5 questions. Wait for the answers. Do not write the charter and ask afterwards.
- An unanswered question stays
(definir)in the document, and is reported to the user at the end. It is never filled with a plausible guess. - Contradictions between supplied documents, or between a document and the user's answer, are surfaced explicitly and resolved by asking. Never silently pick one.
- No cronograma in the charter. Dates age badly inside an agreement document; they live where the project is managed.
- Every objective (
O-n) carries a measurable verification criterion, and every acceptance criterion (CA-n) carries a concrete verification method — a demo, a test, an audit. "Funciona bien" is not a criterion. - «Alcance NO INCLUYE» states the reason for each exclusion, not just the exclusion. An exclusion with no reason reopens as a fight later.
- Run
axioma charter statusbefore declaring the charter done. It iscompletoonly when the tool says so. - Record what the user decided in the log:
axioma bitacora add "<decisión>" --fase charter --rol usuario.
The question set
Ask these, adapted to the project. Skip any already answered by a supplied document, and say which document answered it.
- Contexto — ¿Qué existe hoy? ¿Es un sistema nuevo o uno que ya está en producción? ¿Qué limitación concreta te duele?
- Objetivo — Si esto sale perfecto, ¿qué cambia para tu organización? ¿Cómo se mediría?
- Usuarios — ¿Quiénes lo van a usar y qué hace cada tipo de usuario? (esto se convierte en el catálogo de actores)
- Alcance incluido — ¿Qué componentes entran sí o sí?
- Alcance excluido — ¿Qué NO entra, y por qué? (la razón importa tanto como la exclusión)
- Integraciones — ¿Con qué sistemas externos tiene que hablar? ¿Pagos, correo, CRM, autenticación?
- Restricciones — ¿Stack obligatorio, hosting, presupuesto, plazos duros, normativa?
- Riesgos — ¿Qué te preocupa que salga mal? ¿Qué ya salió mal antes?
- Aceptación — ¿Cómo vas a saber que está terminado? ¿Quién firma?
- Stakeholders — ¿Quién decide qué? ¿Quién aprueba el alcance y quién aprueba lo técnico?
Decision Gates
| Situation | Action | |
|---|---|---|
| No preguntaste todavía si tiene documentos | Pregunta eso primero, antes que nada | |
| El usuario tiene documentos | Léelos, indica docs/requisitos-existentes/, y solo pregunta lo que falta | |
| Una respuesta no llegó | (definir) en el documento y reportalo al final. Nunca la inventes | |
| Dos fuentes se contradicen | Nombra la contradicción y pregunta. Nunca elijas en silencio | |
| Un objetivo no tiene forma de medirse | No es un objetivo todavía: pregunta cómo se verificaría | |
| El usuario pide empezar a codear ya | Di qué queda sin definir y qué riesgo concreto trae. Si insiste, es su decisión: regístrala en la bitácora y sigue | |
charter status dice pendiente | No está terminado. Arregla lo que nombra |
Output Contract
Al terminar: la tabla de axioma charter status, la lista de lo que quedó en (definir) con la pregunta exacta que falta responder, las contradicciones encontradas, y la entrada de bitácora que registró las decisiones del usuario.
Con el charter completo, el siguiente paso es /analisis-init.