Azure Architecture Builder

Um pipeline que projeta a infraestrutura do Azure usando linguagem natural, ou analisa recursos existentes para visualizar a arquitetura e prosseguir com a modificação e implantação.

O motor de diagramas está embutido na skill (pasta scripts/). Não é necessário pip install — ele usa diretamente os scripts Python empacotados para gerar diagramas interativos em HTML com mais de 605 ícones oficiais do Azure. Pronto para usar imediatamente sem acesso à rede ou instalação de pacotes.

Detecção Automática de Linguagem do Usuário

🚨 Detecte o idioma da primeira mensagem do usuário e forneça todas as respostas subsequentes nesse idioma. Este é o princípio de maior prioridade.

• Se o usuário escrever em coreano → responda em coreano
• Se o usuário escrever em inglês → responda em inglês (perguntas ao usuário, atualizações de progresso, relatórios, comentários do Bicep — tudo em inglês)
• As instruções e exemplos neste documento estão escritos em inglês, e toda a saída voltada para o usuário deve corresponder ao idioma do usuário

⚠️ Não copie exemplos deste documento literalmente para o usuário. Use apenas a estrutura como referência e adapte o texto ao idioma do usuário.

Guia de Uso da Ferramenta (Ambiente GHCP)

Todos os sub-agentes (explorar/tarefa/uso geral) não podem usar web_fetch ou web_search. A verificação de fatos que requer consultas ao MS Docs deve ser realizada diretamente pelo agente principal.

Descoberta de Caminho de Ferramentas Externas

az, python, bicep, etc., geralmente não estão no PATH. Descubra uma vez antes de iniciar uma Fase e armazene o resultado em cache. Não redescubra a cada vez.

⚠️ Não use Get-Command python — risco de alias da Windows Store. A descoberta direta do sistema de arquivos ($env:LOCALAPPDATA\Programs\Python) tem prioridade.

Caminho do az CLI:

$azCmd = $null
if (Get-Command az -ErrorAction SilentlyContinue) { $azCmd = 'az' }
if (-not $azCmd) {
  $azExe = Get-ChildItem -Path "$env:ProgramFiles\Microsoft SDKs\Azure\CLI2\wbin", "$env:LOCALAPPDATA\Programs\Azure CLI\wbin" -Filter "az.cmd" -ErrorAction SilentlyContinue | Select-Object -First 1 -ExpandProperty FullName
  if ($azExe) { $azCmd = $azExe }
}

Caminho do Python + motor de diagramas embutido: consulte a seção de geração de diagramas em references/phase1-advisor.md.

Atualizações de Progresso Necessárias

Use o formato de bloco de citação + emoji + negrito:

> **⏳ [Action]** — [Reason]
> **✅ [Complete]** — [Result]
> **⚠️ [Warning]** — [Details]
> **❌ [Failed]** — [Cause]

Princípio de Pré-carga Paralela

Enquanto aguarda a entrada do usuário via ask_user, pré-carregue as informações necessárias para a próxima etapa em paralelo.

Ramificação de Caminho — Determinada Automaticamente pela Solicitação do Usuário

Caminho A: Novo Design (Nova Construção)

Gatilho: "criar", "configurar", "implantar", "construir", etc.

Phase 1 (references/phase1-advisor.md) — Interactive architecture design + diagram
    ↓
Phase 2 (references/bicep-generator.md) — Bicep code generation
    ↓
Phase 3 (references/bicep-reviewer.md) — Code review + compilation verification
    ↓
Phase 4 (references/phase4-deployer.md) — validate → what-if → deploy

Caminho B: Análise e Modificação Existentes (Analisar e Modificar)

Gatilho: "analisar", "recursos atuais", "escanear", "desenhar um diagrama", "mostrar minha infraestrutura", etc.

Phase 0 (references/phase0-scanner.md) — Existing resource scan + diagram
    ↓
Modification conversation — "What would you like to change here?" (natural language modification request → follow-up questions)
    ↓
Phase 1 (references/phase1-advisor.md) — Confirm modifications + update diagram
    ↓
Phase 2~4 — Same as above

Quando a Determinação do Caminho é Ambígua

Pergunte diretamente ao usuário:

ask_user({
  question: "What would you like to do?",
  choices: [
    "Design a new Azure architecture (Recommended)",
    "Analyze + modify existing Azure resources"
  ]
})

…