El blueprint

Proceso

Las 32 etapas en una sola espina, en orden del grafo. Cada tarjeta indica qué lee, qué escribe, el agente que la dirige y la condición que decide si se ejecuta.

⓪ Inicialización — preparar workspace y estado
workspace-scaffold
crear directorio de registro de intención
0.1
Salidas
intent record dir
orchestrator
SIEMPRE · auto-continuar (sin puerta)
workspace-detection
detectar tipo de proyecto y tech stack
0.2
Salidas
aidlc-state.md
orchestrator
SIEMPRE · auto-continuar (sin puerta)
state-init
inicializar auditoría y máquina de estado
0.3
Salidas
aidlc-state.mdaudit/ shards
orchestrator
SIEMPRE · auto-continuar (sin puerta)
① Ideación — validar la iniciativa, capturar intención, definir alcance
intent-capture
encuadrar la iniciativa
1.1
Salidas
intent statementstakeholder map
product-agentarchitect (support)
SIEMPRE
market-research
análisis competitivo, construir-vs-comprar
1.2
Salidas
competitive analysisbuild-vs-buy
product-agent
CONDICIONAL — omitir para bugfix, refactor, infra, security-patch
feasibility
restricciones y registro RAID
1.3
Salidas
feasibility assessmentconstraint registerRAID log
architect-agentaws-platform, compliance
CONDICIONAL
scope-definition
definir límites y backlog
1.4
Salidas
scope definitionintent backlog
product-agentdelivery (support)
SIEMPRE
team-formation
composición del equipo y capacidad
1.5
Salidas
team assessmentmob composition plan
delivery-agent
CONDICIONAL — omitir para poc, bugfix, refactor
rough-mockups
wireframes y flujos de usuario
1.6
Salidas
wireframesuser flowsconcept deck
design-agentproduct-lead
CONDICIONAL — omitir si no hay UI
approval-handoff
registro de decisiones y puerta de avance
1.7
Salidas
initiative briefdecision log
delivery-agentproduct (support)
SIEMPRE
▸ Puerta de Verificación: Ideación → Concepción
② Concepción — elaborar requisitos, diseñar arquitectura, planificar entrega
reverse-engineering
analizar el código existente
2.1subagent
Entradas
existing codebase
Salidas
business-overview.mdarchitecture.mdcode-structure.md+6 RE artifacts
developer-agentarchitect (synthesis)
CONDICIONAL — solo brownfield (patrón de dos pasos)
practices-discovery
convenciones y reglas del equipo
2.2
Salidas
team-practices.mddiscovered-rules.mdevidence.md
pipeline-deploy-agentquality, developer, devsecops
CONDICIONAL
requirements-analysis
extraer y estructurar requisitos
2.3
Entradas
RE artifactsintentscope
Salidas
requirements.md
product-agentproduct-lead
SIEMPRE
user-stories
descomponer en historias y personas
2.4
Entradas
requirements.md
Salidas
stories.mdpersonas.md
product-agentproduct-lead
CONDICIONAL — funcionalidades de cara al usuario
refined-mockups
mockups de alta fidelidad y especificación de interacción
2.5
Entradas
stories.mdrequirements.md
Salidas
hi-fi mockupsinteraction spec
design-agentproduct-lead
CONDICIONAL — proyectos con UI
application-design
modelo de dominio, componentes, ADRs
2.6
Entradas
requirements.mdstories.mdmockups
Salidas
app design artifactsADRs
architect-agentarch-reviewer
CONDICIONAL — según plan de ejecución
units-generation
descomponer en unidades de trabajo
2.7
Entradas
app designrequirements
Salidas
unit-of-work.mdunit-of-work-dependency.mdunit-of-work-story-map.md
architect-agentarch-reviewer
SIEMPRE
delivery-planning
plan de bolts, secuenciación, riesgos
2.8
Entradas
unit-of-work.mdunit-of-work-dependency.md
Salidas
bolt-plan.mdteam-allocation.mdrisk-and-sequencing-rationale.mdexternal-dependency-map.md
delivery-agentarchitect (support)
SIEMPRE
▸ Puerta de Verificación: Concepción → Construcción
③ Construcción — diseñar, implementar y probar (Bolt por Bolt, por unidad)
functional-design
lógica, entidades, reglas de negocio
3.1
Entradas
unit-of-work.mdrequirements.mdapp design
Salidas
business-logic-model.mdbusiness-rules.mddomain-entities.md
architect-agentarch-reviewer
Por Bolt · CONDICIONAL · para cada: unidad de trabajo
nfr-requirements
seguridad, rendimiento, confiabilidad
3.2
Entradas
functional-designrequirements (NFR)
Salidas
NFR specifications
architect-agentdevsecops, compliance, quality
Por Bolt · CONDICIONAL
nfr-design
metas de calidad, patrones, trade-offs
3.3
Entradas
NFR requirements
Salidas
NFR design specifications
architect-agentaws-platform (support)
Por Bolt · CONDICIONAL
infrastructure-design
servicios, IaC, topología de deploy
3.4
Entradas
NFR designfunctional-design
Salidas
infrastructure specsIaC designs
aws-platform-agentdevsecops, compliance
Por Bolt · CONDICIONAL
code-generation
escribir · probar · verificar
3.5subagent
Entradas
functional / NFR / infra specsunit-of-workstories
Salidas
source codetestsconfigimplementation-map.md
developer-agentarch-reviewer
Por Bolt · SIEMPRE · para cada: unidad de trabajo

