specatlas 0.1.28 → 0.1.30

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "specatlas",
-  "version": "0.1.28",
+  "version": "0.1.30",
   "description": "SpecAtlas: kernel determinista de Spec-Driven Development (CLI)",
   "license": "MIT",
   "type": "module",
@@ -40,7 +40,7 @@
   },
   "devDependencies": {
     "@specatlas/adapters": "0.1.1",
-    "@specatlas/core": "0.1.25"
+    "@specatlas/core": "0.1.27"
   },
   "scripts": {
     "typecheck": "tsc --noEmit",

package/workflow/phases/clarify.md

@@ -0,0 +1,39 @@
+---
+id: clarify
+title: Aclarar
+description: >-
+  Resuelve supuestos, dependencias y preguntas abiertas de un cambio ya especificado
+  antes de aprobar y planificar. Usar cuando el usuario pide aclarar, resolver dudas
+  o cerrar preguntas abiertas de una especificación.
+requires: []
+produces:
+  - changes/<slug>/clarify.md
+arguments: true
+agent:
+  mode: primary
+---
+
+# Fase: Aclarar (vaciar las preguntas abiertas)
+
+## Objetivo
+
+Resolver los supuestos, dependencias y preguntas abiertas del cambio `{{SLUG}}` y dejarlos registrados en `.sdd/changes/{{SLUG}}/clarify.md`.
+El contenido se escribe en **{{LANGUAGE_NAME}}**.
+
+## Pasos
+
+1. Lee `.sdd/changes/{{SLUG}}/spec.md`, `proposal.md` y, si existe, `clarify.md`.
+2. Detecta supuestos, dependencias y preguntas abiertas **reales** de la especificación; no inventes preguntas.
+3. Pregunta una a una (máximo 5, las que más cambien el resultado), con opciones concretas cuando ayuden a decidir. No des nada por respondido sin respuesta del humano.
+4. Escribe o actualiza `clarify.md` con la gramática canónica:
+   - `- [ ] pregunta` para lo que sigue abierto.
+   - `- [x] pregunta — respuesta` para lo aclarado.
+5. Refleja el resumen de lo decidido en la propuesta (`proposal.md`), en su sección correspondiente.
+6. Si una respuesta cambia lo especificado: corrige `spec.md` y avisa de que la firma quedó obsoleta (hay que volver a aprobar con `satlas approve`).
+7. Cierra con `satlas clarify {{SLUG}}` (estado de la aclaración) y `satlas next {{SLUG}}`.
+
+## Prohibido
+
+- Inventar preguntas o respuestas.
+- Cambiar la especificación sin avisar de la re-firma.
+- Marcar como aclarada una pregunta que el humano no respondió.

package/workflow/phases/docs.md

@@ -0,0 +1,36 @@
+---
+id: docs
+title: Documentar
+description: >-
+  Genera la documentación técnica y manual del cambio (carril completo) desde la
+  evidencia registrada. Usar cuando el usuario pide documentar, generar el manual
+  o cerrar la documentación antes de archivar.
+requires: []
+produces:
+  - changes/<slug>/docs/tecnica.md
+  - changes/<slug>/docs/manual.md
+arguments: true
+agent:
+  mode: primary
+---
+
+# Fase: Documentar (técnica y manual del cambio)
+
+## Objetivo
+
+Dejar la documentación técnica y manual del cambio `{{SLUG}}` en `.sdd/changes/{{SLUG}}/docs/`, construida desde lo real (especificación, tareas y evidencia).
+El contenido se escribe en **{{LANGUAGE_NAME}}**.
+
+## Pasos
+
+1. Ejecuta `satlas docs {{SLUG}}` para generar el esqueleto de los dos documentos desde las plantillas y la evidencia.
+2. Revisa lo generado: si un dato falta o es incorrecto, corrige **la fuente** (spec, tareas o evidencia) y vuelve a ejecutar el comando; no retoques los datos generados.
+3. Completa lo que no se puede generar — decisiones, límites, ejemplos de uso y notas — **fuera del bloque gestionado** (lo que está entre los marcadores se reemplaza al regenerar; lo de fuera se conserva).
+4. Señala expresamente lo que quedó sin evidencia; nunca lo presentes como hecho.
+5. Cierra con `satlas docs {{SLUG}}` (regenera el bloque gestionado) y `satlas next {{SLUG}}`.
+
+## Prohibido
+
+- Documentar como hecho algo sin evidencia.
+- Escribir dentro del bloque gestionado (se reemplaza al regenerar).
+- Tocar la especificación, el plan o las tareas desde esta fase.