[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M756A2FHK5FGS4WVWJDRHEB3":3,"skill-same:01M756A2FHK5FGS4WVWJDRHEB3":47},{"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":27,"repositoryHtmlUrl":28,"repositoryHomepageUrl":6,"ownerHtmlUrl":29,"ownerBlogUrl":30,"ownerDescription":31,"updatedAt":32,"install":33,"resources":46},"01M756A2FHK5FGS4WVWJDRHEB3","sdd-hermes",null,"Loop agéntico punta a punta - de una idea en lenguaje natural a producto funcionando. Descubre requisitos, decide y configura el stack con la CLI harness, siembra specs y conduce ciclos SDD encadenados hasta agotar el backlog, con presupuesto de modelo\u002Fesfuerzo por fase y condiciones de corte explícitas. Invocar cuando el usuario trae una idea u objetivo, no una spec.","e-burgos\u002Fsdd-harness","e-burgos","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F71472902?v=4","01M728XDZXTGQMP76CXHXWT7B6","EstebanBurgos","01M7566FK459ADH43W2FWZZPNF",0,"MIT","https:\u002F\u002Fgithub.com\u002Fe-burgos\u002Fsdd-harness\u002Fblob\u002Fmain\u002Fsdd\u002Fskills\u002Fsdd-hermes\u002FSKILL.md",[],[],"2026-11-12 13:55:43",false,"---\nname: sdd-hermes\ndescription: Loop agéntico punta a punta - de una idea en lenguaje natural a producto funcionando. Descubre requisitos, decide y configura el stack con la CLI harness, siembra specs y conduce ciclos SDD encadenados hasta agotar el backlog, con presupuesto de modelo\u002Fesfuerzo por fase y condiciones de corte explícitas. Invocar cuando el usuario trae una idea u objetivo, no una spec.\n---\n\n# Skill: sdd-hermes\n\n## Cuándo invocarlo\n\n- El usuario trae **una idea, un objetivo o un problema** (\"quiero una app que...\",\n  \"necesito automatizar...\") y espera que el sistema lo lleve a producto.\n- NO invocarlo si ya existe una spec para el trabajo pedido → ir directo a\n  `sdd-orchestrator` (SPEC GATE normal). Hermes no reemplaza el ciclo SDD: lo conduce.\n\n## Principios (inviolables)\n\n1. **SDD es el corazón.** Hermes jamás bypassea SPEC GATE, CONTEXTO GATE ni MEMORIA\n   GATE — su único privilegio es encadenar fases sin esperar instrucciones humanas\n   entre medio.\n2. **Checkpoints humanos.** Dos decisiones son siempre del usuario: el **stack**\n   (fin de FASE 2) y cada **spec** antes de implementar (fin de FASE 4). El resto\n   corre solo, salvo que el usuario pida modo asistido (checkpoint por fase).\n3. **Presupuesto explícito.** Cada fase declara su tier de modelo\u002Fesfuerzo ANTES de\n   ejecutar (regla ⚙️ del dual-harness — vale para Claude, Gemini\u002FAntigravity y\n   Copilot por igual). Hermes es un loop largo: sin esta disciplina el costo explota.\n4. **Todo queda registrado en `sdd\u002F`.** Si Hermes se interrumpe en cualquier punto,\n   otro agente retoma desde los registros — el loop no tiene estado propio.\n\n## Presupuesto por fase (regla ⚙️ aplicada al loop)\n\nLos tiers son abstractos a propósito: la equivalencia concreta por proveedor\n(Claude `model`\u002F`effort`, Gemini modelo\u002F`thinking`, Copilot picker\u002Fagents) vive en\n**una sola fuente**: la tabla canónica ⚙️ del dual-harness (`AGENTS.md`\u002F`CLAUDE.md`\u002F\n`GEMINI.md` raíz). No duplicar esa tabla acá.\n\n| Fase                           | Tier             | Nota                                                                       |\n| ------------------------------ | ---------------- | -------------------------------------------------------------------------- |\n| 1. Descubrimiento              | **estándar**     | Extraer, no razonar profundo                                               |\n| 2. Decisión de stack           | **alto**         | Una sola vez, cross-cutting, caro equivocarse                              |\n| 3. Configuración del workspace | **económico**    | Mecánica: escribir config + correr CLI                                     |\n| 4. Redacción de specs          | **alto**         | La spec es el contrato de todo lo que sigue                                |\n| 5. Loop de ciclos              | según agente SDD | La tabla canónica ⚙️ manda: implementores **estándar**, orquestador\u002Farquitecto\u002Freviewer **alto** |\n\n## FASE 1 — Descubrimiento (una ronda de preguntas, máximo)\n\nLeer `sdd\u002Fmemory\u002Flessons.md` (MEMORIA GATE) y extraer de la idea:\n\n- **Dominio y usuarios**: quién lo usa y para qué.\n- **Módulos core**: 3–7 capacidades con nombre propio (serán los módulos SDD).\n- **Necesidades técnicas** (checklist): ¿persistencia? ¿tiempo real? ¿colas\u002Fjobs?\n  ¿archivos\u002Fmedia? ¿auth? ¿UI web? ¿API pública? ¿integraciones externas?\n\nSi algo **bloquea la decisión de stack**, hacer UNA ronda de preguntas concretas.\nTodo lo demás se asume con defaults y se anota como supuesto en la spec — no\ninterrogar al usuario por lo que una spec puede fijar después.\n\nEscribir lo relevado en `harness.idea.md` (no en la cabeza ni en cada spec después):\n\n- **`## Evidencia del descubrimiento`**: tabla `Fuente | Estado de acceso | Dato medido\n  | Fecha` — una fila por cada dato que sostiene una decisión de dominio\u002Fmódulo\u002Fnecesidad\n  técnica (repo existente inspeccionado, API externa, entrevista, métrica).\n- **`## Decisiones del dev`**: una entrada con fecha por cada respuesta que el usuario dio\n  en la ronda de preguntas.\n\nLas specs de FASE 4 **citan** estas secciones (referencia a la fila\u002Ffecha) en vez de\ncopiar la evidencia a mano — una sola fuente, sin duplicación que se desincroniza.\n\n## FASE 2 — Decisión de stack (matriz → propuesta → checkpoint)\n\n| Necesidad detectada                          | Pieza                                     |\n| -------------------------------------------- | ----------------------------------------- |\n| API con dominio rico, websockets, jobs       | app `nestjs`                              |\n| API liviana \u002F microservicio simple           | app `fastify`                             |\n| Scripting, datos, ML, integraciones Python   | app `python`                              |\n| UI web SPA (dashboard, admin, tool interna)  | app `react`                               |\n| UI web con SSR\u002FSEO (producto público)        | app `nextjs`                              |\n| Persistencia relacional                      | service `postgres`                        |\n| Cache, sesiones, rate-limit, pub\u002Fsub simple  | service `redis`                           |\n| Colas\u002Feventos entre servicios                | service `rabbitmq`                        |\n| Archivos\u002Fmedia (S3-compatible)               | service `minio`                           |\n| Front + back en el stack                     | libs `shared-types` + `api-client`        |\n| ≥2 apps TypeScript                           | lib `shared-utils`; UI compartida → `ui-kit` |\n\nReglas: **una sola app → modo `standalone`**; front+back o multi-servicio → modo\n`nx`. Ante la duda entre dos piezas, la más simple. No agregar piezas \"por si\nacaso\": `harness add app|service` existe para cuando la spec lo exija.\n\n**Checkpoint:** presentar stack propuesto + módulos + supuestos. Sin aprobación no\nse genera nada.\n\n## FASE 3 — Configuración del workspace (mecánica, cero prompts)\n\n**Repo vacío** → escribir `harness.config.json` y correr la vía no interactiva:\n\n```jsonc\n{\n  \"mode\": \"nx\", \u002F\u002F o \"standalone\" (exactamente 1 app)\n  \"project\": {\n    \"name\": \"mi-proyecto\", \u002F\u002F kebab-case\n    \"description\": \"Qué es y para quién\",\n    \"packageScope\": \"@mi-proyecto\"\n  },\n  \"apps\": [{ \"name\": \"core-api\", \"type\": \"nestjs\" }], \u002F\u002F nestjs|react|python|nextjs|fastify|springboot|hono\n  \"libs\": [{ \"name\": \"shared-types\", \"type\": \"shared-types\" }], \u002F\u002F shared-types|shared-utils|ui-kit|api-client|config\n  \"services\": [{ \"type\": \"postgres\" }] \u002F\u002F postgres|redis|rabbitmq|minio (port\u002Fversion opcionales)\n}\n```\n\n```bash\nnpx @e-burgos\u002Fsdd-harness init --config .\u002Fharness.config.json\n```\n\n`init --config` genera **en el cwd** cuando el cwd ya contiene el `harness.config.json`\nindicado, o `basename(cwd) == project.name`, o se pasa `--here` — si no, crea\n`\u003Cproject.name>\u002F` aparte. `harness.idea.md`, `harness.config.json` y su `.schema.json`\nquedan dentro del workspace generado (son la entrada del protocolo Hermes). Si el cwd ya\nes repo git, `init` NO corre `git init`: commitea sobre la rama actual.\n\n`init` termina corriendo el gate de FASE 3 automáticamente — `sdd:validate` +\n`nx run-many -t lint test build` (modo nx) o los scripts `lint`\u002F`test`\u002F`build` que\nexistan en el `package.json` (standalone) — y **falla** si algo queda rojo. Usar\n`--skip-verify` solo con justificación explícita (por ejemplo, un servicio externo que\nel sandbox no puede levantar); nunca para apurar el checkpoint.\n\nSi `NX_WORKSPACE_ROOT_PATH` está definida y no apunta al cwd, `init` lo advierte en la\nprimera línea de salida — un `nx run-many` corrido con esa variable mal seteada ejecuta\ncontra OTRO repo sin error visible. Verificarla antes de confiar en el resultado del gate.\n\n**Repo existente sin SDD** → instalarlo sin tocar el código, sin prompts:\n\n```bash\nnpx @e-burgos\u002Fsdd-harness configure sdd --name mi-proyecto --description \"Qué es y para quién\"\n```\n\n(agregar `-y` sólo si ya hay un `sdd\u002F` y querés **resetearlo** — borra specs, ciclos y fixes).\n\n**Workspace SDD existente** → cubrir solo los gaps: `harness add app \u003Ctype> --name \u003Cname>`,\n`harness add service \u003Ctype>`, `harness configure docker --services postgres,redis`.\n\n> Todo comando de la CLI tiene flags para cada prompt: sin ellos el comando abre un\n> prompt interactivo que **no se puede responder por stdin** (se cuelga). Pasá siempre\n> los flags, y `harness \u003Ccomando> --help` lista los que faltan.\n\n**Verificación de fase (gate):** `pnpm sdd:validate` verde + build del workspace verde.\nCon `init --config` (sin `--skip-verify`) ya corrió solo; con `configure sdd` sobre un\nrepo existente, correrlo a mano. Rojo → arreglar antes de seguir; nunca sembrar specs\nsobre base rota.\n\n## FASE 4 — Sembrar el backlog SDD\n\nDos caminos — usar el que corresponda a cómo se armó `harness.config.json` en FASE 3:\n\n**A. Un `add spec` por módulo** (camino por defecto), en orden de dependencia:\n\n1. `harness add spec \u003Cslug-del-modulo> --author \u003Cgh-user> --title \"\u003Ctítulo>\" --app apps\u002F\u003Csubproyecto> [--apps apps\u002Fa,libs\u002Fb] [--depends-on \u003Cspec-id|slug>]...`\n   — crea la estructura, registra la spec en `sdd\u002Fspecs\u002Findex.json` con\n   `status: \"draft\"` (incluyendo `depends_on`) y registra el módulo en\n   `pending_modules` de `sdd\u002Fglobal.json` **automáticamente**\n   (`{module, spec, apps, cycles_completed: 0, description}`). No hay paso manual de\n   `pending_modules` — el comando ya lo hace.\n2. Redactar el `.spec.md` desde el descubrimiento: objetivo, alcance del primer\n   ciclo, criterios de aceptación de alto nivel; citar la evidencia\u002Fdecisiones de\n   `harness.idea.md` (FASE 1) en vez de copiarlas a mano.\n\n**B. Sembrado por config** (alternativa, cuando `sdd.modules` ya se declaró en el\n`harness.config.json` de FASE 3): cada módulo (string o `{name, title?, app?, apps?,\ndepends_on?}`) de `sdd.modules` se convierte en spec `draft` + entrada en\n`pending_modules` al correr `init` — no hace falta repetir `add spec` por módulo, solo\nredactar el `.spec.md` de cada uno (paso 2 de arriba).\n\nEn ambos caminos la spec queda `draft` hasta que el **orquestador** abre cycle-01 en\nFASE 5 (`draft → in-progress`) — Hermes nunca cambia ese status por su cuenta.\n\n**Checkpoint por spec:** la spec es el contrato — el usuario la aprueba (o edita)\nantes de que el loop la implemente. En modo full-auto explícitamente pedido, se\naprueban en bloque acá y el loop no vuelve a preguntar.\n\n## FASE 5 — El loop de ciclos\n\n```\nmientras global.json tenga pending_modules o in_progress_modules:\n  1. sdd-orchestrator  → pnpm sdd:gate \u003Cspec> (GATE A), consolidación de contexto,\n                         destilación de memoria si journal ≥5, decisión de flow\n                         (profile team → full · solo → lite), brief, cycle.json in-progress\n  2. sdd-functional    → functional.md\n  3. sdd-planner + sdd-architect → tasks.json, planner.md, architect.md,\n                         api\u002Fschema\u002Fcomponents\n  4. sdd-implementor-back \u002F -front → tasks done, registros actualizados\n  5. sdd-reviewer      → pnpm sdd:validate verde, CA verificados, CONTEXTO GATE\n                         (fragmento aditivo), MEMORIA GATE (journal si hubo\n                         lección), cycle.json completed\n  6. commit del ciclo → siguiente módulo\n```\n\nCon `profile: solo` en `global.json` los pasos 2–5 los ejecuta **un solo actor** por ciclo\n(`flow: lite`: `plan.md` + `tasks.json`, implementación, cierre) — Hermes no lanza subagentes\nde documentos en ese caso; sí mantiene los gates de cierre.\n\n**Condiciones de corte (obligatorias — Hermes para y reporta, no insiste):**\n\n- `pnpm sdd:validate` o los tests fallan **2 veces en el mismo punto** con causas\n  distintas de tipeo → parar, reportar diagnóstico y estado exacto del loop.\n- Aparece una **decisión de producto** no cubierta por la spec → preguntar al\n  usuario; nunca inventarla.\n- **Presupuesto\u002Fuso agotado** (límite de sesión, rate limit, cupo del plan): cerrar\n  limpio el ciclo en curso (o dejarlo `in-progress` con registros válidos), commitear\n  y reportar en qué punto del backlog quedó — los registros SDD son el checkpoint;\n  cualquier sesión futura retoma con `sdd\u002Fglobal.json` + `sdd\u002Fmemory\u002Flessons.md`.\n\n**Disciplina de tokens dentro del loop:** brief mínimo por agente (el orquestador ya\nlo garantiza); jamás releer specs completas si el brief alcanza; `lessons.md` al\ninicio de cada sesión; graphify si existe; los implementores en tier **estándar** con\ncontexto acotado a su task — mecanismo según proveedor: subagentes con `model`\u002F`effort`\nexplícitos en Claude Code, subagentes de modelo económico\u002Festándar en Gemini CLI,\ncustom agents con `model:` pinneado en Copilot, y en Antigravity verificar el dropdown\nantes de cada fase (regla ⚙️).\n\n**Telemetría del loop (obligatoria al cerrar cada ciclo):** cada agente registra su\npropia unidad en `cycle.json → metrics.usage.by_agent[]` al cerrarla — la task\nimplementada, el documento (functional\u002Fplanner\u002Farchitect), la coordinación del\norquestador. Cuando Hermes o el orquestador lanzan un subagente vía la tool `Agent`\n(Claude Code), la notificación `agent-usage-notification`\n(`\u003Cusage>\u003Csubagent_tokens>N\u003C\u002Fsubagent_tokens>…\u003C\u002Fusage>`) del padre es la fuente exacta\npara esa entrada — `approx: false`, split 85\u002F15 en `tokens_in`\u002F`tokens_out`; si el mismo\nsubagente se reanuda con `SendMessage`, `N` llega **acumulado** desde el lanzamiento y se\nregistra la diferencia con la notificación anterior. El\n**reviewer**, al cerrar, verifica que `by_agent` esté completo, agrega su propia\nentrada, deriva `by_tier` agrupando por `provider_model` (`claude\u002Fopus`, `gemini\u002Fpro`,\n`copilot\u002Fclaude-sonnet`; Antigravity bajo `gemini\u002F*`) y suma el total top-level — nunca\nlo reconstruye a estimación. Todo fix generado dentro del loop registra su `usage` (y\n`by_agent` si participó más de un agente) en `sdd\u002Ffixes.json` al resolverse. Fuente del\nnúmero: `\u002Fstats` en Gemini CLI, reporte de sesión en Claude Code — ambos comandos del\ncliente que el agente no puede ejecutar — y estimación declarada en Antigravity\u002FCopilot,\nque no tienen contador. **Hermes no cierra un ciclo sin este registro.** Sin contador se\nestima con `approx: true` y `source: \"declared-estimate\"`; no existe la opción de omitir.\n\n## Automatización del loop (opcional — por proveedor)\n\nEl loop es retomable por diseño: todo el estado vive en los registros SDD, así que\ncualquier sesión nueva puede continuarlo con `sdd\u002Fprompts\u002Fhermes-resume.prompt.md`\n(prompt standalone: carga lessons + `harness.idea.md` + global.json, declara la FASE\nactual y sigue desde ahí). Para un repaso rápido sin abrir archivos,\n`harness idea --show` imprime la idea, la evidencia del descubrimiento y las\ndecisiones del dev ya registradas. `setup:agents` ya lo expone en cada arnés; sobre\nesa base, cada proveedor tiene su mecanismo:\n\n| Proveedor          | Retomar el loop                                        | Automatización disponible                                                                 |\n| ------------------ | ------------------------------------------------------ | ----------------------------------------------------------------------------------------- |\n| **Claude Code**    | `\u002Fhermes-resume` (slash command)                       | `\u002Floop 15m` con el prompt; Routines\u002Fcron en sesión nueva; hook `SessionStart` (abajo)      |\n| **Copilot**        | coding agent: asignar un issue con el prompt; CLI: `\u002Fhermes-resume` | hooks repo-level en `.github\u002Fhooks\u002F` (p. ej. inyectar `lessons.md`); custom agents pinneados |\n| **Gemini CLI**     | `\u002Fhermes-resume` (comando TOML generado)               | hooks first-party del CLI; subagentes para las fases mecánicas                             |\n| **Antigravity**    | `\u002Fhermes-resume` (workflow de `.agent\u002Fworkflows\u002F`)     | workflows encadenables; el modelo por fase lo fija el usuario en el dropdown (regla ⚙️)    |\n\n- **Memoria al inicio de sesión (hook opcional, Claude Code):** en\n  `.claude\u002Fsettings.json` del repo, un hook `SessionStart` que imprima la memoria\n  destilada — se inyecta como contexto sin gastar un turno:\n\n  ```json\n  {\n    \"hooks\": {\n      \"SessionStart\": [\n        {\n          \"hooks\": [\n            { \"type\": \"command\", \"command\": \"cat sdd\u002Fmemory\u002Flessons.md 2>\u002Fdev\u002Fnull || true\" }\n          ]\n        }\n      ]\n    }\n  }\n  ```\n\n  El equivalente en Gemini CLI y Copilot CLI se configura con sus propios hooks\n  (mismo comando); el kit no instala ninguno solo: son decisiones del dev (consumen\n  cupo del plan). En arneses sin hooks, el equivalente manual es pegar\n  `hermes-resume.prompt.md` al abrir sesión.\n\n## Archivos que modifica\n\nHermes en sí escribe `harness.idea.md` (idea + evidencia + decisiones del dev, FASE 1),\n`harness.config.json` (FASE 3) y los `.spec.md` (FASE 4). `pending_modules` de\n`sdd\u002Fglobal.json` y el `status: \"draft\"` de cada spec en `sdd\u002Fspecs\u002Findex.json` ya no\nlos escribe Hermes a mano: los registra la CLI (`add spec`, o el sembrado de\n`sdd.modules` en `init`) al correr FASE 4. Todo lo demás lo escriben los agentes SDD\nde cada fase bajo sus propias reglas — ver \"Archivos que modifica\" de cada skill.\n\n## Registro de consumo (obligatorio)\n\nHermes también consume tokens coordinando fases — ese consumo se registra, no se\ndescarta por ser \"solo orquestación\":\n\n- **Dentro de un ciclo o de un fix que Hermes conduce**: su unidad va en\n  `metrics.usage.by_agent[]` del ciclo (o `usage`\u002F`usage.by_agent[]` del fix) con\n  `agent: \"hermes\"`, igual que cualquier otro agente — ver review-cycle.prompt.md\n  paso 4c y hotfix-bypass-gate.prompt.md.\n- **FASE 1–4, fuera de cualquier ciclo** (descubrimiento, decisión de stack,\n  configuración del workspace, redacción de specs): no hay `cycle.json` donde anotarlo\n  todavía. Si el proveedor no expone otro mecanismo de registro en ese momento, anotar\n  el consumo como una línea de costo declarado dentro de `## Decisiones del dev` o\n  `## Evidencia del descubrimiento` de `harness.idea.md` (proveedor\u002Fmodelo, tokens u\n  orden de magnitud, `approx: true` si no hay contador) — se retoma y consolida en el\n  `by_agent` del primer ciclo que abra el orquestador (FASE 5).\n","# Skill: sdd-hermes\n\n## Cuándo invocarlo\n\n- El usuario trae **una idea, un objetivo o un problema** (\"quiero una app que...\",\n  \"necesito automatizar...\") y espera que el sistema lo lleve a producto.\n- NO invocarlo si ya existe una spec para el trabajo pedido → ir directo a\n  `sdd-orchestrator` (SPEC GATE normal). Hermes no reemplaza el ciclo SDD: lo conduce.\n\n## Principios (inviolables)\n\n1. **SDD es el corazón.** Hermes jamás bypassea SPEC GATE, CONTEXTO GATE ni MEMORIA\n   GATE — su único privilegio es encadenar fases sin esperar instrucciones humanas\n   entre medio.\n2. **Checkpoints humanos.** Dos decisiones son siempre del usuario: el **stack**\n   (fin de FASE 2) y cada **spec** antes de implementar (fin de FASE 4). El resto\n   corre solo, salvo que el usuario pida modo asistido (checkpoint por fase).\n3. **Presupuesto explícito.** Cada fase declara su tier de modelo\u002Fesfuerzo ANTES de\n   ejecutar (regla ⚙️ del dual-harness — vale para Claude, Gemini\u002FAntigravity y\n   Copilot por igual). Hermes es un loop largo: sin esta disciplina el costo explota.\n4. **Todo queda registrado en `sdd\u002F`.** Si Hermes se interrumpe en cualquier punto,\n   otro agente retoma desde los registros — el loop no tiene estado propio.\n\n## Presupuesto por fase (regla ⚙️ aplicada al loop)\n\nLos tiers son abstractos a propósito: la equivalencia concreta por proveedor\n(Claude `model`\u002F`effort`, Gemini modelo\u002F`thinking`, Copilot picker\u002Fagents) vive en\n**una sola fuente**: la tabla canónica ⚙️ del dual-harness (`AGENTS.md`\u002F`CLAUDE.md`\u002F\n`GEMINI.md` raíz). No duplicar esa tabla acá.\n\n| Fase                           | Tier             | Nota                                                                       |\n| ------------------------------ | ---------------- | -------------------------------------------------------------------------- |\n| 1. Descubrimiento              | **estándar**     | Extraer, no razonar profundo                                               |\n| 2. Decisión de stack           | **alto**         | Una sola vez, cross-cutting, caro equivocarse                              |\n| 3. Configuración del workspace | **económico**    | Mecánica: escribir config + correr CLI                                     |\n| 4. Redacción de specs          | **alto**         | La spec es el contrato de todo lo que sigue                                |\n| 5. Loop de ciclos              | según agente SDD | La tabla canónica ⚙️ manda: implementores **estándar**, orquestador\u002Farquitecto\u002Freviewer **alto** |\n\n## FASE 1 — Descubrimiento (una ronda de preguntas, máximo)\n\nLeer `sdd\u002Fmemory\u002Flessons.md` (MEMORIA GATE) y extraer de la idea:\n\n- **Dominio y usuarios**: quién lo usa y para qué.\n- **Módulos core**: 3–7 capacidades con nombre propio (serán los módulos SDD).\n- **Necesidades técnicas** (checklist): ¿persistencia? ¿tiempo real? ¿colas\u002Fjobs?\n  ¿archivos\u002Fmedia? ¿auth? ¿UI web? ¿API pública? ¿integraciones externas?\n\nSi algo **bloquea la decisión de stack**, hacer UNA ronda de preguntas concretas.\nTodo lo demás se asume con defaults y se anota como supuesto en la spec — no\ninterrogar al usuario por lo que una spec puede fijar después.\n\nEscribir lo relevado en `harness.idea.md` (no en la cabeza ni en cada spec después):\n\n- **`## Evidencia del descubrimiento`**: tabla `Fuente | Estado de acceso | Dato medido\n  | Fecha` — una fila por cada dato que sostiene una decisión de dominio\u002Fmódulo\u002Fnecesidad\n  técnica (repo existente inspeccionado, API externa, entrevista, métrica).\n- **`## Decisiones del dev`**: una entrada con fecha por cada respuesta que el usuario dio\n  en la ronda de preguntas.\n\nLas specs de FASE 4 **citan** estas secciones (referencia a la fila\u002Ffecha) en vez de\ncopiar la evidencia a mano — una sola fuente, sin duplicación que se desincroniza.\n\n## FASE 2 — Decisión de stack (matriz → propuesta → checkpoint)\n\n| Necesidad detectada                          | Pieza                                     |\n| -------------------------------------------- | ----------------------------------------- |\n| API con dominio rico, websockets, jobs       | app `nestjs`                              |\n| API liviana \u002F microservicio simple           | app `fastify`                             |\n| Scripting, datos, ML, integraciones Python   | app `python`                              |\n| UI web SPA (dashboard, admin, tool interna)  | app `react`                               |\n| UI web con SSR\u002FSEO (producto público)        | app `nextjs`                              |\n| Persistencia relacional                      | service `postgres`                        |\n| Cache, sesiones, rate-limit, pub\u002Fsub simple  | service `redis`                           |\n| Colas\u002Feventos entre servicios                | service `rabbitmq`                        |\n| Archivos\u002Fmedia (S3-compatible)               | service `minio`                           |\n| Front + back en el stack                     | libs `shared-types` + `api-client`        |\n| ≥2 apps TypeScript                           | lib `shared-utils`; UI compartida → `ui-kit` |\n\nReglas: **una sola app → modo `standalone`**; front+back o multi-servicio → modo\n`nx`. Ante la duda entre dos piezas, la más simple. No agregar piezas \"por si\nacaso\": `harness add app|service` existe para cuando la spec lo exija.\n\n**Checkpoint:** presentar stack propuesto + módulos + supuestos. Sin aprobación no\nse genera nada.\n\n## FASE 3 — Configuración del workspace (mecánica, cero prompts)\n\n**Repo vacío** → escribir `harness.config.json` y correr la vía no interactiva:\n\n```jsonc\n{\n  \"mode\": \"nx\", \u002F\u002F o \"standalone\" (exactamente 1 app)\n  \"project\": {\n    \"name\": \"mi-proyecto\", \u002F\u002F kebab-case\n    \"description\": \"Qué es y para quién\",\n    \"packageScope\": \"@mi-proyecto\"\n  },\n  \"apps\": [{ \"name\": \"core-api\", \"type\": \"nestjs\" }], \u002F\u002F nestjs|react|python|nextjs|fastify|springboot|hono\n  \"libs\": [{ \"name\": \"shared-types\", \"type\": \"shared-types\" }], \u002F\u002F shared-types|shared-utils|ui-kit|api-client|config\n  \"services\": [{ \"type\": \"postgres\" }] \u002F\u002F postgres|redis|rabbitmq|minio (port\u002Fversion opcionales)\n}\n```\n\n```bash\nnpx @e-burgos\u002Fsdd-harness init --config .\u002Fharness.config.json\n```\n\n`init --config` genera **en el cwd** cuando el cwd ya contiene el `harness.config.json`\nindicado, o `basename(cwd) == project.name`, o se pasa `--here` — si no, crea\n`\u003Cproject.name>\u002F` aparte. `harness.idea.md`, `harness.config.json` y su `.schema.json`\nquedan dentro del workspace generado (son la entrada del protocolo Hermes). Si el cwd ya\nes repo git, `init` NO corre `git init`: commitea sobre la rama actual.\n\n`init` termina corriendo el gate de FASE 3 automáticamente — `sdd:validate` +\n`nx run-many -t lint test build` (modo nx) o los scripts `lint`\u002F`test`\u002F`build` que\nexistan en el `package.json` (standalone) — y **falla** si algo queda rojo. Usar\n`--skip-verify` solo con justificación explícita (por ejemplo, un servicio externo que\nel sandbox no puede levantar); nunca para apurar el checkpoint.\n\nSi `NX_WORKSPACE_ROOT_PATH` está definida y no apunta al cwd, `init` lo advierte en la\nprimera línea de salida — un `nx run-many` corrido con esa variable mal seteada ejecuta\ncontra OTRO repo sin error visible. Verificarla antes de confiar en el resultado del gate.\n\n**Repo existente sin SDD** → instalarlo sin tocar el código, sin prompts:\n\n```bash\nnpx @e-burgos\u002Fsdd-harness configure sdd --name mi-proyecto --description \"Qué es y para quién\"\n```\n\n(agregar `-y` sólo si ya hay un `sdd\u002F` y querés **resetearlo** — borra specs, ciclos y fixes).\n\n**Workspace SDD existente** → cubrir solo los gaps: `harness add app \u003Ctype> --name \u003Cname>`,\n`harness add service \u003Ctype>`, `harness configure docker --services postgres,redis`.\n\n> Todo comando de la CLI tiene flags para cada prompt: sin ellos el comando abre un\n> prompt interactivo que **no se puede responder por stdin** (se cuelga). Pasá siempre\n> los flags, y `harness \u003Ccomando> --help` lista los que faltan.\n\n**Verificación de fase (gate):** `pnpm sdd:validate` verde + build del workspace verde.\nCon `init --config` (sin `--skip-verify`) ya corrió solo; con `configure sdd` sobre un\nrepo existente, correrlo a mano. Rojo → arreglar antes de seguir; nunca sembrar specs\nsobre base rota.\n\n## FASE 4 — Sembrar el backlog SDD\n\nDos caminos — usar el que corresponda a cómo se armó `harness.config.json` en FASE 3:\n\n**A. Un `add spec` por módulo** (camino por defecto), en orden de dependencia:\n\n1. `harness add spec \u003Cslug-del-modulo> --author \u003Cgh-user> --title \"\u003Ctítulo>\" --app apps\u002F\u003Csubproyecto> [--apps apps\u002Fa,libs\u002Fb] [--depends-on \u003Cspec-id|slug>]...`\n   — crea la estructura, registra la spec en `sdd\u002Fspecs\u002Findex.json` con\n   `status: \"draft\"` (incluyendo `depends_on`) y registra el módulo en\n   `pending_modules` de `sdd\u002Fglobal.json` **automáticamente**\n   (`{module, spec, apps, cycles_completed: 0, description}`). No hay paso manual de\n   `pending_modules` — el comando ya lo hace.\n2. Redactar el `.spec.md` desde el descubrimiento: objetivo, alcance del primer\n   ciclo, criterios de aceptación de alto nivel; citar la evidencia\u002Fdecisiones de\n   `harness.idea.md` (FASE 1) en vez de copiarlas a mano.\n\n**B. Sembrado por config** (alternativa, cuando `sdd.modules` ya se declaró en el\n`harness.config.json` de FASE 3): cada módulo (string o `{name, title?, app?, apps?,\ndepends_on?}`) de `sdd.modules` se convierte en spec `draft` + entrada en\n`pending_modules` al correr `init` — no hace falta repetir `add spec` por módulo, solo\nredactar el `.spec.md` de cada uno (paso 2 de arriba).\n\nEn ambos caminos la spec queda `draft` hasta que el **orquestador** abre cycle-01 en\nFASE 5 (`draft → in-progress`) — Hermes nunca cambia ese status por su cuenta.\n\n**Checkpoint por spec:** la spec es el contrato — el usuario la aprueba (o edita)\nantes de que el loop la implemente. En modo full-auto explícitamente pedido, se\naprueban en bloque acá y el loop no vuelve a preguntar.\n\n## FASE 5 — El loop de ciclos\n\n```\nmientras global.json tenga pending_modules o in_progress_modules:\n  1. sdd-orchestrator  → pnpm sdd:gate \u003Cspec> (GATE A), consolidación de contexto,\n                         destilación de memoria si journal ≥5, decisión de flow\n                         (profile team → full · solo → lite), brief, cycle.json in-progress\n  2. sdd-functional    → functional.md\n  3. sdd-planner + sdd-architect → tasks.json, planner.md, architect.md,\n                         api\u002Fschema\u002Fcomponents\n  4. sdd-implementor-back \u002F -front → tasks done, registros actualizados\n  5. sdd-reviewer      → pnpm sdd:validate verde, CA verificados, CONTEXTO GATE\n                         (fragmento aditivo), MEMORIA GATE (journal si hubo\n                         lección), cycle.json completed\n  6. commit del ciclo → siguiente módulo\n```\n\nCon `profile: solo` en `global.json` los pasos 2–5 los ejecuta **un solo actor** por ciclo\n(`flow: lite`: `plan.md` + `tasks.json`, implementación, cierre) — Hermes no lanza subagentes\nde documentos en ese caso; sí mantiene los gates de cierre.\n\n**Condiciones de corte (obligatorias — Hermes para y reporta, no insiste):**\n\n- `pnpm sdd:validate` o los tests fallan **2 veces en el mismo punto** con causas\n  distintas de tipeo → parar, reportar diagnóstico y estado exacto del loop.\n- Aparece una **decisión de producto** no cubierta por la spec → preguntar al\n  usuario; nunca inventarla.\n- **Presupuesto\u002Fuso agotado** (límite de sesión, rate limit, cupo del plan): cerrar\n  limpio el ciclo en curso (o dejarlo `in-progress` con registros válidos), commitear\n  y reportar en qué punto del backlog quedó — los registros SDD son el checkpoint;\n  cualquier sesión futura retoma con `sdd\u002Fglobal.json` + `sdd\u002Fmemory\u002Flessons.md`.\n\n**Disciplina de tokens dentro del loop:** brief mínimo por agente (el orquestador ya\nlo garantiza); jamás releer specs completas si el brief alcanza; `lessons.md` al\ninicio de cada sesión; graphify si existe; los implementores en tier **estándar** con\ncontexto acotado a su task — mecanismo según proveedor: subagentes con `model`\u002F`effort`\nexplícitos en Claude Code, subagentes de modelo económico\u002Festándar en Gemini CLI,\ncustom agents con `model:` pinneado en Copilot, y en Antigravity verificar el dropdown\nantes de cada fase (regla ⚙️).\n\n**Telemetría del loop (obligatoria al cerrar cada ciclo):** cada agente registra su\npropia unidad en `cycle.json → metrics.usage.by_agent[]` al cerrarla — la task\nimplementada, el documento (functional\u002Fplanner\u002Farchitect), la coordinación del\norquestador. Cuando Hermes o el orquestador lanzan un subagente vía la tool `Agent`\n(Claude Code), la notificación `agent-usage-notification`\n(`\u003Cusage>\u003Csubagent_tokens>N\u003C\u002Fsubagent_tokens>…\u003C\u002Fusage>`) del padre es la fuente exacta\npara esa entrada — `approx: false`, split 85\u002F15 en `tokens_in`\u002F`tokens_out`; si el mismo\nsubagente se reanuda con `SendMessage`, `N` llega **acumulado** desde el lanzamiento y se\nregistra la diferencia con la notificación anterior. El\n**reviewer**, al cerrar, verifica que `by_agent` esté completo, agrega su propia\nentrada, deriva `by_tier` agrupando por `provider_model` (`claude\u002Fopus`, `gemini\u002Fpro`,\n`copilot\u002Fclaude-sonnet`; Antigravity bajo `gemini\u002F*`) y suma el total top-level — nunca\nlo reconstruye a estimación. Todo fix generado dentro del loop registra su `usage` (y\n`by_agent` si participó más de un agente) en `sdd\u002Ffixes.json` al resolverse. Fuente del\nnúmero: `\u002Fstats` en Gemini CLI, reporte de sesión en Claude Code — ambos comandos del\ncliente que el agente no puede ejecutar — y estimación declarada en Antigravity\u002FCopilot,\nque no tienen contador. **Hermes no cierra un ciclo sin este registro.** Sin contador se\nestima con `approx: true` y `source: \"declared-estimate\"`; no existe la opción de omitir.\n\n## Automatización del loop (opcional — por proveedor)\n\nEl loop es retomable por diseño: todo el estado vive en los registros SDD, así que\ncualquier sesión nueva puede continuarlo con `sdd\u002Fprompts\u002Fhermes-resume.prompt.md`\n(prompt standalone: carga lessons + `harness.idea.md` + global.json, declara la FASE\nactual y sigue desde ahí). Para un repaso rápido sin abrir archivos,\n`harness idea --show` imprime la idea, la evidencia del descubrimiento y las\ndecisiones del dev ya registradas. `setup:agents` ya lo expone en cada arnés; sobre\nesa base, cada proveedor tiene su mecanismo:\n\n| Proveedor          | Retomar el loop                                        | Automatización disponible                                                                 |\n| ------------------ | ------------------------------------------------------ | ----------------------------------------------------------------------------------------- |\n| **Claude Code**    | `\u002Fhermes-resume` (slash command)                       | `\u002Floop 15m` con el prompt; Routines\u002Fcron en sesión nueva; hook `SessionStart` (abajo)      |\n| **Copilot**        | coding agent: asignar un issue con el prompt; CLI: `\u002Fhermes-resume` | hooks repo-level en `.github\u002Fhooks\u002F` (p. ej. inyectar `lessons.md`); custom agents pinneados |\n| **Gemini CLI**     | `\u002Fhermes-resume` (comando TOML generado)               | hooks first-party del CLI; subagentes para las fases mecánicas                             |\n| **Antigravity**    | `\u002Fhermes-resume` (workflow de `.agent\u002Fworkflows\u002F`)     | workflows encadenables; el modelo por fase lo fija el usuario en el dropdown (regla ⚙️)    |\n\n- **Memoria al inicio de sesión (hook opcional, Claude Code):** en\n  `.claude\u002Fsettings.json` del repo, un hook `SessionStart` que imprima la memoria\n  destilada — se inyecta como contexto sin gastar un turno:\n\n  ```json\n  {\n    \"hooks\": {\n      \"SessionStart\": [\n        {\n          \"hooks\": [\n            { \"type\": \"command\", \"command\": \"cat sdd\u002Fmemory\u002Flessons.md 2>\u002Fdev\u002Fnull || true\" }\n          ]\n        }\n      ]\n    }\n  }\n  ```\n\n  El equivalente en Gemini CLI y Copilot CLI se configura con sus propios hooks\n  (mismo comando); el kit no instala ninguno solo: son decisiones del dev (consumen\n  cupo del plan). En arneses sin hooks, el equivalente manual es pegar\n  `hermes-resume.prompt.md` al abrir sesión.\n\n## Archivos que modifica\n\nHermes en sí escribe `harness.idea.md` (idea + evidencia + decisiones del dev, FASE 1),\n`harness.config.json` (FASE 3) y los `.spec.md` (FASE 4). `pending_modules` de\n`sdd\u002Fglobal.json` y el `status: \"draft\"` de cada spec en `sdd\u002Fspecs\u002Findex.json` ya no\nlos escribe Hermes a mano: los registra la CLI (`add spec`, o el sembrado de\n`sdd.modules` en `init`) al correr FASE 4. Todo lo demás lo escriben los agentes SDD\nde cada fase bajo sus propias reglas — ver \"Archivos que modifica\" de cada skill.\n\n## Registro de consumo (obligatorio)\n\nHermes también consume tokens coordinando fases — ese consumo se registra, no se\ndescarta por ser \"solo orquestación\":\n\n- **Dentro de un ciclo o de un fix que Hermes conduce**: su unidad va en\n  `metrics.usage.by_agent[]` del ciclo (o `usage`\u002F`usage.by_agent[]` del fix) con\n  `agent: \"hermes\"`, igual que cualquier otro agente — ver review-cycle.prompt.md\n  paso 4c y hotfix-bypass-gate.prompt.md.\n- **FASE 1–4, fuera de cualquier ciclo** (descubrimiento, decisión de stack,\n  configuración del workspace, redacción de specs): no hay `cycle.json` donde anotarlo\n  todavía. Si el proveedor no expone otro mecanismo de registro en ese momento, anotar\n  el consumo como una línea de costo declarado dentro de `## Decisiones del dev` o\n  `## Evidencia del descubrimiento` de `harness.idea.md` (proveedor\u002Fmodelo, tokens u\n  orden de magnitud, `approx: true` si no hay contador) — se retoma y consolida en el\n  `by_agent` del primer ciclo que abra el orquestador (FASE 5).\n",{"name":5,"description":7},"main","ac03b85c624ed09bacf7ef24fed29f1ee335ebd5","sdd\u002Fskills\u002Fsdd-hermes",1,"https:\u002F\u002Fgithub.com\u002Fe-burgos\u002Fsdd-harness","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-13 23:47:30",{"source":8,"skillName":5,"commands":34,"prompt":44,"zipAvailable":45},[35,38,41],{"tool":36,"command":37},"npx","npx skills add e-burgos\u002Fsdd-harness --skill sdd-hermes",{"tool":39,"command":40},"bunx","bunx skills add e-burgos\u002Fsdd-harness --skill sdd-hermes",{"tool":42,"command":43},"pnpm","pnpm dlx skills add e-burgos\u002Fsdd-harness --skill sdd-hermes","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002Fe-burgos\u002Fsdd-harness\u002Fblob\u002Fmain\u002Fsdd\u002Fskills\u002Fsdd-hermes\u002FSKILL.md",true,[],[48,56,63,70,75,80],{"skillNo":49,"name":50,"nameZh":6,"description":51,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":52,"categories":53,"keywords":54,"publishedAt":55},"01M7BBZKCM7DEC558A5RZ974NF","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\u002Fsdd-harness\u002Fblob\u002Fmain\u002Fsdd\u002Fskills\u002Ftucu-ui-pro\u002FSKILL.md",[],[],"2026-11-15 14:19:17",{"skillNo":57,"name":58,"nameZh":6,"description":59,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":60,"categories":61,"keywords":62,"publishedAt":55},"01M7BBZ522PTJHBT5DZF18P940","nx-migration","Usar al migrar un workspace Nx a una mayor nueva (22 a 23, 23 a 24), actualizar la versión de Nx de un monorepo, resolver errores después de `nx migrate`, o decidir si subir TypeScript 7 — método de un salto de mayor a la vez, registro como fix en el SDD, checklist de verificación por salto, trampas conocidas por versión y el comando `pnpm sdd:nx-migrate`.","https:\u002F\u002Fgithub.com\u002Fe-burgos\u002Fsdd-harness\u002Fblob\u002Fmain\u002Fsdd\u002Fskills\u002Fnx-migration\u002FSKILL.md",[],[],{"skillNo":64,"name":65,"nameZh":6,"description":66,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":67,"categories":68,"keywords":69,"publishedAt":55},"01M7BBYZR3QV90GQ1XYR6CTJWJ","design-languages","Usar al diseñar o rediseñar la UI de un frontend (app, dashboard, landing, auth, storefront) o cuando el pedido nombra un look (\"como Display Ads\", \"liquid glass\", \"cristal líquido\", \"oscuro tipo consola\", \"estilo Apple\") — elegir o derivar un lenguaje visual completo (tokens, tipografía, superficies, escena, componentes firma, motion, accesibilidad), aplicarlo con tucu-ui y verificarlo. Trae dos lenguajes probados en producción listos para replicar.","https:\u002F\u002Fgithub.com\u002Fe-burgos\u002Fsdd-harness\u002Fblob\u002Fmain\u002Fsdd\u002Fskills\u002Fdesign-languages\u002FSKILL.md",[],[],{"skillNo":71,"name":50,"nameZh":6,"description":51,"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":55},"01M7BBYTZQWQ37Y3PD1ND8ZW4C","https:\u002F\u002Fgithub.com\u002Fe-burgos\u002Fsdd-harness\u002Fblob\u002Fmain\u002Fapps\u002Fcli\u002Ftemplates\u002Fsdd\u002Fskills\u002Ftucu-ui-pro\u002FSKILL.md",[],[],{"skillNo":76,"name":58,"nameZh":6,"description":59,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":77,"categories":78,"keywords":79,"publishedAt":55},"01M7BBY8PA7H8W63APVEKZ33KY","https:\u002F\u002Fgithub.com\u002Fe-burgos\u002Fsdd-harness\u002Fblob\u002Fmain\u002Fapps\u002Fcli\u002Ftemplates\u002Fsdd\u002Fskills\u002Fnx-migration\u002FSKILL.md",[],[],{"skillNo":81,"name":65,"nameZh":6,"description":66,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":82,"categories":83,"keywords":84,"publishedAt":55},"01M7BBY3DQERGM7ENJSKP0E8CF","https:\u002F\u002Fgithub.com\u002Fe-burgos\u002Fsdd-harness\u002Fblob\u002Fmain\u002Fapps\u002Fcli\u002Ftemplates\u002Fsdd\u002Fskills\u002Fdesign-languages\u002FSKILL.md",[],[]]