ADR-009 — Specification-Driven AI Software Development Lifecycle (AI-SDLC)

Architecture decision record — status: Accepted (seed).

Source: docs/adr/ADR-009-ai-sdlc-hybrid.md

ADR-009: Specification-Driven AI Software Development Lifecycle (AI-SDLC)

Estado

Accepted (seed)

Contexto

Los proyectos impulsados por agentes necesitan un proceso explícito para decidir qué especificar y con qué herramienta, evitando código sin acuerdo humano y sin perder velocidad en cambios pequeños.

Decisión

Adoptar un AI-SDLC híbrido:

  1. GitHub Spec Kit (specs/) — nivel estratégico.
  2. OpenSpec (openspec/) — nivel operativo.
  3. sd-discover (/sd-*) — discovery de producto antes de especificar dominio.
  4. Constitution (.specify/memory/constitution.md) — principios no negociables.
  5. Memoria de sesión (memory/) — continuidad táctica entre chats.

La matriz y el algoritmo de decisión viven en DOC-013.

Consecuencias

  • Todo feature de dominio pasa por brief aprobado (DOC-012) salvo excepción infra/DX.
  • Epics grandes se descomponen en slices OpenSpec trazables al plan.md padre.
  • Los agentes deben leer constitution + DOC-013 antes de implementar.
  • Principios de arquitectura/código stack-agnósticos: DOC-010 + ADR-010…015 (enmendables; stack = ADR posterior).
  • El stack y dominio concretos se fijan en ADRs posteriores y en la constitution.