O blueprint

Processo

Todos os 32 estágios em uma única espinha, na ordem do grafo. Cada cartão indica o que ele lê, o que escreve, o agente que o conduz e a condição que decide se ele executa.

⓪ Inicialização — inicializar workspace e estado
workspace-scaffold
criar diretório de registro de intenção
0.1
Saídas
intent record dir
orchestrator
SEMPRE · auto-prosseguir (sem portão)
workspace-detection
detectar tipo de projeto e tech stack
0.2
Saídas
aidlc-state.md
orchestrator
SEMPRE · auto-prosseguir (sem portão)
state-init
inicializar auditoria e máquina de estado
0.3
Saídas
aidlc-state.mdaudit/ shards
orchestrator
SEMPRE · auto-prosseguir (sem portão)
① Ideação — validar iniciativa, capturar intenção, definir escopo
intent-capture
enquadrar a iniciativa
1.1
Saídas
intent statementstakeholder map
product-agentarchitect (support)
SEMPRE
market-research
análise competitiva, construir-vs-comprar
1.2
Saídas
competitive analysisbuild-vs-buy
product-agent
CONDICIONAL — pular para bugfix, refactor, infra, security-patch
feasibility
restrições e registro RAID
1.3
Saídas
feasibility assessmentconstraint registerRAID log
architect-agentaws-platform, compliance
CONDICIONAL
scope-definition
definir limites e backlog
1.4
Saídas
scope definitionintent backlog
product-agentdelivery (support)
SEMPRE
team-formation
composição do time e capacidade
1.5
Saídas
team assessmentmob composition plan
delivery-agent
CONDICIONAL — pular para poc, bugfix, refactor
rough-mockups
wireframes e fluxos de usuário
1.6
Saídas
wireframesuser flowsconcept deck
design-agentproduct-lead
CONDICIONAL — pular se não há UI
approval-handoff
registro de decisões e portão de avanço
1.7
Saídas
initiative briefdecision log
delivery-agentproduct (support)
SEMPRE
▸ Portão de Verificação: Ideação → Inception
② Concepção — elaborar requisitos, projetar arquitetura, planejar entrega
reverse-engineering
analisar codebase existente
2.1subagent
Entradas
existing codebase
Saídas
business-overview.mdarchitecture.mdcode-structure.md+6 RE artifacts
developer-agentarchitect (synthesis)
CONDICIONAL — somente brownfield (padrão dois passos)
practices-discovery
convenções e regras do time
2.2
Saídas
team-practices.mddiscovered-rules.mdevidence.md
pipeline-deploy-agentquality, developer, devsecops
CONDICIONAL
requirements-analysis
extrair e estruturar requisitos
2.3
Entradas
RE artifactsintentscope
Saídas
requirements.md
product-agentproduct-lead
SEMPRE
user-stories
decompor em histórias e personas
2.4
Entradas
requirements.md
Saídas
stories.mdpersonas.md
product-agentproduct-lead
CONDICIONAL — funcionalidades voltadas ao usuário
refined-mockups
mockups de alta fidelidade e spec de interação
2.5
Entradas
stories.mdrequirements.md
Saídas
hi-fi mockupsinteraction spec
design-agentproduct-lead
CONDICIONAL — projetos com UI
application-design
modelo de domínio, componentes, ADRs
2.6
Entradas
requirements.mdstories.mdmockups
Saídas
app design artifactsADRs
architect-agentarch-reviewer
CONDICIONAL — conforme plano de execução
units-generation
decompor em unidades de trabalho
2.7
Entradas
app designrequirements
Saídas
unit-of-work.mdunit-of-work-dependency.mdunit-of-work-story-map.md
architect-agentarch-reviewer
SEMPRE
delivery-planning
plano de bolts, sequenciamento, riscos
2.8
Entradas
unit-of-work.mdunit-of-work-dependency.md
Saídas
bolt-plan.mdteam-allocation.mdrisk-and-sequencing-rationale.mdexternal-dependency-map.md
delivery-agentarchitect (support)
SEMPRE
▸ Portão de Verificação: Concepção → Construction
③ Construção — projetar, implementar e testar (Bolt por Bolt, por unidade)
functional-design
lógica, entidades, regras de negócio
3.1
Entradas
unit-of-work.mdrequirements.mdapp design
Saídas
business-logic-model.mdbusiness-rules.mddomain-entities.md
architect-agentarch-reviewer
Por Bolt · CONDICIONAL · para cada: unidade de trabalho
nfr-requirements
segurança, performance, confiabilidade
3.2
Entradas
functional-designrequirements (NFR)
Saídas
NFR specifications
architect-agentdevsecops, compliance, quality
Por Bolt · CONDICIONAL
nfr-design
metas de qualidade, padrões, trade-offs
3.3
Entradas
NFR requirements
Saídas
NFR design specifications
architect-agentaws-platform (support)
Por Bolt · CONDICIONAL
infrastructure-design
serviços, IaC, topologia de deploy
3.4
Entradas
NFR designfunctional-design
Saídas
infrastructure specsIaC designs
aws-platform-agentdevsecops, compliance
Por Bolt · CONDICIONAL
code-generation
escrever · testar · verificar
3.5subagent
Entradas
functional / NFR / infra specsunit-of-workstories
Saídas
source codetestsconfigimplementation-map.md
developer-agentarch-reviewer
Por Bolt · SEMPRE · para cada: unidade de trabalho

