Diseño: $ARGUMENTS
Sigue todos los pasos de docs/design-process.md — ese archivo es la regla; este skill solo ordena el trabajo. Si hay conflicto, prioriza ese archivo.
- ¿Es necesario diseñar? — compara con la tabla del punto 1 de
docs/design-process.md- No necesario: indica la razón en una línea y vuelve a
new-feature - No estoy seguro: pregunta primero al usuario
- No necesario: indica la razón en una línea y vuelve a
- Inicio (punto 3.0): crea un issue épico (etiqueta
design), una ramadocs/<id>-design-<slug>, copiadocs/design/template.md→docs/design/<slug>.md(system.mdo<id-épico>-<slug>.md), establecestatus: drafty agrega una fila endocs/design/README.md - Lee antes de preguntar:
CONTEXT.md,docs/adr/,docs/architecture.md, otros diseños endocs/design/— busca hechos que puedas encontrar por ti mismo, no preguntes - Entrevista por rondas (punto 3.1) con el formato
Qn — Tema: Pregunta+Sugerencia: …en cada punto, 1–2 casos límite por ronda — recorre las ramas A–H (punto 3.2) por completo y espera al usuario en los puntos de aprobación 1, 2 (system), 3 - Escribe en el archivo después de cada ronda: secciones en el archivo de diseño, términos nuevos en
CONTEXT.md, ADRproposedendocs/adr/(+ índice), diagramas C4 endocs/architecture.mdsi cambian contenedores o sistemas externos - Revisa (punto 3.3):
make docs-checkdebe pasar (en repos que aún no tengan este target en el Makefile:python3 <ruta-de-web-template>/scripts/check-docs.py <repo>— equipo Hermes:/home/opc/projects/web-template) + lista de verificación manual, luego establecestatus: proposed - PR solo de documentación:
docs(design): <slug>, cuerpo conRefs #<épico>, resumen de alternativas aún abiertas y sección## CHANGELOGcon-— sin código, sin merge - Aprobación (punto 3.4): cuando el usuario apruebe, haz commit con
status: approved+approved-by+ cambia el ADR aaccepteden el mismo PR (make docs-checkdebe pasar), luego deja que el usuario haga merge - Después del merge (punto 3.5): abre issues secundarios según el punto 13, uno por uno, cada uno enlazando el épico y el archivo de diseño — el trabajo de código comienza con
new-feature