AutanaSoft SDD Lifecycle

Prácticas de lifecycle para artefactos Spec-Driven Development en proyectos AutanaSoft.

Principio rector: esta skill define reglas reutilizables para mantener los artefactos SDD como fuente de verdad, evitar regeneración destructiva y asegurar que implementación/verificación no deje deuda obsoleta.

Cuándo Usarla

Usa esta skill cuando trabajes con artefactos SDD en docs/sdd/**, especialmente para:

• Crear o actualizar PRDs, specs, designs, tasks, apply-progress o verify reports.
• Re-ejecutar una fase SDD cuando ya existen artefactos.
• Decidir si crear un artefacto nuevo o actualizar incrementalmente uno existente.
• Gestionar status, versión, frontmatter y changelogs de artefactos.
• Reiniciar un ciclo SDD de componente/página por aprendizaje o cleanup de lifecycle.
• Implementar cambios desde SDD tasks y reemplazar paths de código existentes.
• Verificar trabajo completado contra specs, tasks y expectativas de cleanup.
• Archivar un cambio SDD completo o sincronizar deltas hacia documentos baseline.

Referencia Rápida

• references/lifecycle-living-artifacts.md: tratar artefactos existentes como documentos vivos; actualizar sin regeneración ciega.
• references/lifecycle-versioning-status.md: statuses, versionado, frontmatter y changelogs.
• references/phase-approval-and-evidence.md: approval gates, guía de fases y evidencia TDD.
• references/apply-cleanup-replaced-code.md: remover código obsoleto cuando la implementación reemplaza comportamiento existente.
• references/language-and-validation.md: política de idioma y comandos de validación.

Categorías Por Prioridad

Prioridad	Categoría	Impacto	Prefijo
1	Lifecycle	HIGH	lifecycle-
2	Phase Gates	HIGH	phase-
3	Apply Discipline	HIGH	apply-
4	Validation	MEDIUM	language-

Estructura De La Skill

• references/ - Reglas fuente modulares, una regla por archivo.
• references/_sections.md - Orden de secciones, impacto y prefijos de archivo.
• references/_template.md - Plantilla para reglas nuevas.

Cómo Usarla

Lee la regla individual antes de aplicar una convención. Si una regla pertenece a TypeScript, Next.js, NestJS o Drizzle, muévela a la skill correspondiente en lugar de duplicarla aquí.

Regla Crítica Transversal

Cuando un cambio SDD reemplaza comportamiento, UI, data flow o componentes existentes, la implementación debe reemplazar y limpiar, no solo agregar. El código reemplazado debe removerse, no ocultarse.

Detalle: references/apply-cleanup-replaced-code.md.

Recursos

• Índice de reglas: ver references/agent-context.md.