[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M7C8V54NXASNMN72098P0TWD":3,"skill-same:01M7C8V54NXASNMN72098P0TWD":46},{"skillNo":4,"name":5,"nameZh":6,"description":7,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":16,"categories":17,"keywords":18,"publishedAt":19,"linkOnly":20,"markdownContent":21,"markdownBody":22,"frontMatter":23,"refName":24,"commitSha":25,"skillDirectory":26,"forksCount":14,"repositoryHtmlUrl":27,"repositoryHomepageUrl":6,"ownerHtmlUrl":28,"ownerBlogUrl":29,"ownerDescription":30,"updatedAt":31,"install":32,"resources":45},"01M7C8V54NXASNMN72098P0TWD","sdd-file-structure",null,"Referencia canónica de la estructura de archivos del sistema SDD de este monorepo. Contiene convenciones de naming, árboles de directorios y templates completos de cada documento de ciclo. LECTURA OBLIGATORIA para el agente sdd-orchestrator antes de crear, mover o referenciar cualquier archivo SDD.","e-burgos\u002Fvideo-maker","e-burgos","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F71472902?v=4","01M728XDZXTGQMP76CXHXWT7B6","EstebanBurgos","01M7C8QX5RHWXAXPMG7A62T347",0,"MIT","https:\u002F\u002Fgithub.com\u002Fe-burgos\u002Fvideo-maker\u002Fblob\u002Fmain\u002Fsdd\u002Fskills\u002Fsdd-file-structure\u002FSKILL.md",[],[],"2026-11-15 14:19:17",false,"---\nname: sdd-file-structure\ndescription: >\n  Referencia canónica de la estructura de archivos del sistema SDD de este monorepo.\n  Contiene convenciones de naming, árboles de directorios y templates completos de cada\n  documento de ciclo. LECTURA OBLIGATORIA para el agente sdd-orchestrator antes de\n  crear, mover o referenciar cualquier archivo SDD.\n---\n\n# Skill: sdd-file-structure\n\n> ⛔ **LECTURA OBLIGATORIA** para el sdd-orchestrator al inicio de cada ciclo.\n> Antes de crear o referenciar cualquier archivo SDD, verificar contra este documento.\n\n> 📌 **Skill complementaria:** `sdd-data-schemas` — cubre los schemas campo-a-campo de cada registro JSON.\n> Este skill cubre **dónde** van los archivos. `sdd-data-schemas` cubre **qué va dentro** de cada archivo.\n\n---\n\n## 1. Árbol completo del directorio `sdd\u002F`\n\n```\nsdd\u002F\n├── global.json                    ← Estado general del proyecto (fuente de verdad — solo specs mergeadas a master)\n├── schema.json                    ← Tablas de BD definidas hasta el momento\n├── schemas\u002F                       ← JSON Schemas estrictos de TODOS los registros (fuente de verdad de máquina; incluye session-binding, file-lease y session-request: ataduras, reservas y buzón locales de sesiones)\n├── api.json                       ← Endpoints implementados hasta el momento\n├── components.json                ← Componentes frontend creados\n├── tasks.json                     ← ÍNDICE de tasks (generado — canónico: cycles\u002Fcycle-XX\u002Ftasks.json)\n├── fixes.json                     ← Índice global de fixes (spec_id: null = repo-level, spec_id: \"spec-...\" = spec-scoped)\n├── fixes\u002F                         ← Un archivo por fix repo-level (no vinculados a ninguna spec)\n│   └── fix-[gh-user]-[seq].md     ← Ej: fix-jdoe-001.md\n│\n├── specs\u002F\n│   ├── index.json                 ← Registro global de specs (append-only, sin last_id)\n│   └── spec-[gh-user]-[NNN]-[slug]\u002F    ← Una carpeta por spec\n│       ├── spec-[gh-user]-[NNN]-[slug].spec.md   ← Especificación del módulo\n│       ├── fixes\u002F                 ← Un archivo por fix vinculado a esta spec\n│       │   └── fix-[gh-user]-[spec-NNN]-[seq].md  ← Ej: fix-jdoe-002-001.md\n│       └── cycles\u002F\n│           └── cycle-[XX]\u002F        ← Una subcarpeta por ciclo (zero-padded, reseteados por spec)\n│               ├── brief.yaml     ← Generado por: sdd-orchestrator  (al INICIAR el ciclo)\n│               ├── functional.md  ← Generado por: sdd-functional    (antes de planner\u002Farchitect)\n│               ├── planner.md     ← Generado por: sdd-planner       (en paralelo con architect)\n│               ├── architect.md   ← Generado por: sdd-architect     (en paralelo con planner)\n│               ├── plan.md        ← Solo flow \"lite\": un solo actor, reemplaza brief\u002Ffunctional\u002Fplanner\u002Farchitect\n│               ├── tasks.json     ← Creado por: sdd-planner (o el actor lite) — tasks canónicas del ciclo\n│               └── cycle.json     ← Creado por: sdd-orchestrator    (al INICIAR, status:\"in-progress\", flow)\n│                                     Cerrado por: sdd-reviewer      (al CERRAR, status:\"completed\")\n│\n├── context\u002F\n│   ├── constitution.md            ← Constitución GLOBAL del monorepo (NO modificar manualmente)\n│   ├── context_prompt.md          ← Entry point GLOBAL para todos los agentes\n│   ├── apps\u002F\n│   │   ├── example-api\u002F\n│   │   │   ├── constitution.md    ← Stack, reglas, arquitectura de esta app\n│   │   │   ├── context_prompt.md  ← Entry point para agentes que trabajan esta app\n│   │   │   └── updates\u002F           ← Fragmentos aditivos pendientes de consolidar (patrón changesets)\n│   │   │       └── YYYY-MM-DD-[spec-id]-cycle-[XX].md\n│   │   ├── example-app\u002F\n│   │   │   ├── constitution.md\n│   │   │   ├── context_prompt.md\n│   │   │   └── updates\u002F\n│   │   └── example-api\u002F\n│   │       ├── constitution.md\n│   │       ├── context_prompt.md\n│   │       └── updates\u002F\n│   ├── libs\u002F\n│   │   ├── api-client\u002F\n│   │   │   ├── constitution.md\n│   │   │   ├── context_prompt.md\n│   │   │   └── updates\u002F\n│   │   └── config\u002F\n│   │       ├── constitution.md\n│   │       ├── context_prompt.md\n│   │       └── updates\u002F\n│   └── tools\u002F\n│       └── (una subcarpeta por herramienta cuando se agregue, con su propio updates\u002F)\n│\n├── agents\u002F\n│   ├── sdd-orchestrator.agent.md\n│   ├── sdd-functional.agent.md\n│   ├── sdd-planner.agent.md\n│   ├── sdd-architect.agent.md\n│   ├── sdd-implementor-back.agent.md\n│   ├── sdd-implementor-front.agent.md\n│   └── sdd-reviewer.agent.md\n│\n├── skills\u002F\n│   ├── sdd-file-structure\u002F        ← ⬅ este archivo (lectura obligatoria)\n│   │   └── SKILL.md\n│   ├── sdd-orchestrator\u002F\n│   │   └── SKILL.md\n│   ├── sdd-functional\u002F\n│   │   └── SKILL.md\n│   ├── sdd-planner\u002F\n│   │   └── SKILL.md\n│   ├── sdd-architect\u002F\n│   │   └── SKILL.md\n│   ├── sdd-implementor-back\u002F\n│   │   └── SKILL.md\n│   ├── sdd-implementor-front\u002F\n│   │   └── SKILL.md\n│   ├── sdd-reviewer\u002F\n│   │   └── SKILL.md\n│   ├── generate-springboot-api\u002F\n│   │   └── SKILL.md\n│   ├── generate-react-component\u002F\n│   │   └── SKILL.md\n│   ├── crafted-motion\u002F\n│   │   ├── SKILL.md\n│   │   └── references\u002F\n│   ├── generate-api-contract\u002F\n│   │   └── SKILL.md\n│   ├── generate-nestjs-module\u002F\n│   │   └── SKILL.md\n│   ├── generate-prisma-schema\u002F\n│   │   └── SKILL.md\n│   ├── sdd-data-schemas\u002F\n│   │   └── SKILL.md\n│   └── setup-graphify\u002F\n│       └── SKILL.md\n│\n├── prompts\u002F\n│   ├── check-spec-before-implement.prompt.md\n│   ├── start-sdd-cycle.prompt.md\n│   ├── review-cycle.prompt.md\n│   └── hotfix-bypass-gate.prompt.md\n│\n└── docs\u002F                          ← Visor SDD (JS vanilla, sin build, sin dependencias — reemplaza a apps\u002Fdocs)\n    ├── index.html\n    ├── app.js\n    ├── styles.css\n    ├── serve.mjs                  ← `pnpm sdd:docs` levanta este server y lee los registros en vivo\n    └── fonts\u002F\n```\n\n---\n\n## 2. Convenciones de naming (INVIOLABLES)\n\n### 2.1 Specs\n\n| Elemento         | Convención                                                           | Ejemplo                                           |\n| ---------------- | -------------------------------------------------------------------- | ------------------------------------------------- |\n| Carpeta          | `sdd\u002Fspecs\u002Fspec-[gh-user]-[NNN]-[slug]\u002F`                             | `spec-jdoe-001-enrollment-request\u002F`               |\n| Archivo          | `spec-[gh-user]-[NNN]-[slug].spec.md`                                | `spec-jdoe-001-enrollment-request.spec.md`        |\n| ID (string)      | `spec-[gh-user]-[NNN]-[slug]` — mismo nombre que la carpeta          | `spec-jdoe-001-enrollment-request`                |\n| `[gh-user]`      | Username de GitHub del dev que crea la spec (namespace personal)     | `jdoe`, `asmith`                                  |\n| `[NNN]`          | Contador **personal del dev** (001, 002…) — NO global, no coordinado | `001` para su primera spec, `002` para la segunda |\n| Slug             | kebab-case, descriptivo, máx 5 palabras                              | `enrollment-request`                              |\n| Registro         | SIEMPRE en `sdd\u002Fspecs\u002Findex.json` (append-only) antes de usarla      | —                                                 |\n| Fixes repo-level | `sdd\u002Ffixes\u002Ffix-[gh-user]-[seq].md`                                   | `sdd\u002Ffixes\u002Ffix-jdoe-001.md`                       |\n| Fixes spec-level | `sdd\u002Fspecs\u002F{spec-id}\u002Ffixes\u002Ffix-[gh-user]-[spec-NNN]-[seq].md`        | `fixes\u002Ffix-jdoe-002-001.md`                       |\n\n### 2.2 Ciclos\n\n| Elemento   | Convención                                                                  | Ejemplo                                                                     |\n| ---------- | --------------------------------------------------------------------------- | --------------------------------------------------------------------------- |\n| Subcarpeta | `sdd\u002Fspecs\u002F{spec-id}\u002Fcycles\u002Fcycle-[XX]\u002F` (2 dígitos, zero-padded, por spec) | `spec-jdoe-001-enrollment-request\u002Fcycles\u002Fcycle-01\u002F`                         |\n| Numeración | Reseteada por spec: `cycle-01`, `cycle-02`... Nunca global                  | La spec-001 tiene su cycle-01; la spec-002 también tiene su propio cycle-01 |\n| brief      | `brief.yaml` (siempre lowercase, sin prefijo)                               | `cycles\u002Fcycle-01\u002Fbrief.yaml`                                                |\n| functional | `functional.md`                                                             | `cycles\u002Fcycle-01\u002Ffunctional.md`                                             |\n| planner    | `planner.md`                                                                | `cycles\u002Fcycle-01\u002Fplanner.md`                                                |\n| architect  | `architect.md`                                                              | `sdd\u002Fspecs\u002F{spec-id}\u002Fcycles\u002Fcycle-01\u002Farchitect.md`                          |\n| cycle JSON | `cycle.json`                                                                | `sdd\u002Fspecs\u002F{spec-id}\u002Fcycles\u002Fcycle-01\u002Fcycle.json`                            |\n| plan       | `plan.md` — **solo `flow: \"lite\"`**, reemplaza brief\u002Ffunctional\u002Fplanner\u002Farchitect | `cycles\u002Fcycle-01\u002Fplan.md`                                             |\n\n> ⛔ **PROHIBIDO** usar el formato plano antiguo:\n> ~~`cycle-1-brief.yaml`~~, ~~`cycle-1-functional.md`~~, ~~`cycle-1.json`~~\n> Siempre subcarpeta + nombre de archivo simple.\n\n### 2.3 Contextos de subproyecto\n\n| Elemento                                    | Convención                                                                            |\n| ------------------------------------------- | ------------------------------------------------------------------------------------- |\n| Apps                                        | `sdd\u002Fcontext\u002Fapps\u002F[nombre-de-la-app]\u002Fconstitution.md`                                 |\n| Apps                                        | `sdd\u002Fcontext\u002Fapps\u002F[nombre-de-la-app]\u002Fcontext_prompt.md`                               |\n| Libs                                        | `sdd\u002Fcontext\u002Flibs\u002F[nombre-de-la-lib]\u002Fconstitution.md`                                 |\n| Libs                                        | `sdd\u002Fcontext\u002Flibs\u002F[nombre-de-la-lib]\u002Fcontext_prompt.md`                               |\n| Tools                                       | `sdd\u002Fcontext\u002Ftools\u002F[nombre-del-tool]\u002Fconstitution.md`                                 |\n| Tools                                       | `sdd\u002Fcontext\u002Ftools\u002F[nombre-del-tool]\u002Fcontext_prompt.md`                               |\n| Updates (fragmento aditivo, ciclo)          | `sdd\u002Fcontext\u002F[apps\\|libs\\|tools]\u002F[nombre]\u002Fupdates\u002FYYYY-MM-DD-[spec-id]-cycle-[XX].md` |\n| Updates (fragmento aditivo, fix repo-level) | `sdd\u002Fcontext\u002F[apps\\|libs\\|tools]\u002F[nombre]\u002Fupdates\u002FYYYY-MM-DD-fix-[gh-user]-[seq].md`  |\n\n> ⛔ **Durante un ciclo\u002Ffix NUNCA se editan directamente** `constitution.md` ni\n> `context_prompt.md` del subproyecto: toda actualización de contexto es un fragmento\n> nuevo en `updates\u002F`. El nombre incluye el spec-id (con el gh-user del dev) → único por\n> construcción, sin choques entre devs. Ver plantilla del fragmento en la sección 3.7 y\n> el mecanismo completo de consolidación en la sección 6.\n\n---\n\n## 3. Templates de archivos de ciclo\n\n### 3.1 Template: `brief.yaml`\n\n```yaml\n# sdd\u002Fspecs\u002F{spec-id}\u002Fcycles\u002Fcycle-[XX]\u002Fbrief.yaml\n# Generado por: sdd-orchestrator\n# Al: iniciar el ciclo\n\ncycle: \u003CN> # número entero (ej: 1)\nmodule: \u003Cnombre-modulo> # igual al key en global.json\nphase: \u003Cnombre-fase> # ej: \"domain-models\", \"api-layer\"\ndate: \u003CYYYY-MM-DD>\napp_context: sdd\u002Fcontext\u002Fapps\u002F\u003Capp>\u002Fcontext_prompt.md\n\nobjective: |\n  \u003CUna oración que describe qué se logra al finalizar este ciclo.>\n\nscope:\n  - \u003Ccosa incluida 1>\n  - \u003Ccosa incluida 2>\n\nout_of_scope:\n  - \u003Ccosa excluida 1>\n\ndependencies_required:\n  - \u003Cmódulo o ciclo previo que debe estar completed>\n\nagent_contexts:\n  functional:\n    goal: \u003Cqué debe lograr el agente funcional>\n    business_context: \u003Ccontexto de negocio mínimo para entender el módulo>\n    relevant_spec_sections:\n      - \u003Csección de la spec más relevante>\n\n  planner:\n    goal: \u003Cqué debe lograr el planner>\n    output_file: sdd\u002Fspecs\u002F{spec-id}\u002Fcycles\u002Fcycle-[XX]\u002Fplanner.md\n\n  architect:\n    goal: \u003Cqué debe lograr el arquitecto>\n    existing_tables: [] # tablas relacionadas de sdd\u002Fschema.json\n    existing_endpoints: [] # endpoints relacionados de sdd\u002Fapi.json\n    output_file: sdd\u002Fspecs\u002F{spec-id}\u002Fcycles\u002Fcycle-[XX]\u002Farchitect.md\n\n  implementor_back:\n    goal: \u003Cqué implementa>\n    app: apps\u002F\u003Cnombre-app>\n    app_context: sdd\u002Fcontext\u002Fapps\u002F\u003Capp>\u002Fcontext_prompt.md\n\n  implementor_front:\n    goal: \u003Cqué implementa>\n    app: apps\u002F\u003Cnombre-app>\n    app_context: sdd\u002Fcontext\u002Fapps\u002F\u003Capp>\u002Fcontext_prompt.md\n\n  reviewer:\n    goal: Validar todo el output del ciclo\n    output_file: sdd\u002Fspecs\u002F{spec-id}\u002Fcycles\u002Fcycle-[XX]\u002Fcycle.json\n```\n\n---\n\n### 3.2 Template: `cycle.json` (al INICIAR — sdd-orchestrator)\n\n> ⛔ Debe validar contra `sdd\u002Fschemas\u002Fcycle.schema.json` (`pnpm sdd:validate` tras crearlo).\n\n```json\n{\n  \"$schema\": \"..\u002F..\u002F..\u002F..\u002Fschemas\u002Fcycle.schema.json\",\n  \"cycle\": 1,\n  \"module\": \"\u003Cnombre-del-modulo>\",\n  \"spec\": \"spec-[gh-user]-[NNN]-[slug]\",\n  \"apps\": [\"apps\u002F\u003Cnombre-app>\"],\n  \"phase\": \"\u003Cnombre-de-la-fase>\",\n  \"objectives\": [\"\u003Cobjetivo 1>\", \"\u003Cobjetivo 2>\"],\n  \"status\": \"in-progress\",\n  \"started_at\": \"YYYY-MM-DD\",\n  \"completed_at\": null,\n  \"documents\": {\n    \"brief\": \"sdd\u002Fspecs\u002F{spec-id}\u002Fcycles\u002Fcycle-[XX]\u002Fbrief.yaml\"\n  },\n  \"artifacts\": [],\n  \"metrics\": {\n    \"tasks_total\": 0,\n    \"tasks_completed\": 0,\n    \"story_points\": 0,\n    \"files_created\": [],\n    \"files_modified\": [],\n    \"files_deleted\": [],\n    \"usage\": { \"tokens_in\": 0, \"tokens_out\": 0, \"by_agent\": [] }\n  },\n  \"tables_created\": [],\n  \"endpoints_implemented\": [],\n  \"components_created\": [],\n  \"issues_found\": [],\n  \"reviewer_report\": null\n}\n```\n\n> ⛔ `cycle.json` **DEBE EXISTIR con `status: \"in-progress\"` ANTES de que cualquier\n> agente implementador escriba una línea de código.**\n> Ningún ciclo puede iniciarse sin este archivo.\n>\n> Desde v0.11.0, `metrics` **no nace `null`**: el orquestador lo crea con contadores en 0 y\n> `usage.by_agent: []` — es donde cada agente (functional, planner, architect, cada task, el\n> orquestador y el reviewer) hace push de su entrada al cerrar su unidad de trabajo. Detalle\n> completo en `sdd-data-schemas` §8.1.\n\n---\n\n### 3.3 Template: `cycle.json` (al CERRAR — sdd-reviewer)\n\n> El Reviewer completa `documents` (con todos los que existan, incluido `tasks`), `metrics`,\n> los arrays de trazabilidad y el `reviewer_report`. Nunca inventar campos fuera del schema.\n\n```json\n{\n  \"$schema\": \"..\u002F..\u002F..\u002F..\u002Fschemas\u002Fcycle.schema.json\",\n  \"cycle\": 1,\n  \"module\": \"\u003Cnombre-del-modulo>\",\n  \"spec\": \"spec-[gh-user]-[NNN]-[slug]\",\n  \"apps\": [\"apps\u002F\u003Cnombre-app>\"],\n  \"phase\": \"\u003Cnombre-de-la-fase>\",\n  \"objectives\": [\"\u003Cobjetivo 1>\"],\n  \"status\": \"completed\",\n  \"started_at\": \"YYYY-MM-DD\",\n  \"completed_at\": \"YYYY-MM-DD\",\n  \"documents\": {\n    \"brief\": \"sdd\u002Fspecs\u002F{spec-id}\u002Fcycles\u002Fcycle-[XX]\u002Fbrief.yaml\",\n    \"functional\": \"sdd\u002Fspecs\u002F{spec-id}\u002Fcycles\u002Fcycle-[XX]\u002Ffunctional.md\",\n    \"planner\": \"sdd\u002Fspecs\u002F{spec-id}\u002Fcycles\u002Fcycle-[XX]\u002Fplanner.md\",\n    \"architect\": \"sdd\u002Fspecs\u002F{spec-id}\u002Fcycles\u002Fcycle-[XX]\u002Farchitect.md\",\n    \"tasks\": \"sdd\u002Fspecs\u002F{spec-id}\u002Fcycles\u002Fcycle-[XX]\u002Ftasks.json\"\n  },\n  \"artifacts\": [],\n  \"metrics\": {\n    \"tasks_total\": 0,\n    \"tasks_completed\": 0,\n    \"story_points\": 0,\n    \"files_created\": [],\n    \"files_modified\": [],\n    \"files_deleted\": [],\n    \"usage\": {\n      \"tokens_in\": 0,\n      \"tokens_out\": 0,\n      \"by_agent\": [\"\u003Cuna entrada por task done + documento + orquestador + reviewer>\"],\n      \"by_tier\": \"\u003Cderivado de by_agent, agrupado por provider_model>\"\n    }\n  },\n  \"tables_created\": [],\n  \"endpoints_implemented\": [\"EP-001\"],\n  \"components_created\": [],\n  \"issues_found\": [],\n  \"reviewer_report\": {\n    \"approved\": true,\n    \"date\": \"YYYY-MM-DD\",\n    \"ca_results\": { \"CA-001\": \"PASS — evidencia\" },\n    \"tests\": { \"sdd:validate\": \"OK\", \"suite\": \"N\u002FN PASS\" },\n    \"notes\": \"\u003Cresumen del ciclo>\",\n    \"follow_ups\": []\n  }\n}\n```\n\n---\n\n### 3.3b Template: `tasks.json` per-cycle (sdd-planner)\n\n> ⛔ Debe validar contra `sdd\u002Fschemas\u002Fcycle-tasks.schema.json`. IDs: `TASK-[NNN]` (scope: este archivo).\n\n```json\n{\n  \"$schema\": \"..\u002F..\u002F..\u002F..\u002Fschemas\u002Fcycle-tasks.schema.json\",\n  \"spec\": \"spec-[gh-user]-[NNN]-[slug]\",\n  \"cycle\": 1,\n  \"module\": \"\u003Cnombre-del-modulo>\",\n  \"apps\": [\"apps\u002F\u003Cnombre-app>\"],\n  \"flow\": \"full\",\n  \"user_stories_generated\": true,\n  \"prerequisites\": { \"tasks_generated\": true },\n  \"tasks\": [\n    {\n      \"id\": \"TASK-001\",\n      \"title\": \"\u003Cacción técnica concreta>\",\n      \"user_stories\": [\"HU-01\"],\n      \"estimation_hours\": 2,\n      \"story_points\": 2,\n      \"depends_on\": [],\n      \"status\": \"pending\",\n      \"files\": []\n    }\n  ]\n}\n```\n\n---\n\n### 3.4 Template: `functional.md`\n\n```markdown\n# Functional — Cycle [N]: [Nombre del Módulo]\n\n> **Input:** sdd\u002Fspecs\u002F{spec-id}\u002Fcycles\u002Fcycle-[XX]\u002Fbrief.yaml\n> **Output:** sdd\u002Fspecs\u002F{spec-id}\u002Fcycles\u002Fcycle-[XX]\u002Ffunctional.md\n> **Generado por:** sdd-functional\n\n---\n\n## Contexto de negocio\n\n\u003CDescripción del dominio en lenguaje no técnico>\n\n## Historias de usuario\n\n### US-[N]-001: [Título]\n\n**Como** [actor]\n**Quiero** [acción]\n**Para** [beneficio]\n\n**Criterios de aceptación:**\n\n- [ ] \u003Ccriterio 1>\n- [ ] \u003Ccriterio 2>\n\n### US-[N]-002: [Título]\n\n...\n\n## Reglas de negocio\n\n1. \u003CRegla 1>\n2. \u003CRegla 2>\n\n## Glosario del dominio\n\n| Término | Definición |\n| ------- | ---------- |\n| ...     | ...        |\n```\n\n---\n\n### 3.5 Template: `planner.md`\n\n```markdown\n# Sprint Plan — Cycle [N]: [Nombre del Módulo]\n\n> **Input:** sdd\u002Fspecs\u002F{spec-id}\u002Fcycles\u002Fcycle-[XX]\u002Ffunctional.md\n> **Output:** sdd\u002Fspecs\u002F{spec-id}\u002Fcycles\u002Fcycle-[XX]\u002Fplanner.md\n> **Generado por:** sdd-planner\n\n---\n\n## Resumen del ciclo\n\n| Campo    | Valor       |\n| -------- | ----------- |\n| Ciclo    | [N]         |\n| Módulo   | [nombre]    |\n| Duración | [X] semanas |\n\n## Tasks backend\n\n### TASK-001: [Título]\n\n- **Descripción:** \u003Cqué se implementa>\n- **Archivos a crear\u002Fmodificar:**\n  - `apps\u002F\u003Capp>\u002Fsrc\u002F...\u002F\u003CArchivo según el stack del subproyecto>`\n- **Criterio de done:**\n  - [ ] \u003Ccriterio verificable>\n- **Dependencias:** ninguna | TASK-00X\n\n### TASK-002: [Título]\n\n...\n\n## Tasks frontend\n\n### TASK-00X: [Título]\n\n...\n\n## Orden de ejecución\n```\n\nTASK-001 → TASK-002 → ... (las tasks frontend dependen de las backend cuyo endpoint consumen)\n\n```\n\n> IDs `TASK-[NNN]` — el scope es el `tasks.json` del ciclo; los mismos IDs van en ambos archivos.\n\n```\n\n---\n\n### 3.6 Template: `architect.md`\n\n````markdown\n# Architect — Cycle [N]: [Nombre del Módulo]\n\n> **Input:** sdd\u002Fspecs\u002F{spec-id}\u002Fcycles\u002Fcycle-[XX]\u002Ffunctional.md\n> **Output:** sdd\u002Fspecs\u002F{spec-id}\u002Fcycles\u002Fcycle-[XX]\u002Farchitect.md\n> **Generado por:** sdd-architect\n\n---\n\n## Decisiones técnicas\n\n1. **[Decisión]:** \u003Cdescripción y justificación>\n\n## Cambios en schema (sdd\u002Fschema.json)\n\n> ⚠️ `sdd\u002Fschema.json` está **agrupado por app**. Estructura: `{ \"[app-key]\": { \"tables\": { ... } } }`\n> Siempre trabajar bajo el key del app involucrado (ej: `\"example-api\"`).\n\n### Tabla nueva: `[nombre_tabla]`\n\n| Columna | Tipo   | Constraints |\n| ------- | ------ | ----------- |\n| id      | BIGINT | PK, AUTO    |\n| ...     | ...    | ...         |\n\n## Contratos de API (sdd\u002Fapi.json)\n\n> ⚠️ `sdd\u002Fapi.json` está **agrupado por app**. Estructura: `{ \"[app-key]\": { \"endpoints\": [ ... ] } }`\n> Siempre trabajar bajo el key del app involucrado (ej: `\"example-api\"`, `\"apps\u002Fexample-app\"`).\n> Campos obligatorios en cada entrada: `id`, `status`, `created_in_cycle`, `updated_in_cycle`, `changelog`.\n\n### `POST \u002Fv1\u002F[recurso]`\n\n**Request:**\n\n```json\n{\n  \"campo\": \"tipo\"\n}\n```\n````\n\n**Response 200:**\n\n```json\n{\n  \"campo\": \"tipo\"\n}\n```\n\n**Errores:** 400, 404, 500\n\n## Dependencias externas\n\n- \u003Cservicio o librería que se incorpora>\n\n````\n\n---\n\n### 3.7 Template: fragmento aditivo de contexto (`updates\u002FYYYY-MM-DD-[spec-id]-cycle-[XX].md`)\n\n> Generado por: quien cierra el ciclo o el fix (implementador\u002Freviewer), NUNCA edita\n> `constitution.md`\u002F`context_prompt.md` directamente. Ver mecanismo completo en la\n> sección 6.\n\n```markdown\n# [spec-id] cycle-[XX] — [YYYY-MM-DD]\n\n## Estado\n\u003CQué quedó implementado \u002F en qué estado queda el subproyecto>\n\n## Estructura\n\u003CPaquetes\u002Fmódulos\u002Fpatrones nuevos o cambiados>\n\n## Dependencias\n\u003CLibrerías o servicios nuevos que consume\u002Fexpone>\n\n## Qué sigue\n\u003CPendientes que el próximo ciclo debe saber>\n````\n\n> Secciones vacías se omiten. El fragmento es **corto y solo el delta** — nunca copia\n> del contenido base. Si resuelve algo que el base declaraba pendiente, anotarlo como\n> `resuelve: \u003Csección>` en la sección correspondiente.\n> Fixes repo-level usan el mismo template con nombre de archivo\n> `updates\u002FYYYY-MM-DD-fix-[gh-user]-[seq].md`.\n\n---\n\n### 3.8 Template: `plan.md` (flow `lite` — un solo actor)\n\nReemplaza a `brief.yaml`, `functional.md`, `planner.md` y `architect.md`. Cuatro secciones\nfijas; la cuarta es **obligatoria** si el ciclo toca `schema.json`, `api.json` o\n`components.json` (y esos registros se actualizan igual que en `full`, bajo su app-key).\n\n```markdown\n# [spec-id] — cycle-[XX] · plan (lite)\n\n> Módulo: [nombre] | Subproyectos: [apps\u002F...] | Fecha: [YYYY-MM-DD]\n> Objetivo: [una oración: qué se logra al cerrar el ciclo]. Fuera de alcance: [lista corta].\n\n## Historias\n- US-[N]-001 — Como [rol] quiero [acción] para [beneficio]. CA: [criterio verificable].\n- US-[N]-002 — …\n\n## Tasks (detalle en tasks.json)\n- TASK-001 — [qué se implementa, dónde, qué prueba lo valida]\n- TASK-002 — …\n\n## Decisiones técnicas (obligatoria si toca schema\u002Fapi\u002Fcomponents)\n- [decisión → por qué → registro afectado (schema.json \u002F api.json \u002F components.json)]\n```\n\nReglas: historias en 1–2 líneas cada una (sin narrativa), tasks en prosa espejo de\n`tasks.json` (`user_stories` puede ir `[]` si las historias no se numeran), nada de secciones\nextra — lo que no entra acá va a `artifacts\u002F`. `cycle.json → artifacts[]` lista archivos o\ndirectorios con ruta relativa al ciclo (`artifacts\u002F…`); también vale la ruta desde la raíz del repo.\n\n---\n\n## 4. JSON de estado — propiedades en inglés (OBLIGATORIO)\n\nTodos los archivos `.json` bajo `sdd\u002F` deben tener **todas sus propiedades en inglés**.\n\n| ❌ Incorrecto        | ✅ Correcto       |\n| -------------------- | ----------------- |\n| `fecha_inicio`       | `started_at`      |\n| `fecha_fin`          | `completed_at`    |\n| `estado`             | `status`          |\n| `prioridad`          | `priority`        |\n| `archivos_creados`   | `files_created`   |\n| `módulos_pendientes` | `pending_modules` |\n| `en_progreso`        | `in_progress`     |\n| `completado`         | `completed`       |\n| `resumen`            | `summary`         |\n| `observaciones`      | `observations`    |\n\n---\n\n## 5. Checklist del Orquestador — al iniciar un ciclo\n\nEjecutar en orden estricto. Reportar resultado al usuario antes de continuar. Fuente\ncanónica del gate: `sdd\u002Fdual-harness\u002Frules\u002Fsdd-gates.md`.\n\n```\nSPEC GATE A:\n[ ] 1. pnpm sdd:gate \u003Cspec-id> → APPROVED (pegar la salida: A1–A5)\n\nAPERTURA (flow según profile \u002F prefijo [LITE]|[FULL]):\n[ ] 2. Crear cycle-[XX]\u002Fcycle.json ← status: \"in-progress\", flow, metrics con contadores en 0\n       y usage.by_agent: []\n[ ] 3. Actualizar sdd\u002Fglobal.json ← mover módulo a in_progress_modules\n[ ] 4. Si es cycle-01 y la spec está \"draft\" en sdd\u002Fspecs\u002Findex.json → \"in-progress\"\n[ ] 5. full\u002Freduced: crear brief.yaml (§3.1) · lite: escribir plan.md (§3.8)\n[ ] 6. tasks.json del ciclo (Planner en full; el mismo actor en lite) + pnpm sdd:rebuild-tasks-index\n[ ] 7. pnpm sdd:validate en verde\n\n→ full: invocar sdd-functional. lite: pnpm sdd:gate \u003Cspec-id> cycle-[XX] (GATE B) e implementar.\n```\n\n> ⛔ Si el gate da BLOCKED → DETENER y comunicar qué falta. No continuar.\n\n---\n\n## 6. Responsabilidad por archivo\n\n| Archivo                                                                               | Crea                                      | Cierra \u002F actualiza                                          |\n| ------------------------------------------------------------------------------------- | ----------------------------------------- | ----------------------------------------------------------- |\n| `sdd\u002Fspecs\u002F{spec-id}\u002Fcycles\u002Fcycle-[XX]\u002Fbrief.yaml`                                    | sdd-orchestrator                          | —                                                           |\n| `sdd\u002Fspecs\u002F{spec-id}\u002Fcycles\u002Fcycle-[XX]\u002Ffunctional.md`                                 | sdd-functional                            | —                                                           |\n| `sdd\u002Fspecs\u002F{spec-id}\u002Fcycles\u002Fcycle-[XX]\u002Fplanner.md`                                    | sdd-planner                               | —                                                           |\n| `sdd\u002Fspecs\u002F{spec-id}\u002Fcycles\u002Fcycle-[XX]\u002Farchitect.md`                                  | sdd-architect                             | —                                                           |\n| `sdd\u002Fspecs\u002F{spec-id}\u002Fcycles\u002Fcycle-[XX]\u002Fplan.md` (solo `flow: lite`)                   | el actor único del ciclo                  | —                                                           |\n| `sdd\u002Fspecs\u002F{spec-id}\u002Fcycles\u002Fcycle-[XX]\u002Fcycle.json`                                    | sdd-orchestrator                          | sdd-reviewer (al cerrar)                                    |\n| `sdd\u002Ffixes\u002Ffix-[gh-user]-[seq].md`                                                    | desarrollador (FIX GATE, repo-level)      | sdd-reviewer                                                |\n| `sdd\u002Fspecs\u002F{spec-id}\u002Ffixes\u002Ffix-[...].md`                                              | desarrollador (FIX GATE, spec-level)      | sdd-reviewer                                                |\n| `sdd\u002Fglobal.json`                                                                     | sdd-orchestrator                          | sdd-reviewer                                                |\n| `sdd\u002Fschema.json`                                                                     | sdd-architect                             | sdd-reviewer                                                |\n| `sdd\u002Fapi.json`                                                                        | sdd-architect                             | sdd-reviewer                                                |\n| `sdd\u002Fspecs\u002F{spec-id}\u002Fcycles\u002Fcycle-[XX]\u002Ftasks.json`                                    | sdd-planner                               | sdd-implementor-* + sdd-reviewer                            |\n| `sdd\u002Ftasks.json` (índice)                                                             | generado (`pnpm sdd:rebuild-tasks-index`) | — nunca a mano                                              |\n| `sdd\u002Ffixes.json`                                                                      | sdd-orchestrator (FIX GATE)               | desarrollador + sdd-reviewer                                |\n| `sdd\u002Fspecs\u002Findex.json`                                                                | quien crea la spec                        | —                                                           |\n| `sdd\u002Fcontext\u002F[subproyecto]\u002F` (setup inicial: `constitution.md` + `context_prompt.md`) | (setup inicial)                           | consolidación de un solo actor (nunca durante un ciclo\u002Ffix) |\n| `sdd\u002Fcontext\u002F[apps\\|libs\\|tools]\u002F[nombre]\u002Fupdates\u002F*.md` (fragmento aditivo)           | quien cierra el ciclo o fix               | consolidación lo funde y lo borra                           |\n\n---\n\n## 7. Reglas de frescura del contexto (mecanismo aditivo)\n\n> ⛔ Durante un ciclo o fix, **NUNCA se editan directamente** `constitution.md` ni\n> `context_prompt.md` del subproyecto — incluida su línea `> Última actualización:`.\n> Editarlos en paralelo desde specs distintas es la causa garantizada de merge conflicts\n> que este mecanismo evita.\n\n1. **Escribir (al cerrar ciclo\u002Ffix):** quien cierra crea\n   `sdd\u002Fcontext\u002F[apps|libs|tools]\u002F[nombre]\u002Fupdates\u002FYYYY-MM-DD-[spec-id]-cycle-[XX].md`\n   (o `...fix-[gh-user]-[seq].md` para fixes repo-level) con el template de la\n   sección 3.7. Nunca toca los archivos base.\n2. **Leer:** todo agente que necesite el contexto de un subproyecto lee\n   `constitution.md` + `context_prompt.md` **+ `updates\u002F*.md` en orden de nombre**\n   (el prefijo de fecha los ordena cronológicamente). El contexto vigente = base + deltas.\n3. **Consolidar (operación de un solo actor, nunca en paralelo con un ciclo abierto):**\n   el sdd-orchestrator al iniciar un ciclo nuevo sobre ese subproyecto, o el sdd-reviewer\n   si se acumulan ≥5 fragmentos, funde los fragmentos en `constitution.md`\u002F\n   `context_prompt.md`, actualiza el header, **borra los fragmentos consolidados** y\n   commitea como cambio dedicado (`chore(sdd): consolidate context updates for [nombre]`).\n   El validador acepta este estado: sin fragmento, el CONTEXTO GATE de un ciclo cerrado se da\n   por cumplido cuando el header del `context_prompt.md` base muestra `Fecha:` ≥ `completed_at`.\n\nHeader obligatorio en `constitution.md` y `context_prompt.md` de subproyecto — **solo\nla consolidación lo toca**:\n\n```\n\n> Última actualización: cycle-[N] | Fase: [fase] | Fecha: YYYY-MM-DD\n\n```\n\nEl **sdd-orchestrator** DEBE verificar al iniciar cada ciclo sobre un subproyecto:\n\n- ¿Hay fragmentos pendientes en `updates\u002F`? → consolidarlos antes de generar el brief.\n- ¿El header `cycle-[N]` del subproyecto (post-consolidación) coincide con el último\n  ciclo `completed` en `global.json`?\n- Si NO coincide → alertar al usuario: contexto desactualizado.\n\n---\n\n## 7-bis. Manifest de contenido (`sdd\u002Fcatalog.json`)\n\nManifest **generado** que enumera agents, skills, prompts y schemas para el visor\n(`sdd\u002Fdocs`), que corre en hosting estático sin listado de directorios.\n\n- Regenerar con `pnpm sdd:rebuild-catalog` **cada vez que se agrega o quita** un\n  `*.agent.md`, un directorio de skill, un `*.prompt.md` o un `*.schema.json`.\n- `pnpm sdd:validate` **falla** si el manifest quedó desactualizado respecto del\n  filesystem — la desincronización no puede pasar a CI ni a un cierre de ciclo.\n- Nunca editarlo a mano. Schema: `sdd\u002Fschemas\u002Fcatalog.schema.json`.\n\n## 8. Referencias rápidas\n\n| Necesito...                         | Leer...                                             |\n| ----------------------------------- | --------------------------------------------------- |\n| Estado del proyecto                 | `sdd\u002Fglobal.json`                                   |\n| Iniciar un ciclo                    | `sdd\u002Fprompts\u002Fstart-sdd-cycle.prompt.md`             |\n| **Responder el SPEC GATE (A o B)**  | **`pnpm sdd:gate \u003Cspec-id> [cycle-XX]`** — fuente: `sdd\u002Fdual-harness\u002Frules\u002Fsdd-gates.md` |\n| Verificar antes de implementar      | `sdd\u002Fprompts\u002Fcheck-spec-before-implement.prompt.md` |\n| **Registrar un fix \u002F hotfix**       | **`sdd\u002Fprompts\u002Fhotfix-bypass-gate.prompt.md`**      |\n| **Ver todos los fixes activos**     | **`sdd\u002Ffixes.json`**                                |\n| Stack de una app específica         | `sdd\u002Fcontext\u002Fapps\u002F[app]\u002Fconstitution.md`            |\n| Endpoints ya implementados          | `sdd\u002Fapi.json`                                      |\n| Tablas ya definidas                 | `sdd\u002Fschema.json`                                   |\n| Tasks del ciclo actual              | `sdd\u002Fspecs\u002F{spec-id}\u002Fcycles\u002Fcycle-[XX]\u002Ftasks.json`  |\n| Resumen de tasks de todos los specs | `sdd\u002Ftasks.json` (índice generado)                  |\n| Schemas de los registros JSON       | `sdd\u002Fschemas\u002F*.schema.json`                         |\n| Specs registradas                   | `sdd\u002Fspecs\u002Findex.json`                              |\n| Crear API Spring Boot               | `sdd\u002Fskills\u002Fgenerate-springboot-api\u002FSKILL.md`       |\n| Crear componente React              | `sdd\u002Fskills\u002Fgenerate-react-component\u002FSKILL.md`      |\n| Motion \u002F animaciones \u002F dirección visual | `sdd\u002Fskills\u002Fcrafted-motion\u002FSKILL.md`            |\n| Ver visor SDD en vivo (sin build)   | `pnpm sdd:docs` → `sdd\u002Fdocs\u002F`                       |\n\n---\n\n## 9. Template: fix individual (FIX GATE)\n\n> Con `profile: solo` alcanza el **template mínimo**: título + `## Problema` (2 líneas) +\n> `## Solución aplicada` con `### Archivos modificados`. El resto de las secciones se omite.\n\nCada fix es un archivo independiente. El nombre del archivo es el ID del fix en kebab-case:\n\n- Repo-level: `sdd\u002Ffixes\u002Ffix-[gh-user]-[seq].md`\n- Spec-level: `sdd\u002Fspecs\u002F{spec-id}\u002Ffixes\u002Ffix-[gh-user]-[spec-NNN]-[seq].md`\n\n```markdown\n# FIX-[gh-user]-[seq] — [Título del fix]\n\n| Campo         | Valor                                          |\n| ------------- | ---------------------------------------------- |\n| **ID**        | FIX-[gh-user]-[seq]                            |\n| **Tipo**      | HOTFIX \\| BUGFIX \\| FIX \\| IMPROVEMENT         |\n| **Severidad** | critical \\| high \\| medium \\| low              |\n| **Keyword**   | [HOTFIX] \\| [BUGFIX] \\| [FIX] \\| [IMPROVEMENT] |\n| **Fecha**     | YYYY-MM-DD                                     |\n| **Autor**     | [gh-user]                                      |\n| **Estado**    | pending \\| implemented \\| completed            |\n| **Spec**      | [spec-id] o N\u002FA (repo-level)                   |\n\n## Problema\n\n\u003CDescripción del problema detectado>\n\n## Justificación del bypass\n\n\u003CPor qué no podía esperar un ciclo SDD normal>\n\n## Solución aplicada\n\n\u003CDescripción de la solución implementada>\n\n### Archivos modificados\n\n- `apps\u002F...\u002FArchivo.java` — descripción del cambio\n- `apps\u002F...\u002FArchivo2.java` — descripción del cambio\n\n### Test de validación\n\n- **Referencia:** `apps\u002F...\u002FSomeTest.java#testMethod` (o justificación de ausencia)\n\n### Decisión del Reviewer\n\n> [A completar por sdd-reviewer al cerrar el ciclo]\n>\n> - [ ] `validated` — fix correcto, no requiere seguimiento\n> - [ ] `absorbed` — debe formalizarse en próxima spec: SPEC-XXX\n\n---\n```\n","# Skill: sdd-file-structure\n\n> ⛔ **LECTURA OBLIGATORIA** para el sdd-orchestrator al inicio de cada ciclo.\n> Antes de crear o referenciar cualquier archivo SDD, verificar contra este documento.\n\n> 📌 **Skill complementaria:** `sdd-data-schemas` — cubre los schemas campo-a-campo de cada registro JSON.\n> Este skill cubre **dónde** van los archivos. `sdd-data-schemas` cubre **qué va dentro** de cada archivo.\n\n---\n\n## 1. Árbol completo del directorio `sdd\u002F`\n\n```\nsdd\u002F\n├── global.json                    ← Estado general del proyecto (fuente de verdad — solo specs mergeadas a master)\n├── schema.json                    ← Tablas de BD definidas hasta el momento\n├── schemas\u002F                       ← JSON Schemas estrictos de TODOS los registros (fuente de verdad de máquina; incluye session-binding, file-lease y session-request: ataduras, reservas y buzón locales de sesiones)\n├── api.json                       ← Endpoints implementados hasta el momento\n├── components.json                ← Componentes frontend creados\n├── tasks.json                     ← ÍNDICE de tasks (generado — canónico: cycles\u002Fcycle-XX\u002Ftasks.json)\n├── fixes.json                     ← Índice global de fixes (spec_id: null = repo-level, spec_id: \"spec-...\" = spec-scoped)\n├── fixes\u002F                         ← Un archivo por fix repo-level (no vinculados a ninguna spec)\n│   └── fix-[gh-user]-[seq].md     ← Ej: fix-jdoe-001.md\n│\n├── specs\u002F\n│   ├── index.json                 ← Registro global de specs (append-only, sin last_id)\n│   └── spec-[gh-user]-[NNN]-[slug]\u002F    ← Una carpeta por spec\n│       ├── spec-[gh-user]-[NNN]-[slug].spec.md   ← Especificación del módulo\n│       ├── fixes\u002F                 ← Un archivo por fix vinculado a esta spec\n│       │   └── fix-[gh-user]-[spec-NNN]-[seq].md  ← Ej: fix-jdoe-002-001.md\n│       └── cycles\u002F\n│           └── cycle-[XX]\u002F        ← Una subcarpeta por ciclo (zero-padded, reseteados por spec)\n│               ├── brief.yaml     ← Generado por: sdd-orchestrator  (al INICIAR el ciclo)\n│               ├── functional.md  ← Generado por: sdd-functional    (antes de planner\u002Farchitect)\n│               ├── planner.md     ← Generado por: sdd-planner       (en paralelo con architect)\n│               ├── architect.md   ← Generado por: sdd-architect     (en paralelo con planner)\n│               ├── plan.md        ← Solo flow \"lite\": un solo actor, reemplaza brief\u002Ffunctional\u002Fplanner\u002Farchitect\n│               ├── tasks.json     ← Creado por: sdd-planner (o el actor lite) — tasks canónicas del ciclo\n│               └── cycle.json     ← Creado por: sdd-orchestrator    (al INICIAR, status:\"in-progress\", flow)\n│                                     Cerrado por: sdd-reviewer      (al CERRAR, status:\"completed\")\n│\n├── context\u002F\n│   ├── constitution.md            ← Constitución GLOBAL del monorepo (NO modificar manualmente)\n│   ├── context_prompt.md          ← Entry point GLOBAL para todos los agentes\n│   ├── apps\u002F\n│   │   ├── example-api\u002F\n│   │   │   ├── constitution.md    ← Stack, reglas, arquitectura de esta app\n│   │   │   ├── context_prompt.md  ← Entry point para agentes que trabajan esta app\n│   │   │   └── updates\u002F           ← Fragmentos aditivos pendientes de consolidar (patrón changesets)\n│   │   │       └── YYYY-MM-DD-[spec-id]-cycle-[XX].md\n│   │   ├── example-app\u002F\n│   │   │   ├── constitution.md\n│   │   │   ├── context_prompt.md\n│   │   │   └── updates\u002F\n│   │   └── example-api\u002F\n│   │       ├── constitution.md\n│   │       ├── context_prompt.md\n│   │       └── updates\u002F\n│   ├── libs\u002F\n│   │   ├── api-client\u002F\n│   │   │   ├── constitution.md\n│   │   │   ├── context_prompt.md\n│   │   │   └── updates\u002F\n│   │   └── config\u002F\n│   │       ├── constitution.md\n│   │       ├── context_prompt.md\n│   │       └── updates\u002F\n│   └── tools\u002F\n│       └── (una subcarpeta por herramienta cuando se agregue, con su propio updates\u002F)\n│\n├── agents\u002F\n│   ├── sdd-orchestrator.agent.md\n│   ├── sdd-functional.agent.md\n│   ├── sdd-planner.agent.md\n│   ├── sdd-architect.agent.md\n│   ├── sdd-implementor-back.agent.md\n│   ├── sdd-implementor-front.agent.md\n│   └── sdd-reviewer.agent.md\n│\n├── skills\u002F\n│   ├── sdd-file-structure\u002F        ← ⬅ este archivo (lectura obligatoria)\n│   │   └── SKILL.md\n│   ├── sdd-orchestrator\u002F\n│   │   └── SKILL.md\n│   ├── sdd-functional\u002F\n│   │   └── SKILL.md\n│   ├── sdd-planner\u002F\n│   │   └── SKILL.md\n│   ├── sdd-architect\u002F\n│   │   └── SKILL.md\n│   ├── sdd-implementor-back\u002F\n│   │   └── SKILL.md\n│   ├── sdd-implementor-front\u002F\n│   │   └── SKILL.md\n│   ├── sdd-reviewer\u002F\n│   │   └── SKILL.md\n│   ├── generate-springboot-api\u002F\n│   │   └── SKILL.md\n│   ├── generate-react-component\u002F\n│   │   └── SKILL.md\n│   ├── crafted-motion\u002F\n│   │   ├── SKILL.md\n│   │   └── references\u002F\n│   ├── generate-api-contract\u002F\n│   │   └── SKILL.md\n│   ├── generate-nestjs-module\u002F\n│   │   └── SKILL.md\n│   ├── generate-prisma-schema\u002F\n│   │   └── SKILL.md\n│   ├── sdd-data-schemas\u002F\n│   │   └── SKILL.md\n│   └── setup-graphify\u002F\n│       └── SKILL.md\n│\n├── prompts\u002F\n│   ├── check-spec-before-implement.prompt.md\n│   ├── start-sdd-cycle.prompt.md\n│   ├── review-cycle.prompt.md\n│   └── hotfix-bypass-gate.prompt.md\n│\n└── docs\u002F                          ← Visor SDD (JS vanilla, sin build, sin dependencias — reemplaza a apps\u002Fdocs)\n    ├── index.html\n    ├── app.js\n    ├── styles.css\n    ├── serve.mjs                  ← `pnpm sdd:docs` levanta este server y lee los registros en vivo\n    └── fonts\u002F\n```\n\n---\n\n## 2. Convenciones de naming (INVIOLABLES)\n\n### 2.1 Specs\n\n| Elemento         | Convención                                                           | Ejemplo                                           |\n| ---------------- | -------------------------------------------------------------------- | ------------------------------------------------- |\n| Carpeta          | `sdd\u002Fspecs\u002Fspec-[gh-user]-[NNN]-[slug]\u002F`                             | `spec-jdoe-001-enrollment-request\u002F`               |\n| Archivo          | `spec-[gh-user]-[NNN]-[slug].spec.md`                                | `spec-jdoe-001-enrollment-request.spec.md`        |\n| ID (string)      | `spec-[gh-user]-[NNN]-[slug]` — mismo nombre que la carpeta          | `spec-jdoe-001-enrollment-request`                |\n| `[gh-user]`      | Username de GitHub del dev que crea la spec (namespace personal)     | `jdoe`, `asmith`                                  |\n| `[NNN]`          | Contador **personal del dev** (001, 002…) — NO global, no coordinado | `001` para su primera spec, `002` para la segunda |\n| Slug             | kebab-case, descriptivo, máx 5 palabras                              | `enrollment-request`                              |\n| Registro         | SIEMPRE en `sdd\u002Fspecs\u002Findex.json` (append-only) antes de usarla      | —                                                 |\n| Fixes repo-level | `sdd\u002Ffixes\u002Ffix-[gh-user]-[seq].md`                                   | `sdd\u002Ffixes\u002Ffix-jdoe-001.md`                       |\n| Fixes spec-level | `sdd\u002Fspecs\u002F{spec-id}\u002Ffixes\u002Ffix-[gh-user]-[spec-NNN]-[seq].md`        | `fixes\u002Ffix-jdoe-002-001.md`                       |\n\n### 2.2 Ciclos\n\n| Elemento   | Convención                                                                  | Ejemplo                                                                     |\n| ---------- | --------------------------------------------------------------------------- | --------------------------------------------------------------------------- |\n| Subcarpeta | `sdd\u002Fspecs\u002F{spec-id}\u002Fcycles\u002Fcycle-[XX]\u002F` (2 dígitos, zero-padded, por spec) | `spec-jdoe-001-enrollment-request\u002Fcycles\u002Fcycle-01\u002F`                         |\n| Numeración | Reseteada por spec: `cycle-01`, `cycle-02`... Nunca global                  | La spec-001 tiene su cycle-01; la spec-002 también tiene su propio cycle-01 |\n| brief      | `brief.yaml` (siempre lowercase, sin prefijo)                               | `cycles\u002Fcycle-01\u002Fbrief.yaml`                                                |\n| functional | `functional.md`                                                             | `cycles\u002Fcycle-01\u002Ffunctional.md`                                             |\n| planner    | `planner.md`                                                                | `cycles\u002Fcycle-01\u002Fplanner.md`                                                |\n| architect  | `architect.md`                                                              | `sdd\u002Fspecs\u002F{spec-id}\u002Fcycles\u002Fcycle-01\u002Farchitect.md`                          |\n| cycle JSON | `cycle.json`                                                                | `sdd\u002Fspecs\u002F{spec-id}\u002Fcycles\u002Fcycle-01\u002Fcycle.json`                            |\n| plan       | `plan.md` — **solo `flow: \"lite\"`**, reemplaza brief\u002Ffunctional\u002Fplanner\u002Farchitect | `cycles\u002Fcycle-01\u002Fplan.md`                                             |\n\n> ⛔ **PROHIBIDO** usar el formato plano antiguo:\n> ~~`cycle-1-brief.yaml`~~, ~~`cycle-1-functional.md`~~, ~~`cycle-1.json`~~\n> Siempre subcarpeta + nombre de archivo simple.\n\n### 2.3 Contextos de subproyecto\n\n| Elemento                                    | Convención                                                                            |\n| ------------------------------------------- | ------------------------------------------------------------------------------------- |\n| Apps                                        | `sdd\u002Fcontext\u002Fapps\u002F[nombre-de-la-app]\u002Fconstitution.md`                                 |\n| Apps                                        | `sdd\u002Fcontext\u002Fapps\u002F[nombre-de-la-app]\u002Fcontext_prompt.md`                               |\n| Libs                                        | `sdd\u002Fcontext\u002Flibs\u002F[nombre-de-la-lib]\u002Fconstitution.md`                                 |\n| Libs                                        | `sdd\u002Fcontext\u002Flibs\u002F[nombre-de-la-lib]\u002Fcontext_prompt.md`                               |\n| Tools                                       | `sdd\u002Fcontext\u002Ftools\u002F[nombre-del-tool]\u002Fconstitution.md`                                 |\n| Tools                                       | `sdd\u002Fcontext\u002Ftools\u002F[nombre-del-tool]\u002Fcontext_prompt.md`                               |\n| Updates (fragmento aditivo, ciclo)          | `sdd\u002Fcontext\u002F[apps\\|libs\\|tools]\u002F[nombre]\u002Fupdates\u002FYYYY-MM-DD-[spec-id]-cycle-[XX].md` |\n| Updates (fragmento aditivo, fix repo-level) | `sdd\u002Fcontext\u002F[apps\\|libs\\|tools]\u002F[nombre]\u002Fupdates\u002FYYYY-MM-DD-fix-[gh-user]-[seq].md`  |\n\n> ⛔ **Durante un ciclo\u002Ffix NUNCA se editan directamente** `constitution.md` ni\n> `context_prompt.md` del subproyecto: toda actualización de contexto es un fragmento\n> nuevo en `updates\u002F`. El nombre incluye el spec-id (con el gh-user del dev) → único por\n> construcción, sin choques entre devs. Ver plantilla del fragmento en la sección 3.7 y\n> el mecanismo completo de consolidación en la sección 6.\n\n---\n\n## 3. Templates de archivos de ciclo\n\n### 3.1 Template: `brief.yaml`\n\n```yaml\n# sdd\u002Fspecs\u002F{spec-id}\u002Fcycles\u002Fcycle-[XX]\u002Fbrief.yaml\n# Generado por: sdd-orchestrator\n# Al: iniciar el ciclo\n\ncycle: \u003CN> # número entero (ej: 1)\nmodule: \u003Cnombre-modulo> # igual al key en global.json\nphase: \u003Cnombre-fase> # ej: \"domain-models\", \"api-layer\"\ndate: \u003CYYYY-MM-DD>\napp_context: sdd\u002Fcontext\u002Fapps\u002F\u003Capp>\u002Fcontext_prompt.md\n\nobjective: |\n  \u003CUna oración que describe qué se logra al finalizar este ciclo.>\n\nscope:\n  - \u003Ccosa incluida 1>\n  - \u003Ccosa incluida 2>\n\nout_of_scope:\n  - \u003Ccosa excluida 1>\n\ndependencies_required:\n  - \u003Cmódulo o ciclo previo que debe estar completed>\n\nagent_contexts:\n  functional:\n    goal: \u003Cqué debe lograr el agente funcional>\n    business_context: \u003Ccontexto de negocio mínimo para entender el módulo>\n    relevant_spec_sections:\n      - \u003Csección de la spec más relevante>\n\n  planner:\n    goal: \u003Cqué debe lograr el planner>\n    output_file: sdd\u002Fspecs\u002F{spec-id}\u002Fcycles\u002Fcycle-[XX]\u002Fplanner.md\n\n  architect:\n    goal: \u003Cqué debe lograr el arquitecto>\n    existing_tables: [] # tablas relacionadas de sdd\u002Fschema.json\n    existing_endpoints: [] # endpoints relacionados de sdd\u002Fapi.json\n    output_file: sdd\u002Fspecs\u002F{spec-id}\u002Fcycles\u002Fcycle-[XX]\u002Farchitect.md\n\n  implementor_back:\n    goal: \u003Cqué implementa>\n    app: apps\u002F\u003Cnombre-app>\n    app_context: sdd\u002Fcontext\u002Fapps\u002F\u003Capp>\u002Fcontext_prompt.md\n\n  implementor_front:\n    goal: \u003Cqué implementa>\n    app: apps\u002F\u003Cnombre-app>\n    app_context: sdd\u002Fcontext\u002Fapps\u002F\u003Capp>\u002Fcontext_prompt.md\n\n  reviewer:\n    goal: Validar todo el output del ciclo\n    output_file: sdd\u002Fspecs\u002F{spec-id}\u002Fcycles\u002Fcycle-[XX]\u002Fcycle.json\n```\n\n---\n\n### 3.2 Template: `cycle.json` (al INICIAR — sdd-orchestrator)\n\n> ⛔ Debe validar contra `sdd\u002Fschemas\u002Fcycle.schema.json` (`pnpm sdd:validate` tras crearlo).\n\n```json\n{\n  \"$schema\": \"..\u002F..\u002F..\u002F..\u002Fschemas\u002Fcycle.schema.json\",\n  \"cycle\": 1,\n  \"module\": \"\u003Cnombre-del-modulo>\",\n  \"spec\": \"spec-[gh-user]-[NNN]-[slug]\",\n  \"apps\": [\"apps\u002F\u003Cnombre-app>\"],\n  \"phase\": \"\u003Cnombre-de-la-fase>\",\n  \"objectives\": [\"\u003Cobjetivo 1>\", \"\u003Cobjetivo 2>\"],\n  \"status\": \"in-progress\",\n  \"started_at\": \"YYYY-MM-DD\",\n  \"completed_at\": null,\n  \"documents\": {\n    \"brief\": \"sdd\u002Fspecs\u002F{spec-id}\u002Fcycles\u002Fcycle-[XX]\u002Fbrief.yaml\"\n  },\n  \"artifacts\": [],\n  \"metrics\": {\n    \"tasks_total\": 0,\n    \"tasks_completed\": 0,\n    \"story_points\": 0,\n    \"files_created\": [],\n    \"files_modified\": [],\n    \"files_deleted\": [],\n    \"usage\": { \"tokens_in\": 0, \"tokens_out\": 0, \"by_agent\": [] }\n  },\n  \"tables_created\": [],\n  \"endpoints_implemented\": [],\n  \"components_created\": [],\n  \"issues_found\": [],\n  \"reviewer_report\": null\n}\n```\n\n> ⛔ `cycle.json` **DEBE EXISTIR con `status: \"in-progress\"` ANTES de que cualquier\n> agente implementador escriba una línea de código.**\n> Ningún ciclo puede iniciarse sin este archivo.\n>\n> Desde v0.11.0, `metrics` **no nace `null`**: el orquestador lo crea con contadores en 0 y\n> `usage.by_agent: []` — es donde cada agente (functional, planner, architect, cada task, el\n> orquestador y el reviewer) hace push de su entrada al cerrar su unidad de trabajo. Detalle\n> completo en `sdd-data-schemas` §8.1.\n\n---\n\n### 3.3 Template: `cycle.json` (al CERRAR — sdd-reviewer)\n\n> El Reviewer completa `documents` (con todos los que existan, incluido `tasks`), `metrics`,\n> los arrays de trazabilidad y el `reviewer_report`. Nunca inventar campos fuera del schema.\n\n```json\n{\n  \"$schema\": \"..\u002F..\u002F..\u002F..\u002Fschemas\u002Fcycle.schema.json\",\n  \"cycle\": 1,\n  \"module\": \"\u003Cnombre-del-modulo>\",\n  \"spec\": \"spec-[gh-user]-[NNN]-[slug]\",\n  \"apps\": [\"apps\u002F\u003Cnombre-app>\"],\n  \"phase\": \"\u003Cnombre-de-la-fase>\",\n  \"objectives\": [\"\u003Cobjetivo 1>\"],\n  \"status\": \"completed\",\n  \"started_at\": \"YYYY-MM-DD\",\n  \"completed_at\": \"YYYY-MM-DD\",\n  \"documents\": {\n    \"brief\": \"sdd\u002Fspecs\u002F{spec-id}\u002Fcycles\u002Fcycle-[XX]\u002Fbrief.yaml\",\n    \"functional\": \"sdd\u002Fspecs\u002F{spec-id}\u002Fcycles\u002Fcycle-[XX]\u002Ffunctional.md\",\n    \"planner\": \"sdd\u002Fspecs\u002F{spec-id}\u002Fcycles\u002Fcycle-[XX]\u002Fplanner.md\",\n    \"architect\": \"sdd\u002Fspecs\u002F{spec-id}\u002Fcycles\u002Fcycle-[XX]\u002Farchitect.md\",\n    \"tasks\": \"sdd\u002Fspecs\u002F{spec-id}\u002Fcycles\u002Fcycle-[XX]\u002Ftasks.json\"\n  },\n  \"artifacts\": [],\n  \"metrics\": {\n    \"tasks_total\": 0,\n    \"tasks_completed\": 0,\n    \"story_points\": 0,\n    \"files_created\": [],\n    \"files_modified\": [],\n    \"files_deleted\": [],\n    \"usage\": {\n      \"tokens_in\": 0,\n      \"tokens_out\": 0,\n      \"by_agent\": [\"\u003Cuna entrada por task done + documento + orquestador + reviewer>\"],\n      \"by_tier\": \"\u003Cderivado de by_agent, agrupado por provider_model>\"\n    }\n  },\n  \"tables_created\": [],\n  \"endpoints_implemented\": [\"EP-001\"],\n  \"components_created\": [],\n  \"issues_found\": [],\n  \"reviewer_report\": {\n    \"approved\": true,\n    \"date\": \"YYYY-MM-DD\",\n    \"ca_results\": { \"CA-001\": \"PASS — evidencia\" },\n    \"tests\": { \"sdd:validate\": \"OK\", \"suite\": \"N\u002FN PASS\" },\n    \"notes\": \"\u003Cresumen del ciclo>\",\n    \"follow_ups\": []\n  }\n}\n```\n\n---\n\n### 3.3b Template: `tasks.json` per-cycle (sdd-planner)\n\n> ⛔ Debe validar contra `sdd\u002Fschemas\u002Fcycle-tasks.schema.json`. IDs: `TASK-[NNN]` (scope: este archivo).\n\n```json\n{\n  \"$schema\": \"..\u002F..\u002F..\u002F..\u002Fschemas\u002Fcycle-tasks.schema.json\",\n  \"spec\": \"spec-[gh-user]-[NNN]-[slug]\",\n  \"cycle\": 1,\n  \"module\": \"\u003Cnombre-del-modulo>\",\n  \"apps\": [\"apps\u002F\u003Cnombre-app>\"],\n  \"flow\": \"full\",\n  \"user_stories_generated\": true,\n  \"prerequisites\": { \"tasks_generated\": true },\n  \"tasks\": [\n    {\n      \"id\": \"TASK-001\",\n      \"title\": \"\u003Cacción técnica concreta>\",\n      \"user_stories\": [\"HU-01\"],\n      \"estimation_hours\": 2,\n      \"story_points\": 2,\n      \"depends_on\": [],\n      \"status\": \"pending\",\n      \"files\": []\n    }\n  ]\n}\n```\n\n---\n\n### 3.4 Template: `functional.md`\n\n```markdown\n# Functional — Cycle [N]: [Nombre del Módulo]\n\n> **Input:** sdd\u002Fspecs\u002F{spec-id}\u002Fcycles\u002Fcycle-[XX]\u002Fbrief.yaml\n> **Output:** sdd\u002Fspecs\u002F{spec-id}\u002Fcycles\u002Fcycle-[XX]\u002Ffunctional.md\n> **Generado por:** sdd-functional\n\n---\n\n## Contexto de negocio\n\n\u003CDescripción del dominio en lenguaje no técnico>\n\n## Historias de usuario\n\n### US-[N]-001: [Título]\n\n**Como** [actor]\n**Quiero** [acción]\n**Para** [beneficio]\n\n**Criterios de aceptación:**\n\n- [ ] \u003Ccriterio 1>\n- [ ] \u003Ccriterio 2>\n\n### US-[N]-002: [Título]\n\n...\n\n## Reglas de negocio\n\n1. \u003CRegla 1>\n2. \u003CRegla 2>\n\n## Glosario del dominio\n\n| Término | Definición |\n| ------- | ---------- |\n| ...     | ...        |\n```\n\n---\n\n### 3.5 Template: `planner.md`\n\n```markdown\n# Sprint Plan — Cycle [N]: [Nombre del Módulo]\n\n> **Input:** sdd\u002Fspecs\u002F{spec-id}\u002Fcycles\u002Fcycle-[XX]\u002Ffunctional.md\n> **Output:** sdd\u002Fspecs\u002F{spec-id}\u002Fcycles\u002Fcycle-[XX]\u002Fplanner.md\n> **Generado por:** sdd-planner\n\n---\n\n## Resumen del ciclo\n\n| Campo    | Valor       |\n| -------- | ----------- |\n| Ciclo    | [N]         |\n| Módulo   | [nombre]    |\n| Duración | [X] semanas |\n\n## Tasks backend\n\n### TASK-001: [Título]\n\n- **Descripción:** \u003Cqué se implementa>\n- **Archivos a crear\u002Fmodificar:**\n  - `apps\u002F\u003Capp>\u002Fsrc\u002F...\u002F\u003CArchivo según el stack del subproyecto>`\n- **Criterio de done:**\n  - [ ] \u003Ccriterio verificable>\n- **Dependencias:** ninguna | TASK-00X\n\n### TASK-002: [Título]\n\n...\n\n## Tasks frontend\n\n### TASK-00X: [Título]\n\n...\n\n## Orden de ejecución\n```\n\nTASK-001 → TASK-002 → ... (las tasks frontend dependen de las backend cuyo endpoint consumen)\n\n```\n\n> IDs `TASK-[NNN]` — el scope es el `tasks.json` del ciclo; los mismos IDs van en ambos archivos.\n\n```\n\n---\n\n### 3.6 Template: `architect.md`\n\n````markdown\n# Architect — Cycle [N]: [Nombre del Módulo]\n\n> **Input:** sdd\u002Fspecs\u002F{spec-id}\u002Fcycles\u002Fcycle-[XX]\u002Ffunctional.md\n> **Output:** sdd\u002Fspecs\u002F{spec-id}\u002Fcycles\u002Fcycle-[XX]\u002Farchitect.md\n> **Generado por:** sdd-architect\n\n---\n\n## Decisiones técnicas\n\n1. **[Decisión]:** \u003Cdescripción y justificación>\n\n## Cambios en schema (sdd\u002Fschema.json)\n\n> ⚠️ `sdd\u002Fschema.json` está **agrupado por app**. Estructura: `{ \"[app-key]\": { \"tables\": { ... } } }`\n> Siempre trabajar bajo el key del app involucrado (ej: `\"example-api\"`).\n\n### Tabla nueva: `[nombre_tabla]`\n\n| Columna | Tipo   | Constraints |\n| ------- | ------ | ----------- |\n| id      | BIGINT | PK, AUTO    |\n| ...     | ...    | ...         |\n\n## Contratos de API (sdd\u002Fapi.json)\n\n> ⚠️ `sdd\u002Fapi.json` está **agrupado por app**. Estructura: `{ \"[app-key]\": { \"endpoints\": [ ... ] } }`\n> Siempre trabajar bajo el key del app involucrado (ej: `\"example-api\"`, `\"apps\u002Fexample-app\"`).\n> Campos obligatorios en cada entrada: `id`, `status`, `created_in_cycle`, `updated_in_cycle`, `changelog`.\n\n### `POST \u002Fv1\u002F[recurso]`\n\n**Request:**\n\n```json\n{\n  \"campo\": \"tipo\"\n}\n```\n````\n\n**Response 200:**\n\n```json\n{\n  \"campo\": \"tipo\"\n}\n```\n\n**Errores:** 400, 404, 500\n\n## Dependencias externas\n\n- \u003Cservicio o librería que se incorpora>\n\n````\n\n---\n\n### 3.7 Template: fragmento aditivo de contexto (`updates\u002FYYYY-MM-DD-[spec-id]-cycle-[XX].md`)\n\n> Generado por: quien cierra el ciclo o el fix (implementador\u002Freviewer), NUNCA edita\n> `constitution.md`\u002F`context_prompt.md` directamente. Ver mecanismo completo en la\n> sección 6.\n\n```markdown\n# [spec-id] cycle-[XX] — [YYYY-MM-DD]\n\n## Estado\n\u003CQué quedó implementado \u002F en qué estado queda el subproyecto>\n\n## Estructura\n\u003CPaquetes\u002Fmódulos\u002Fpatrones nuevos o cambiados>\n\n## Dependencias\n\u003CLibrerías o servicios nuevos que consume\u002Fexpone>\n\n## Qué sigue\n\u003CPendientes que el próximo ciclo debe saber>\n````\n\n> Secciones vacías se omiten. El fragmento es **corto y solo el delta** — nunca copia\n> del contenido base. Si resuelve algo que el base declaraba pendiente, anotarlo como\n> `resuelve: \u003Csección>` en la sección correspondiente.\n> Fixes repo-level usan el mismo template con nombre de archivo\n> `updates\u002FYYYY-MM-DD-fix-[gh-user]-[seq].md`.\n\n---\n\n### 3.8 Template: `plan.md` (flow `lite` — un solo actor)\n\nReemplaza a `brief.yaml`, `functional.md`, `planner.md` y `architect.md`. Cuatro secciones\nfijas; la cuarta es **obligatoria** si el ciclo toca `schema.json`, `api.json` o\n`components.json` (y esos registros se actualizan igual que en `full`, bajo su app-key).\n\n```markdown\n# [spec-id] — cycle-[XX] · plan (lite)\n\n> Módulo: [nombre] | Subproyectos: [apps\u002F...] | Fecha: [YYYY-MM-DD]\n> Objetivo: [una oración: qué se logra al cerrar el ciclo]. Fuera de alcance: [lista corta].\n\n## Historias\n- US-[N]-001 — Como [rol] quiero [acción] para [beneficio]. CA: [criterio verificable].\n- US-[N]-002 — …\n\n## Tasks (detalle en tasks.json)\n- TASK-001 — [qué se implementa, dónde, qué prueba lo valida]\n- TASK-002 — …\n\n## Decisiones técnicas (obligatoria si toca schema\u002Fapi\u002Fcomponents)\n- [decisión → por qué → registro afectado (schema.json \u002F api.json \u002F components.json)]\n```\n\nReglas: historias en 1–2 líneas cada una (sin narrativa), tasks en prosa espejo de\n`tasks.json` (`user_stories` puede ir `[]` si las historias no se numeran), nada de secciones\nextra — lo que no entra acá va a `artifacts\u002F`. `cycle.json → artifacts[]` lista archivos o\ndirectorios con ruta relativa al ciclo (`artifacts\u002F…`); también vale la ruta desde la raíz del repo.\n\n---\n\n## 4. JSON de estado — propiedades en inglés (OBLIGATORIO)\n\nTodos los archivos `.json` bajo `sdd\u002F` deben tener **todas sus propiedades en inglés**.\n\n| ❌ Incorrecto        | ✅ Correcto       |\n| -------------------- | ----------------- |\n| `fecha_inicio`       | `started_at`      |\n| `fecha_fin`          | `completed_at`    |\n| `estado`             | `status`          |\n| `prioridad`          | `priority`        |\n| `archivos_creados`   | `files_created`   |\n| `módulos_pendientes` | `pending_modules` |\n| `en_progreso`        | `in_progress`     |\n| `completado`         | `completed`       |\n| `resumen`            | `summary`         |\n| `observaciones`      | `observations`    |\n\n---\n\n## 5. Checklist del Orquestador — al iniciar un ciclo\n\nEjecutar en orden estricto. Reportar resultado al usuario antes de continuar. Fuente\ncanónica del gate: `sdd\u002Fdual-harness\u002Frules\u002Fsdd-gates.md`.\n\n```\nSPEC GATE A:\n[ ] 1. pnpm sdd:gate \u003Cspec-id> → APPROVED (pegar la salida: A1–A5)\n\nAPERTURA (flow según profile \u002F prefijo [LITE]|[FULL]):\n[ ] 2. Crear cycle-[XX]\u002Fcycle.json ← status: \"in-progress\", flow, metrics con contadores en 0\n       y usage.by_agent: []\n[ ] 3. Actualizar sdd\u002Fglobal.json ← mover módulo a in_progress_modules\n[ ] 4. Si es cycle-01 y la spec está \"draft\" en sdd\u002Fspecs\u002Findex.json → \"in-progress\"\n[ ] 5. full\u002Freduced: crear brief.yaml (§3.1) · lite: escribir plan.md (§3.8)\n[ ] 6. tasks.json del ciclo (Planner en full; el mismo actor en lite) + pnpm sdd:rebuild-tasks-index\n[ ] 7. pnpm sdd:validate en verde\n\n→ full: invocar sdd-functional. lite: pnpm sdd:gate \u003Cspec-id> cycle-[XX] (GATE B) e implementar.\n```\n\n> ⛔ Si el gate da BLOCKED → DETENER y comunicar qué falta. No continuar.\n\n---\n\n## 6. Responsabilidad por archivo\n\n| Archivo                                                                               | Crea                                      | Cierra \u002F actualiza                                          |\n| ------------------------------------------------------------------------------------- | ----------------------------------------- | ----------------------------------------------------------- |\n| `sdd\u002Fspecs\u002F{spec-id}\u002Fcycles\u002Fcycle-[XX]\u002Fbrief.yaml`                                    | sdd-orchestrator                          | —                                                           |\n| `sdd\u002Fspecs\u002F{spec-id}\u002Fcycles\u002Fcycle-[XX]\u002Ffunctional.md`                                 | sdd-functional                            | —                                                           |\n| `sdd\u002Fspecs\u002F{spec-id}\u002Fcycles\u002Fcycle-[XX]\u002Fplanner.md`                                    | sdd-planner                               | —                                                           |\n| `sdd\u002Fspecs\u002F{spec-id}\u002Fcycles\u002Fcycle-[XX]\u002Farchitect.md`                                  | sdd-architect                             | —                                                           |\n| `sdd\u002Fspecs\u002F{spec-id}\u002Fcycles\u002Fcycle-[XX]\u002Fplan.md` (solo `flow: lite`)                   | el actor único del ciclo                  | —                                                           |\n| `sdd\u002Fspecs\u002F{spec-id}\u002Fcycles\u002Fcycle-[XX]\u002Fcycle.json`                                    | sdd-orchestrator                          | sdd-reviewer (al cerrar)                                    |\n| `sdd\u002Ffixes\u002Ffix-[gh-user]-[seq].md`                                                    | desarrollador (FIX GATE, repo-level)      | sdd-reviewer                                                |\n| `sdd\u002Fspecs\u002F{spec-id}\u002Ffixes\u002Ffix-[...].md`                                              | desarrollador (FIX GATE, spec-level)      | sdd-reviewer                                                |\n| `sdd\u002Fglobal.json`                                                                     | sdd-orchestrator                          | sdd-reviewer                                                |\n| `sdd\u002Fschema.json`                                                                     | sdd-architect                             | sdd-reviewer                                                |\n| `sdd\u002Fapi.json`                                                                        | sdd-architect                             | sdd-reviewer                                                |\n| `sdd\u002Fspecs\u002F{spec-id}\u002Fcycles\u002Fcycle-[XX]\u002Ftasks.json`                                    | sdd-planner                               | sdd-implementor-* + sdd-reviewer                            |\n| `sdd\u002Ftasks.json` (índice)                                                             | generado (`pnpm sdd:rebuild-tasks-index`) | — nunca a mano                                              |\n| `sdd\u002Ffixes.json`                                                                      | sdd-orchestrator (FIX GATE)               | desarrollador + sdd-reviewer                                |\n| `sdd\u002Fspecs\u002Findex.json`                                                                | quien crea la spec                        | —                                                           |\n| `sdd\u002Fcontext\u002F[subproyecto]\u002F` (setup inicial: `constitution.md` + `context_prompt.md`) | (setup inicial)                           | consolidación de un solo actor (nunca durante un ciclo\u002Ffix) |\n| `sdd\u002Fcontext\u002F[apps\\|libs\\|tools]\u002F[nombre]\u002Fupdates\u002F*.md` (fragmento aditivo)           | quien cierra el ciclo o fix               | consolidación lo funde y lo borra                           |\n\n---\n\n## 7. Reglas de frescura del contexto (mecanismo aditivo)\n\n> ⛔ Durante un ciclo o fix, **NUNCA se editan directamente** `constitution.md` ni\n> `context_prompt.md` del subproyecto — incluida su línea `> Última actualización:`.\n> Editarlos en paralelo desde specs distintas es la causa garantizada de merge conflicts\n> que este mecanismo evita.\n\n1. **Escribir (al cerrar ciclo\u002Ffix):** quien cierra crea\n   `sdd\u002Fcontext\u002F[apps|libs|tools]\u002F[nombre]\u002Fupdates\u002FYYYY-MM-DD-[spec-id]-cycle-[XX].md`\n   (o `...fix-[gh-user]-[seq].md` para fixes repo-level) con el template de la\n   sección 3.7. Nunca toca los archivos base.\n2. **Leer:** todo agente que necesite el contexto de un subproyecto lee\n   `constitution.md` + `context_prompt.md` **+ `updates\u002F*.md` en orden de nombre**\n   (el prefijo de fecha los ordena cronológicamente). El contexto vigente = base + deltas.\n3. **Consolidar (operación de un solo actor, nunca en paralelo con un ciclo abierto):**\n   el sdd-orchestrator al iniciar un ciclo nuevo sobre ese subproyecto, o el sdd-reviewer\n   si se acumulan ≥5 fragmentos, funde los fragmentos en `constitution.md`\u002F\n   `context_prompt.md`, actualiza el header, **borra los fragmentos consolidados** y\n   commitea como cambio dedicado (`chore(sdd): consolidate context updates for [nombre]`).\n   El validador acepta este estado: sin fragmento, el CONTEXTO GATE de un ciclo cerrado se da\n   por cumplido cuando el header del `context_prompt.md` base muestra `Fecha:` ≥ `completed_at`.\n\nHeader obligatorio en `constitution.md` y `context_prompt.md` de subproyecto — **solo\nla consolidación lo toca**:\n\n```\n\n> Última actualización: cycle-[N] | Fase: [fase] | Fecha: YYYY-MM-DD\n\n```\n\nEl **sdd-orchestrator** DEBE verificar al iniciar cada ciclo sobre un subproyecto:\n\n- ¿Hay fragmentos pendientes en `updates\u002F`? → consolidarlos antes de generar el brief.\n- ¿El header `cycle-[N]` del subproyecto (post-consolidación) coincide con el último\n  ciclo `completed` en `global.json`?\n- Si NO coincide → alertar al usuario: contexto desactualizado.\n\n---\n\n## 7-bis. Manifest de contenido (`sdd\u002Fcatalog.json`)\n\nManifest **generado** que enumera agents, skills, prompts y schemas para el visor\n(`sdd\u002Fdocs`), que corre en hosting estático sin listado de directorios.\n\n- Regenerar con `pnpm sdd:rebuild-catalog` **cada vez que se agrega o quita** un\n  `*.agent.md`, un directorio de skill, un `*.prompt.md` o un `*.schema.json`.\n- `pnpm sdd:validate` **falla** si el manifest quedó desactualizado respecto del\n  filesystem — la desincronización no puede pasar a CI ni a un cierre de ciclo.\n- Nunca editarlo a mano. Schema: `sdd\u002Fschemas\u002Fcatalog.schema.json`.\n\n## 8. Referencias rápidas\n\n| Necesito...                         | Leer...                                             |\n| ----------------------------------- | --------------------------------------------------- |\n| Estado del proyecto                 | `sdd\u002Fglobal.json`                                   |\n| Iniciar un ciclo                    | `sdd\u002Fprompts\u002Fstart-sdd-cycle.prompt.md`             |\n| **Responder el SPEC GATE (A o B)**  | **`pnpm sdd:gate \u003Cspec-id> [cycle-XX]`** — fuente: `sdd\u002Fdual-harness\u002Frules\u002Fsdd-gates.md` |\n| Verificar antes de implementar      | `sdd\u002Fprompts\u002Fcheck-spec-before-implement.prompt.md` |\n| **Registrar un fix \u002F hotfix**       | **`sdd\u002Fprompts\u002Fhotfix-bypass-gate.prompt.md`**      |\n| **Ver todos los fixes activos**     | **`sdd\u002Ffixes.json`**                                |\n| Stack de una app específica         | `sdd\u002Fcontext\u002Fapps\u002F[app]\u002Fconstitution.md`            |\n| Endpoints ya implementados          | `sdd\u002Fapi.json`                                      |\n| Tablas ya definidas                 | `sdd\u002Fschema.json`                                   |\n| Tasks del ciclo actual              | `sdd\u002Fspecs\u002F{spec-id}\u002Fcycles\u002Fcycle-[XX]\u002Ftasks.json`  |\n| Resumen de tasks de todos los specs | `sdd\u002Ftasks.json` (índice generado)                  |\n| Schemas de los registros JSON       | `sdd\u002Fschemas\u002F*.schema.json`                         |\n| Specs registradas                   | `sdd\u002Fspecs\u002Findex.json`                              |\n| Crear API Spring Boot               | `sdd\u002Fskills\u002Fgenerate-springboot-api\u002FSKILL.md`       |\n| Crear componente React              | `sdd\u002Fskills\u002Fgenerate-react-component\u002FSKILL.md`      |\n| Motion \u002F animaciones \u002F dirección visual | `sdd\u002Fskills\u002Fcrafted-motion\u002FSKILL.md`            |\n| Ver visor SDD en vivo (sin build)   | `pnpm sdd:docs` → `sdd\u002Fdocs\u002F`                       |\n\n---\n\n## 9. Template: fix individual (FIX GATE)\n\n> Con `profile: solo` alcanza el **template mínimo**: título + `## Problema` (2 líneas) +\n> `## Solución aplicada` con `### Archivos modificados`. El resto de las secciones se omite.\n\nCada fix es un archivo independiente. El nombre del archivo es el ID del fix en kebab-case:\n\n- Repo-level: `sdd\u002Ffixes\u002Ffix-[gh-user]-[seq].md`\n- Spec-level: `sdd\u002Fspecs\u002F{spec-id}\u002Ffixes\u002Ffix-[gh-user]-[spec-NNN]-[seq].md`\n\n```markdown\n# FIX-[gh-user]-[seq] — [Título del fix]\n\n| Campo         | Valor                                          |\n| ------------- | ---------------------------------------------- |\n| **ID**        | FIX-[gh-user]-[seq]                            |\n| **Tipo**      | HOTFIX \\| BUGFIX \\| FIX \\| IMPROVEMENT         |\n| **Severidad** | critical \\| high \\| medium \\| low              |\n| **Keyword**   | [HOTFIX] \\| [BUGFIX] \\| [FIX] \\| [IMPROVEMENT] |\n| **Fecha**     | YYYY-MM-DD                                     |\n| **Autor**     | [gh-user]                                      |\n| **Estado**    | pending \\| implemented \\| completed            |\n| **Spec**      | [spec-id] o N\u002FA (repo-level)                   |\n\n## Problema\n\n\u003CDescripción del problema detectado>\n\n## Justificación del bypass\n\n\u003CPor qué no podía esperar un ciclo SDD normal>\n\n## Solución aplicada\n\n\u003CDescripción de la solución implementada>\n\n### Archivos modificados\n\n- `apps\u002F...\u002FArchivo.java` — descripción del cambio\n- `apps\u002F...\u002FArchivo2.java` — descripción del cambio\n\n### Test de validación\n\n- **Referencia:** `apps\u002F...\u002FSomeTest.java#testMethod` (o justificación de ausencia)\n\n### Decisión del Reviewer\n\n> [A completar por sdd-reviewer al cerrar el ciclo]\n>\n> - [ ] `validated` — fix correcto, no requiere seguimiento\n> - [ ] `absorbed` — debe formalizarse en próxima spec: SPEC-XXX\n\n---\n```\n",{"name":5,"description":7},"main","c3d54dc0db791f99e689a6b86ece5b6099b12809","sdd\u002Fskills\u002Fsdd-file-structure","https:\u002F\u002Fgithub.com\u002Fe-burgos\u002Fvideo-maker","https:\u002F\u002Fgithub.com\u002Fe-burgos","https:\u002F\u002Festebanburgos.com.ar\u002F","More than 12 years of experience in different technology companies, I am oriented to design and develop productive and profitable software solutions. ","2026-11-15 03:24:14",{"source":8,"skillName":5,"commands":33,"prompt":43,"zipAvailable":44},[34,37,40],{"tool":35,"command":36},"npx","npx skills add e-burgos\u002Fvideo-maker --skill sdd-file-structure",{"tool":38,"command":39},"bunx","bunx skills add e-burgos\u002Fvideo-maker --skill sdd-file-structure",{"tool":41,"command":42},"pnpm","pnpm dlx skills add e-burgos\u002Fvideo-maker --skill sdd-file-structure","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002Fe-burgos\u002Fvideo-maker\u002Fblob\u002Fmain\u002Fsdd\u002Fskills\u002Fsdd-file-structure\u002FSKILL.md",true,[],[47,54,61,68,75,82],{"skillNo":48,"name":49,"nameZh":6,"description":50,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":51,"categories":52,"keywords":53,"publishedAt":19},"01M7C8WJD3Y1T31YNSK5BFZKJ1","video-producer","Productor de video conversacional del Video Maker Studio. Parte de un prompt del usuario y del material que haya en `media\u002F\u003Cslug>\u002Fraw\u002F` (videos, fotos, pantallas grabadas, locución, música, guion, o nada), acuerda con el usuario qué video hacer y lo produce con las herramientas ya implementadas (guion, voz Piper, montaje, captions, mezcla, render), buscando medios libres solo cuando el usuario lo pide o no hay material. Invocar con `\u002Fvideo-producer media\u002F\u003Cslug>` o cuando el usuario pida \"armá\u002Fgenerá un video\" sobre un proyecto.","https:\u002F\u002Fgithub.com\u002Fe-burgos\u002Fvideo-maker\u002Fblob\u002Fmain\u002Fsdd\u002Fskills\u002Fvideo-producer\u002FSKILL.md",[],[],{"skillNo":55,"name":56,"nameZh":6,"description":57,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":58,"categories":59,"keywords":60,"publishedAt":19},"01M7C8WDBXCXT0K71MXSX11HVX","tucu-ui-pro","Usar siempre que un frontend React\u002FNext use (o vaya a usar) @e-burgos\u002Ftucu-ui — montarlo en Vite, Next 16 o una app con Tailwind propio, elegir ThemeProvider\u002Flayout\u002Fpreset, tematizar con customPaletteColor y tokens --tucu-*, elegir el componente correcto con sus props válidos y esquivar las trampas que rompen en runtime, con o sin el MCP tucu-ui conectado.","https:\u002F\u002Fgithub.com\u002Fe-burgos\u002Fvideo-maker\u002Fblob\u002Fmain\u002Fsdd\u002Fskills\u002Ftucu-ui-pro\u002FSKILL.md",[],[],{"skillNo":62,"name":63,"nameZh":6,"description":64,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":65,"categories":66,"keywords":67,"publishedAt":19},"01M7C8W9MEXVQZPN9EP391J9YN","setup-graphify","Instala y configura graphify (grafo de conocimiento del repo) para un dev que lo quiera usar. Elige un backend gratuito, valida el modelo con una medición real y construye el primer grafo. Invocar solo si el dev pide habilitar graphify.","https:\u002F\u002Fgithub.com\u002Fe-burgos\u002Fvideo-maker\u002Fblob\u002Fmain\u002Fsdd\u002Fskills\u002Fsetup-graphify\u002FSKILL.md",[],[],{"skillNo":69,"name":70,"nameZh":6,"description":71,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":72,"categories":73,"keywords":74,"publishedAt":19},"01M7C8W3NAKN7QQWWCGZ2GH9M7","sdd-steward","Conserje del kit SDD - puerta de entrada para status del harness, actualización de la librería, arranque de ideas, costos y salud de los arneses. Clasifica cualquier pedido con la tabla de ruteo, ejecuta solo lo que no tiene otro dueño y delega el resto sin bypassear gates. Invocar ante cualquier pregunta u operación sobre el kit en sí.","https:\u002F\u002Fgithub.com\u002Fe-burgos\u002Fvideo-maker\u002Fblob\u002Fmain\u002Fsdd\u002Fskills\u002Fsdd-steward\u002FSKILL.md",[],[],{"skillNo":76,"name":77,"nameZh":6,"description":78,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":79,"categories":80,"keywords":81,"publishedAt":19},"01M7C8W0M5MPXACHFBRHRCJE58","sdd-reviewer","Skill del Agente Reviewer SDD. Valida la calidad de todo el output del ciclo y ejecuta los gates de cierre. Invocar cuando todas las tasks de implementación del ciclo estén completas.","https:\u002F\u002Fgithub.com\u002Fe-burgos\u002Fvideo-maker\u002Fblob\u002Fmain\u002Fsdd\u002Fskills\u002Fsdd-reviewer\u002FSKILL.md",[],[],{"skillNo":83,"name":84,"nameZh":6,"description":85,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":86,"categories":87,"keywords":88,"publishedAt":19},"01M7C8VY27546VQSRY8E3AQ7XN","sdd-planner","Skill del Agente Planner SDD. Convierte historias de usuario en tasks técnicas ordenadas y estimadas. Invocar después del Funcional, en paralelo con el Arquitecto.","https:\u002F\u002Fgithub.com\u002Fe-burgos\u002Fvideo-maker\u002Fblob\u002Fmain\u002Fsdd\u002Fskills\u002Fsdd-planner\u002FSKILL.md",[],[]]