BOLT POR BOLT Construção executa por unidade de trabalho

Após delivery-planning produz o bolt-plan.md, estágios 3.1–3.5 executam como Bolts. Bolt 1 é o esqueleto funcional (sempre com portão). Então o prompt escalada dispara uma vez: continuar autonomamente ou colocar portão em cada Bolt. Bolts independentes executam em lotes paralelos. Estágios 3.6–3.7 executam uma vez ao final para todas as unidades.

build-and-test
executar suite de testes e relatório de qualidade
3.6
Entradas
todo o código gerado
Saídas
test resultsquality report
quality-agentdevsecops (support)
SEMPRE — uma vez ao final de todos os Bolts
ci-pipeline
configuração CI e portões de qualidade
3.7
Entradas
code artifactstest results
Saídas
CI configquality gates
pipeline-deploy-agent
CONDICIONAL — uma vez ao final
▸ Portão de Verificação: Construção → Operação

REVISÃO ADVERSARIAL Revisores são verificadores (v2.4)

Todo revisor declarado opera sob um contrato adversarialexplícito: seu trabalho é refutar o artefato, não confirmá-lo. Achados devem se basear em evidências verificáveis por máquina (ferramentas de validação, testes, critérios de aceitação). Um PreToolUse hook impõe limites de escopo de leitura por unidade deterministicamente — revisores não podem acessar unidades irmãs' caminhos de construção.

CAMADAS DE AGENTES Modelo de delegação em camadas (v2.3)

Agentes declaram uma tier: em vez de modelo fixo. Judgment (9 agents: architect, aws-platform, compliance, composer, design, developer, devsecops, product, quality) — herda modelo da sessão. Balanced (2 reviewers: product-lead, architecture-reviewer) — classe Sonnet. Templated (3 planners: delivery, pipeline-deploy, operations) — Sonnet + esforço reduzido. Times podem limitar camadas via tier_cap: no frontmatter de memory.

MECANISMO DE PLUGINS Grafo de estágios extensível (v2.3)

Plugins adicionam estágios, escopos, agentes e conhecimento a partir de plugins/<name>/. Um hook de composição mescla o plugin na instalação — novos estágios entram no grafo, contribuições estendem estágios existentes aditivamente. select-plugins controla quais plugins estão ativos. Core é o aidlc plugin implícito e pode ser desabilitado para instalações somente-plugin.

④ Operação — implantar, observar, otimizar e feedback
deployment-pipeline
estratégia CD e runbook de rollback
4.1
Saídas
CD configdeployment strategyrollback runbook
pipeline-deploy-agent
CONDICIONAL — todos estágios de Operação pulam para mvp, poc, bugfix, refactor
environment-provisioning
provisionar e validar ambientes
4.2
Saídas
environment inventoryvalidation report
aws-platform-agentdevsecops, compliance
CONDICIONAL
deployment-execution
deploy, teste de fumaça, health check
4.3
Saídas
deployment logsmoke testshealth checks
pipeline-deploy-agentdeveloper (support)
CONDICIONAL
observability-setup
dashboards, alarmes, SLOs
4.4
Saídas
dashboardsalarmsSLO config
operations-agent
CONDICIONAL
incident-response
runbooks e matriz de escalação
4.5
Saídas
SSM runbooksincident planescalation matrix
operations-agent
CONDICIONAL
performance-validation
testes de carga e validação de NFRs
4.6
Saídas
load test resultsNFR validation matrix
quality-agent
CONDICIONAL
feedback-optimization
relatório SLO, análise de custo, loop de feedback
4.7
Saídas
SLO reportcost analysisfeedback loop doc
operations-agentaws-platform (support)
CONDICIONAL — estágio terminal (ou retorna a 1.1)