| name | initialize-architecture |
| description | Prepara com segurança um repositório central Architecture Graph, registra aplicações somente como fontes analisadas e reconhece workspace ausente, válido, parcial, legado ou conflitante. Use quando o usuário pedir para iniciar, configurar ou preparar governança arquitetural antes de usar Tech Radar, ADRs e guidelines. |
Initialize Architecture
Criar a fonte central sem escrever nos repositórios analisados. Ler
references/location-policy.md antes de qualquer inicialização.
Fluxo
- Identificar o diretório central pretendido e os repositórios a analisar.
- Confirmar explicitamente o local da primeira escrita em uso real.
- Executar internamente
classify-workspace.mjs.
- Para
valid, reutilizar o workspace e apenas propor registros ausentes.
- Para
absent, executar initialize-workspace.mjs após confirmação.
- Para
partial, legacy ou conflict, interromper e apresentar diagnóstico;
nunca sobrescrever, migrar ou apagar automaticamente.
- Validar
architecture.yaml, diretórios e configuração do Radar.
- Informar que a inicialização terminou, entregar o caminho central e resumir os
repositórios registrados como fontes somente leitura.
- Explicar o próximo passo: analisar o código, consolidar os blips e preparar
recomendações da LLM sem preencher anéis oficiais.
- Pedir confirmação explícita para executar essa análise e interromper o turno.
- Somente após a confirmação, encaminhar para
govern-architecture.
Guardas
- Nunca usar o diretório do plugin ou laboratório como destino de resultados.
- Nunca usar um repositório analisado como repositório central sem pedido explícito.
- Não modificar arquivos dos repositórios registrados.
- Não aceitar links simbólicos no destino.
- Não sobrescrever arquivo existente.
- Em bootcamp, ensaio ou teste, usar diretório temporário fora do Git.
Executar scripts internamente. O participante opera por prompts, não por comandos.
Confirmações de infraestrutura do host não substituem os checkpoints semânticos
apresentados ao participante.
