registrar-decision
Registrar una decisión técnica en docs/DECISIONES.md (y si es grande, investigación en docs/investigacion/); las de producto van a QUESTIONS.md. No para diseñar features (design-feature).
SKILL.md.claude/skills/registrar-decision/SKILL.md
GitHubregistrar-decision
Añade una decisión a docs/DECISIONES.md (fuente única de decisiones técnicas y versiones). $ARGUMENTS (opcional): tema de la decisión.
Cuándo usarla
- Se cambia o añade algo técnico: capas, módulos (
app/,motor/), esquema Room, dependencias estructurales, formato de datos, motor de enrutado, mapas, TTS, CI. - Una investigación previa (ROADMAP H0, §8 del prompt) concluye con una recomendación.
design-featureoarchitecture-reviewdetectan una decisión no registrada o contradictoria.
Cuándo NO usarla
- Decisiones de producto (funcionalidad, interfaz, alcance) → no se deciden: van a
QUESTIONS.mdcon contexto, opciones y recomendación, y se sigue con lo que no dependa. - Preferencias del usuario sobre cómo trabajar → usa
recordar. - Diseñar una feature completa → usa
design-feature. Revisar código → usaarchitecture-review. - Cambios sin impacto (bugfix, refactor local) → no hace falta registro.
Precondiciones
- Tema claro en
$ARGUMENTS; si falta, pedirlo y parar. - Haber leído
docs/DECISIONES.mdentero (las secciones fechadas posteriores mandan sobre las anteriores). docs/DECISIONES.mdes reservado del agente principal; un subagente devuelve el texto propuesto.
Pasos
- Buscar duplicados o decisiones afectadas (
Grepdel tema endocs/DECISIONES.md,docs/investigacion/,ROADMAP.md). - Decisión pequeña: añadir una línea en la sección del tema:
- AAAA-MM-DD · tema · decisión · porqué. Si sustituye a otra, indicarlo ("sustituye a § X") en vez de borrar la antigua. - Decisión grande (varias alternativas, licencias, impacto en hitos): crear
docs/investigacion/<tema-kebab>.mddesdedocs/_templates/INVESTIGACION.template.mdcon Contexto, tabla de Alternativas (mínimo 2, con licencia y versión verificada), Recomendación y Consecuencias; endocs/DECISIONES.mdañadir la línea resumen con enlace. - Lo no verificable se marca
VERIFICAR; no inventar versiones ni APIs. Fuentes con URL y fecha. - Si la decisión afecta al producto (lo que ve o hace el usuario, coste, espacio, privacidad), además: entrada en
QUESTIONS.mdy marcar la decisión comopropuestahasta la respuesta. - Enlazar desde los docs afectados no reservados y desde el hito de
ROADMAP.mdque la usa (pedirlo al agente principal si es reservado).
Validaciones / tests
- Cada enlace añadido apunta a un archivo existente:
node scripts/check-docs.mjs. - Ningún
<...>de la plantilla sin rellenar.
Definition of Done
- Línea en
docs/DECISIONES.mdcon fecha, tema, decisión y porqué. - Si es grande:
docs/investigacion/*.mdcompleto y enlazado. - Impacto en producto → entrada en
QUESTIONS.md. -
node scripts/check-docs.mjssin errores nuevos.
Docs a actualizar
docs/DECISIONES.md·docs/investigacion/·ROADMAP.md·QUESTIONS.mdsi aplica · docs/ESTADO.md (skillsession-handoff)