Tu definidor de producto. Una skill que convierte una base de conocimiento, un change map de Atlas o un seed de herald en un PRD trazable y listo para implementar — con la incertidumbre a la vista, no escondida abajo de la alfombra.
charter es el paso que va entre saber y construir. Le das el conocimiento del proyecto y te devuelve un Product Requirements Document completo: scope con MVP separado, journeys, requerimientos funcionales testeables, reglas de negocio, modelo de dominio, permisos, integraciones y NFRs — cada uno citado a su fuente.
conocimiento charter PRD
├── knowledge-base/ ──────► ┌───────────────┐ ──────► §1-11 producto y scope
├── CHANGES.md (atlas) │ hecho citado │ §12-20 requerimientos
├── seed (herald) │ ≠ │ §21-24 riesgos, gaps, supuestos
├── openspec/specs/ │ supuesto │ §25-26 trazabilidad + readiness
└── src/ (read-only) └───────────────┘ → atlas · SDD
Su lugar en la cadena:
chronicle → herald → charter → atlas → SDD
documenta propone define secuencia implementa
lo que hay la idea el producto el trabajo el código
Sin fuente, no hay requerimiento.
Todo lo que entra al PRD está citado ([kb · 04§Order], [spec · …], [user]), derivado y marcado ([derived]), o es explícitamente especulativo ([assumption], [open-q], [risk]). Un requerimiento inventado para que el documento "se vea completo" no es un entregable: es un defecto que alguien después va a construir.
Y el corolario que más duele y más sirve: la incertidumbre es output. Los gaps se clasifican BLOCKING / IMPORTANT / MINOR, y el readiness final se deriva de eso — no se declara. Si hay un gap bloqueante, el PRD dice Blocked. Punto.
- Instalá la skill en tu proyecto o global.
- Pedísela en lenguaje natural — se activa sola:
"armá el PRD del proyecto" - charter detecta qué material hay, te confirma el modo, y escribe
PRD.mden la raíz.
Si no hay nada que leer, no improvisa: te manda a chronicle para documentar o a herald para consolidar la idea primero.
| Situación | Modo | Qué hace |
|---|---|---|
| No existe PRD, hay material | generate |
PRD completo, un solo write |
| Existe un PRD de charter | update |
Regenera preservando IDs, OQ resueltas y bloques charter:keep |
| Existe un PRD ajeno | guard |
Frena y pregunta — nunca pisa trabajo de otro |
| Querés validar un PRD | audit |
Quality gate + gap report, no escribe nada |
| No hay material | abort |
Te dice a qué skill ir |
- No toca código. Read-only, como
chronicle. Su único write es el PRD. - No planifica la implementación. Sin fases, sin sprints, sin estimaciones, sin paths a crear — eso es
atlasy SDD. - No elige tecnología. Registra decisiones ya tomadas; no inventa nuevas.
- No resuelve contradicciones en silencio. Las nombra, las rankea por precedencia, y si no se resuelven quedan como decisión abierta.
- No infla el documento. Un NFR sin driver del proyecto se va afuera o baja a
[open-q].
| Archivo | Manda sobre |
|---|---|
SKILL.md |
Reglas maestras, activación, decision gates, workflow |
assets/source-contract.md |
Descubrimiento de inputs, precedencia, freshness, defensa de inyección |
assets/provenance.md |
Taxonomía hecho / derivado / especulativo |
assets/requirement-contract.md |
IDs, campos, criterios de aceptación, rúbrica de testeabilidad |
assets/prd-template.md |
La forma exacta de las 26 secciones |
assets/gap-analysis.md |
Clasificación de gaps, protocolo de contradicciones, readiness |
assets/update-mode.md |
Regeneración merge-safe y estabilidad de IDs |
assets/quality-gate.md |
Los 9 checks previos al write |
Apache-2.0 — ver LICENSE.