BOLT POR BOLT Construcción se ejecuta por unidad de trabajo

Después de que delivery-planning produce el bolt-plan.md, las etapas 3.1–3.5 se ejecutan como Bolts. El Bolt 1 es el esqueleto funcional (siempre con puerta). Luego el prompt de escalera se dispara una vez: continuar de forma autónoma o poner puerta a cada Bolt. Los Bolts independientes corren en lotes paralelos. Las etapas 3.6–3.7 se ejecutan una vez al final sobre todas las unidades.

build-and-test
ejecutar suite completa de pruebas y reporte de calidad
3.6
Entradas
todo el código generado
Salidas
test resultsquality report
quality-agentdevsecops (support)
SIEMPRE — una vez al final de todos los Bolts
ci-pipeline
configuración de CI y puertas de calidad
3.7
Entradas
code artifactstest results
Salidas
CI configquality gates
pipeline-deploy-agent
CONDICIONAL — una vez al final
▸ Puerta de Verificación: Construcción → Operación

REVISIÓN ADVERSARIAL Los revisores son verificadores (v2.4)

Todo revisor declarado opera bajo un contrato adversarialexplícito: su trabajo es refutar el artefacto, no confirmarlo. Los hallazgos deben basarse en evidencia verificable por máquina (herramientas de validación, pruebas, criterios de aceptación). Un PreToolUse hook impone límites de alcance de lectura por unidad de forma determinística — los revisores no pueden acceder a las rutas de construcción de unidades hermanas.

NIVELES DE AGENTES Modelo de delegación por niveles (v2.3)

Los agentes declaran un tier: en lugar de IDs de modelo fijos. Judgment (9 agentes: architect, aws-platform, compliance, composer, design, developer, devsecops, product, quality) — hereda el modelo de la sesión. Balanced (2 revisores: product-lead, architecture-reviewer) — clase Sonnet. Templated (3 planificadores: delivery, pipeline-deploy, operations) — Sonnet + esfuerzo reducido. Los equipos pueden limitar niveles vía tier_cap: en el frontmatter de memory.

MECANISMO DE PLUGINS Grafo de etapas extensible (v2.3)

Los plugins agregan etapas, alcances, agentes y conocimiento desde plugins/<name>/. Un hook de composición fusiona el plugin en una instalación — nuevas etapas se unen al grafo, las contribuciones extienden etapas existentes de forma aditiva. select-plugins controla qué plugins están activos. Core es el plugin aidlc implícito y puede deseleccionarse para instalaciones de solo plugins.

④ Operación — desplegar, observar, optimizar y retroalimentar
deployment-pipeline
estrategia de CD y runbook de rollback
4.1
Salidas
CD configdeployment strategyrollback runbook
pipeline-deploy-agent
CONDICIONAL — todas las etapas de Operación se omiten para mvp, poc, bugfix, refactor
environment-provisioning
aprovisionar y validar entornos
4.2
Salidas
environment inventoryvalidation report
aws-platform-agentdevsecops, compliance
CONDICIONAL
deployment-execution
deploy, prueba de humo, chequeo de salud
4.3
Salidas
deployment logsmoke testshealth checks
pipeline-deploy-agentdeveloper (support)
CONDICIONAL
observability-setup
dashboards, alarmas, SLOs
4.4
Salidas
dashboardsalarmsSLO config
operations-agent
CONDICIONAL
incident-response
runbooks y matriz de escalamiento
4.5
Salidas
SSM runbooksincident planescalation matrix
operations-agent
CONDICIONAL
performance-validation
pruebas de carga y validación de NFRs
4.6
Salidas
load test resultsNFR validation matrix
quality-agent
CONDICIONAL
feedback-optimization
reporte de SLO, análisis de costos, ciclo de retorno
4.7
Salidas
SLO reportcost analysisfeedback loop doc
operations-agentaws-platform (support)
CONDICIONAL — etapa terminal (o retorna a 1.1)