to-spec
Installation
SKILL.md
To Spec — de conversación a spec
Toma el contexto de la conversación actual y el conocimiento del codebase y produce una spec. NO entrevistes al usuario — sintetiza lo que ya sabes.
Proceso
-
Explora el repo para entender el estado actual del código, si no lo has hecho ya. Usa el vocabulario del glosario del proyecto (lenguaje ubicuo) en toda la spec, y respeta los ADRs de la zona que toques.
-
Esboza las costuras de testeo (seams) donde vas a testear la feature:
- Prefiere costuras existentes a nuevas.
- Usa la costura más alta posible.
- Si hacen falta costuras nuevas, propónlas en el punto más alto que puedas.
- Cuantas menos costuras en el codebase, mejor — el número ideal es una.
- Confirma con el usuario que estas costuras coinciden con sus expectativas.
-
Escribe la spec con la plantilla de abajo y guárdala en
docs/specs/<YYYY-MM-DD>-<slug>.md(o.hermes/plans/si no hay docs/). Si el usuario lo pide, publícala también como issue de GitHub (etiquetaready-for-agent, sin necesidad de triage adicional).