Spec-Driven Development Framework
Framework for AI-assisted spec-driven delivery: templates, session management, and architecture validation.
Role
Creator CreadorProblem
AI-generated code drifts from architecture without explicit specs and guardrails. El código generado por IA se desalinea de la arquitectura sin specs explícitas y guardrails.Impact
Repeatable spec templates and validation scripts — tighter human–AI loop for backend changes. Plantillas de specs y scripts de validación repetibles — ciclo humano–IA más controlado en backend.Technical stack
Layer-by-layer breakdown of subsystems, repositories, and production concerns.
Spec templates & conventions Plantillas de specs y convenciones
Markdown templates for features, ADRs, and change proposals — structured sections agents and humans follow. Plantillas Markdown para features, ADRs y propuestas de cambio — secciones estructuradas para agentes y humanos.
- Consistent spec shape across repositories Forma de spec consistente entre repositorios
Architecture validation scripts Scripts de validación de arquitectura
Shell/Node checks enforce folder boundaries, forbidden imports, and module dependency rules before merge. Checks shell/Node aplican límites de carpetas, imports prohibidos y reglas de dependencia antes del merge.
- Catch architectural drift early Detectar desviación arquitectónica temprano
AI-assisted delivery loop Ciclo de entrega asistido por IA
Session prompts and guardrails so generated code stays aligned with approved specs and hexagonal boundaries. Prompts de sesión y guardrails para que código generado se alinee con specs aprobados y límites hexagonales.
- Tighter human–AI collaboration on backend changes Colaboración humano–IA más controlada en backend
Repository integration Integración en repositorio
Drop-in `.spec/` or docs layout compatible with NestJS monorepos and PR review workflows. Layout `.spec/` o docs integrable con monorepos NestJS y flujos de revisión en PR.
- Repeatable across greenfield and legacy services Repetible en servicios greenfield y legacy
Related topics
Explore curated hubs that connect this work with case studies, articles, and learning repos.