@brunosps00/dev-workflow 1.0.2 → 1.0.5

package/scaffold/en/commands/dw-subtask-complete.md

@@ -0,0 +1,40 @@
+<system_instructions>
+You record a structured subagent handoff.
+
+## When to Use
+- Use inside the child/subagent session when the assigned subtask is complete, blocked, or out of budget.
+
+## Required Handoff Shape
+
+```markdown
+## Objective
+
+## Result
+
+## Files Read
+
+## Files Changed
+
+## Decisions
+
+## Risks
+
+## Verification
+
+## Next Steps
+
+## Blocked Or Not Done
+```
+
+## Process
+1. Write the handoff to a local markdown file.
+2. Run:
+
+```bash
+npx @brunosps00/dev-workflow subtask complete --slug=<slug> --file=<handoff.md>
+```
+
+Return summarized evidence only. Do not include full logs or transcript dumps.
+
+Final marker: `## SUBTASK HANDOFF RECORDED`
+</system_instructions>

package/scaffold/en/commands/dw-subtask-resume.md

@@ -0,0 +1,21 @@
+<system_instructions>
+You consume completed subagent handoffs for the parent session.
+
+## When to Use
+- Use after one or more child sessions have recorded `.dw/subtasks/pending/*/HANDOFF.md`.
+- Use before synthesizing final parent decisions from delegated work.
+
+## Process
+1. Run:
+
+```bash
+npx @brunosps00/dev-workflow subtask consume
+```
+
+2. Read the printed summary and, only when durable learning exists, promote it manually into `.dw/STATE.md`, `.dw/rules/`, `.dw/intel/`, a bugfix summary, or a spec artifact.
+3. Continue the parent workstream from the summarized return packets.
+
+Do not paste child transcripts into the parent context. The parent remains the only final synthesizer.
+
+Final marker: `## SUBTASKS RESUMED`
+</system_instructions>

package/scaffold/en/commands/dw-subtask-start.md

@@ -0,0 +1,22 @@
+<system_instructions>
+You create minimal subagent input packets.
+
+## When to Use
+- Use when a read-only, QA, review, or build-fix subtask can run separately from the parent context.
+- Use when output would be verbose: logs, broad grep, test evidence, browser QA, security review.
+
+## Process
+1. Pick the most specific installed agent from `.agents/agents/README.md` or `scaffold/agent-registry.json`.
+2. Write a narrow goal, allowed files/sources, constraints, expected output, context budget, and stop condition.
+3. Run:
+
+```bash
+npx @brunosps00/dev-workflow subtask create --agent=<name> --goal="<goal>"
+```
+
+4. Fill any missing boundaries in the generated `.dw/subtasks/pending/<slug>/TASK.md` before dispatching.
+
+Never paste the full parent transcript into the task packet.
+
+Final marker: `## SUBTASK PACKET READY`
+</system_instructions>

package/scaffold/pt-br/agent-instructions.md

@@ -50,6 +50,9 @@ Antes de escolher um comando da Trigger Map, dimensione o escopo real da mudanç
 | "Brainstorm X" / "Explora ideias" / "Research X" / "Auditoria de saúde do código" / "Tech debt" | `/dw-brainstorm "X"` (auto-dispatch dos modos grill / prototype / council / research / refactor-audit / onepager conforme os sinais) |
 | "Onde está X?" / "O que usa Y?" / "Como Z é estruturado?" | `/dw-intel "<pergunta>"` |
 | "Reconstrói o índice" / "Refresh do intel" | `/dw-intel --build` |
+| "Contexto pesado" / "Audita uso de tokens" / "Por que o agente está lento?" | `/dw-context-budget` |
+| "Checa instalação dev-workflow" / "Agentes/wrappers estão saudáveis?" | `/dw-harness-audit` |
+| "Audita skills" / "Skills parecem duplicadas ou pesadas" | `/dw-skill-health` |
 | "Redesign dessa UI" / "Audita e entrega novo design" | `/dw-redesign-ui "<target>"` |
 | "Audita dependências" / "Estamos atrasados em pacotes?" | `/dw-secure-audit --plan` |
 | "Scan de vulnerabilidades" / "Check de segurança" | `/dw-secure-audit` |
@@ -57,6 +60,8 @@ Antes de escolher um comando da Trigger Map, dimensione o escopo real da mudanç
 | "Abre um novo projeto" / "Bootstrap de stack" | `/dw-new-project` |
 | "Dockeriza isso" / "Adiciona docker-compose" | `/dw-dockerize` |
 | "Functional doc" / "Mapeia screens e flows" | `/dw-functional-doc` |
+| "Instala skills Azure" / "Configura MCP do Microsoft docs" / "Adiciona expertise Azure" / "Vou trabalhar com Azure" | `/dw-install-azure-skills` |
+| "Instala skills AWS" / "Configura MCP da AWS" / "Adiciona expertise AWS" / "Vou trabalhar com AWS" | `/dw-install-aws-skills` |
 
 **Prioridade:** na dúvida entre dois comandos, `/dw-autopilot` é o default mais seguro pra qualquer pedido de feature não-trivial — ele compõe os demais.
 
@@ -79,10 +84,50 @@ Quando qualquer destes se aplica, responda direto e **não** invoque comando `dw
 
 ## Padrão zoom-out (para áreas desconhecidas do código)
 
-Quando você cai numa área do codebase que não conhece e a orientação custa mais que a tarefa em si, **não mergulhe nos arquivos primeiro** — peça a um agente de exploração que produza um mapa. Passe o glossário de domínio do projeto (`.dw/rules/index.md`) e diga: "zoom out de um nível — me mostra os módulos relevantes, suas superfícies públicas, quem chama, e o fluxo de dados entre eles, usando o vocabulário do glossário de domínio." Pegue a visão geral, e só então mergulhe. Isso evita a armadilha de ler o arquivo mais profundo primeiro e reconstruir a arquitetura das folhas pra cima.
+Quando você cai numa área do codebase que não conhece e a orientação custa mais que a tarefa em si, **não mergulhe nos arquivos primeiro** — peça ao `dw-code-explorer` que produza um mapa. Passe o glossário de domínio do projeto (`.dw/rules/index.md`) e diga: "zoom out de um nível — me mostra os módulos relevantes, suas superfícies públicas, quem chama, e o fluxo de dados entre eles, usando o vocabulário do glossário de domínio." Pegue a visão geral, e só então mergulhe. Isso evita a armadilha de ler o arquivo mais profundo primeiro e reconstruir a arquitetura das folhas pra cima.
 
 Adaptado de [`mattpocock/skills/zoom-out`](https://github.com/mattpocock/skills/tree/main/zoom-out) (MIT).
 
+## Disciplina de Dispatch de Subagentes
+
+Agentes de projeto sao instalados em `.claude/agents/`, `.opencode/agent/`, `.agents/agents/` e `.github/agents/` quando suportado. Claude Code e OpenCode podem usar subagentes nativos. Copilot recebe custom agents. Codex deve tratar `.agents/agents/` como perfis delegaveis quando houver suporte a subagentes, ou como prompt pack manual caso contrario.
+
+Use subagente quando:
+
+- A tarefa gerar output volumoso: logs, testes, grep amplo, evidencia de QA, traces de browser ou notas de pesquisa.
+- A tarefa for read-only, paralelizavel e tiver fronteira clara.
+- A tarefa tiver return value compacto: findings, mapa, arquivos alterados, verificacao ou bloqueios.
+- Voce precisar de review independente: seguranca, silent failure, corretude por linguagem ou prontidao de PR.
+
+Nao use subagente quando:
+
+- A tarefa exigir dialogo frequente com o usuario.
+- Planejamento, implementacao e teste compartilharem contexto vivo demais.
+- A mudanca for pequena o bastante para fazer inline.
+- O subagente precisar do transcript completo do parent para nao chutar.
+- A tarefa delegada precisaria spawnar outros subagentes.
+
+Limites:
+
+- Rode no maximo 3 subagentes concorrentes por workstream.
+- Output default deve ficar perto do budget do registry, normalmente 900-1200 palavras.
+- Subagentes resumem logs; retornam linhas falhas, paths, comandos, decisoes e riscos, nao transcripts completos.
+- O parent e o unico sintetizador final.
+- O parent passa um input packet, nao historico bruto da conversa. Use `/dw-subtask-start`, `/dw-subtask-complete` e `/dw-subtask-resume` para handoffs locais.
+
+Claude-only: prefira named subagents para pesquisa, review, build e QA isolados. Use forks so quando a subtarefa realmente precisar do contexto do parent.
+
+Roteamento de agentes:
+
+- Use `dw-code-explorer` antes de planejar ou debugar areas desconhecidas.
+- Use `dw-build-fixer` so depois de uma falha real de build/typecheck/lint.
+- Use `dw-code-reviewer`, `dw-security-reviewer` e `dw-silent-failure-hunter` durante `/dw-review`.
+- Use agentes especificos de linguagem quando o modulo estiver instalado e o diff bater com a linguagem.
+
+## Disciplina de Carregamento de Skills
+
+Skills são protocolos compactos primeiro. Leia o `SKILL.md` de entrada e carregue arquivos em `references/`, `assets/`, `rules/` ou `scripts/` só quando o trigger, a tarefa ou o output exigir esse material mais profundo. Se uma skill parecer duplicada, ampla demais ou cara para a tarefa atual, rode `/dw-skill-health`.
+
 ## Referência de Workflow
 
 ```

package/scaffold/pt-br/commands/dw-bugfix.md

@@ -44,6 +44,15 @@
     - `dw-testing-discipline`: use quando a correção requer fluxo E2E/reteste reproduzível em web app — `references/playwright-recipes.md` pra recipes, core rules + 6 agent guardrails pra qualquer teste que o fix adicione, flaky-discipline se o bug aparece de forma intermitente.
     - `dw-incident-response`: use quando o bug tem severidade `critical` E afeta produção E foi detectado por alerta/user-report (ou seja, o bug É um incident, não item de backlog). Dispara o workflow de 5 fases (triage → investigation → resolution → communication → postmortem) com saída estruturada em `.dw/incidents/`. As correções rodam via `/dw-bugfix` durante a fase de resolution.
     - `security-review`: use quando a causa raiz toca auth, autorização, input externo, upload, secrets, SQL, XSS, SSRF ou outras superfícies sensíveis
+    - `dw-silent-failure`: use quando o sintoma pode estar escondido por erros engolidos, fallbacks perigosos, retries, queue workers ou async detachment
+
+    ## Agent Dispatch
+
+    Quando agentes do projeto estiverem instalados:
+    - Comece com `dw-code-explorer` para rastrear fluxo de reproducao e owners provaveis.
+    - Use `dw-build-fixer` ou o build-fixer de linguagem apenas depois que build/typecheck/test falhar.
+    - Use `dw-test-author` para o regression test.
+    - Use `dw-silent-failure-hunter` quando o bug envolver erros ausentes, success state incorreto ou fallback data.
 
     ## Variáveis de Entrada
 

package/scaffold/pt-br/commands/dw-context-budget.md

@@ -0,0 +1,28 @@
+<system_instructions>
+Voce e o auditor de orcamento de contexto do dev-workflow.
+
+## Quando Usar
+- Use quando sessoes parecerem lentas, agentes lerem arquivos demais, ou o projeto tiver muitas skills/MCPs.
+- Use antes de adicionar pacotes grandes de skills ou novos MCP servers.
+- Use como follow-up de `/dw-analyze-project` quando o harness parecer inchado.
+
+## Processo
+1. Estime tokens de `CLAUDE.md`, `AGENTS.md`, `.dw/commands/*.md`, `.agents/skills/*/SKILL.md`, `.agents/agents/*.md`, `.claude/agents/*.md`, `.opencode/agent/*.md`, `.github/agents/*.agent.md`, `.dw/subtasks/pending/*/HANDOFF.md` e `.claude/settings.json`.
+2. Estime prosa como `palavras * 1.3`; JSON/schema como `chars / 4`.
+3. Aponte:
+   - commands acima de 20KB,
+   - `SKILL.md` acima de 12KB,
+   - agentes acima de 8KB,
+   - agentes sem `output_budget_words` no `.dw/agent-registry.json` ou registry do scaffold,
+   - media de handoffs pendentes acima de 1200 palavras,
+   - agentes Copilot acima de 30k chars,
+   - mais de 10 MCP servers,
+   - nomes duplicados entre pastas de plataforma,
+   - agentes Claude/OpenCode com campos de tools ou permissions incompativeis com o provider.
+4. Recomende as 5 maiores economias com caminhos concretos.
+
+## Saida
+Responda com um relatorio conciso. Se `.dw/reports/` existir, escreva tambem `.dw/reports/context-budget.md`.
+
+Marcador final: `## CONTEXT-BUDGET COMPLETE`
+</system_instructions>

package/scaffold/pt-br/commands/dw-harness-audit.md

@@ -0,0 +1,31 @@
+<system_instructions>
+Voce e o auditor do harness dev-workflow.
+
+## Quando Usar
+- Use apos `dev-workflow init`, `update` ou `repair`.
+- Use quando comandos, agentes, skills ou MCPs parecerem inconsistentes.
+- Use antes de publicar um setup de projeto.
+
+## Processo
+1. Rode `npx @brunosps00/dev-workflow doctor` se disponivel; senao inspecione manualmente.
+2. Pontue de 0-10:
+   - Commands instalados
+   - Wrappers de plataforma
+   - Cobertura de agentes
+   - Registry de agentes
+   - Compatibilidade por provider
+   - Disciplina de handoff
+   - Permissoes de ferramentas
+   - Cobertura de parallel-safety
+   - MCP configuration
+   - Gates de verificacao
+   - Gates de seguranca
+   - Disciplina de contexto
+3. Cite paths ausentes e referencias quebradas.
+4. Recomende os 3 principais fixes.
+
+## Saida
+Retorne um scorecard e nao altere arquivos. Para drift de arquivo gerenciado, indique `dev-workflow repair`.
+
+Marcador final: `## HARNESS-AUDIT COMPLETE`
+</system_instructions>

package/scaffold/pt-br/commands/dw-help.md

@@ -1,5 +1,5 @@
 <system_instructions>
-Você é o guia do dev-workflow. Exibe a surface primária de comandos, o fluxo típico e atalhos contextuais. Modo padrão mostra 15 comandos visíveis; `--advanced` revela 5 internos/escondidos.
+Você é o guia do dev-workflow. Exibe a surface primária de comandos, o fluxo típico e atalhos contextuais. Modo padrão mostra a surface visível de comandos; `--advanced` revela comandos internos/escondidos.
 
 ## Quando Usar
 - Usuário digita `/dw-help` para descobrir comandos.
@@ -33,13 +33,16 @@ Use `/dw-autopilot "desejo"` como gateway pra maior parte do trabalho. Comandos
 | `/dw-commit` | Commits atômicos Conventional pra trabalho pendente. |
 | `/dw-generate-pr [target]` | Push branch, draft do PR body, abre browser. |
 
-## Tier 3 — Especialidade (5)
+## Tier 3 — Especialidade (8)
 
 | Comando | O que |
 |---------|-------|
 | `/dw-analyze-project` | Scan do repo, escreve `.dw/rules/` + oferece gerar `.dw/constitution.md`. |
 | `/dw-redesign-ui "target"` | Audit, propõe 2-3 direções, entrega. Enforça UI grounding + WCAG. |
 | `/dw-functional-doc` | Mapeia screens + flows em doc funcional validado com Playwright. |
+| `/dw-context-budget` | Audita contexto de commands, skills, agentes, instrucoes e MCPs. |
+| `/dw-harness-audit` | Pontua saude da instalacao: wrappers, agentes, MCPs e gates. |
+| `/dw-skill-health` | Audita skills e agentes por bloat, duplicacao e referencias quebradas. |
 | `/dw-new-project` | Bootstrap por entrevista (stack + infra + docker-compose + CI). |
 | `/dw-dockerize` | Detecta stack, propõe Dockerfile + docker-compose pra dev/prod. |
 
@@ -53,7 +56,7 @@ Use `/dw-autopilot "desejo"` como gateway pra maior parte do trabalho. Comandos
 
 ## Comandos avançados / internos
 
-Passe `--advanced` pra ver internos (`dw-adr`, `dw-intel`, `dw-secure-audit`, `dw-find-skills`, `dw-update`) — usualmente invocados por outros comandos.
+Passe `--advanced` pra ver internos (`dw-adr`, `dw-intel`, `dw-secure-audit`, `dw-find-skills`, `dw-update`, `dw-subtask-start`, `dw-subtask-complete`, `dw-subtask-resume`) — usualmente invocados por outros comandos.
 ```
 
 ## Modo advanced — flag `--advanced`
@@ -65,7 +68,7 @@ ALSO show:
 
 Auto-invocados por comandos primários mas disponíveis standalone.
 
-## Tier 4 — Hidden (5)
+## Tier 4 — Hidden (8)
 
 | Comando | O que | Invocado por |
 |---------|-------|--------------|
@@ -74,6 +77,9 @@ Auto-invocados por comandos primários mas disponíveis standalone.
 | `/dw-secure-audit` | OWASP + Trivy + lockfile + supply-chain scan. Hard gate. Flags: `--scan-only`, `--plan`, `--execute`. | `/dw-review`, `/dw-generate-pr` |
 | `/dw-find-skills "query"` | Busca npx skills ecosystem, valida, instala. | manual ao estender bundle |
 | `/dw-update` | Atualiza dev-workflow pro último release npm com snapshot rollback. | manutenção manual |
+| `/dw-subtask-start "goal"` | Cria um input packet minimo para subagente. | parent antes de delegar |
+| `/dw-subtask-complete <slug>` | Registra handoff estruturado da sessao child. | subagente / sessao child |
+| `/dw-subtask-resume` | Consome e arquiva handoffs pendentes para sintese do parent. | parent apos delegacao |
 ```
 
 ## Modo keyword — `/dw-help <palavra-chave>`
@@ -92,6 +98,10 @@ Auto-invocados por comandos primários mas disponíveis standalone.
 | `refactor`, `smell`, `code health` | `/dw-brainstorm --refactor` |
 | `ui`, `design`, `redesign` | `/dw-redesign-ui` |
 | `intel`, `onde está`, `o que usa` | `/dw-intel` (ou `--build`) |
+| `contexto`, `tokens`, `agente lento` | `/dw-context-budget` |
+| `harness`, `install`, `wrappers`, `agentes` | `/dw-harness-audit` |
+| `subagent`, `subtask`, `handoff`, `delegate`, `delegar` | `/dw-subtask-start` ou `/dw-subtask-resume` |
+| `skills`, `skill health`, `bloat` | `/dw-skill-health` |
 | `analyze`, `rules`, `convenções` | `/dw-analyze-project` |
 | `constitution`, `princípios` | `/dw-analyze-project` (Step 8) |
 | `security`, `vulnerabilidades`, `cve`, `deps` | `/dw-secure-audit` |
@@ -122,6 +132,6 @@ Sem match: surface padrão + nota.
 - Skill `dw-llm-eval` auto-invocada de `/dw-plan tasks`, `/dw-review`, `/dw-qa --ai`.
 
 **P: O que aconteceu com outros comandos?**
-- v1.0.0 consolidou 30 → 20. Mergers: create-prd/techspec/tasks → `/dw-plan`; run-task/run-plan → `/dw-run`; code-review/review-implementation → `/dw-review`; run-qa/fix-qa → `/dw-qa`; security-check/deps-audit → `/dw-secure-audit`; map-codebase → `/dw-intel --build`; deep-research e refactoring-analysis → `/dw-brainstorm --research/--refactor`. Removidos: revert-task (use `git revert` direto).
+- v1.0.0 consolidou a surface antiga de comandos. Mergers: create-prd/techspec/tasks → `/dw-plan`; run-task/run-plan → `/dw-run`; code-review/review-implementation → `/dw-review`; run-qa/fix-qa → `/dw-qa`; security-check/deps-audit → `/dw-secure-audit`; map-codebase → `/dw-intel --build`; deep-research e refactoring-analysis → `/dw-brainstorm --research/--refactor`. Removidos: revert-task (use `git revert` direto).
 
 </system_instructions>

package/scaffold/pt-br/commands/dw-install-aws-skills.md

@@ -0,0 +1,166 @@
+<system_instructions>
+Você instala agent skills opt-in da AWS a partir do `aws/agent-toolkit-for-aws` (Apache 2.0) em `.agents/skills/aws/` e registra o AWS MCP Server unificado (stdio via `uvx mcp-proxy-for-aws`, requer credenciais AWS) em `.claude/settings.json`. Mesmo resultado de `npx @brunosps00/dev-workflow install-aws-skills` — interface diferente.
+
+## Quando Usar
+- Use quando o usuário pedir para "instalar skills AWS", "configurar MCP da AWS", "adicionar expertise AWS", "vou trabalhar com AWS", ou similar.
+- Use quando um projeto existente começa uma feature que toca AWS (Lambda, S3, Bedrock, EC2, etc.) e ainda não há `.agents/skills/aws/`.
+- NÃO use para Azure, GCP ou clouds não-AWS — têm comandos próprios ou não são suportados.
+- NÃO use para instalar as skills nativas do dev-workflow — essas vêm com `init`/`update`.
+
+## Posição no Pipeline
+**Antecessor:** (pedido explícito do usuário) | **Sucessor:** qualquer trabalho de feature AWS (tipicamente `/dw-plan` ou `/dw-autopilot`).
+
+## Pré-requisitos
+
+<critical>Este comando precisa de:
+1. `git` no PATH.
+2. `uv` (Python tool runner) — provê `uvx` que invoca o `mcp-proxy-for-aws`.
+3. `aws cli` ≥ 2.32.0.
+4. Credenciais AWS válidas — verifique com `aws sts get-caller-identity`.
+
+Se QUALQUER um faltar ou estiver inválido, PARE e diga ao usuário como instalar/configurar. NÃO clone ou copie nada se os pré-requisitos não estão prontos — install parcial é pior que nenhum.</critical>
+
+## Categorias (nativas do upstream)
+
+| Categoria | Caminhos upstream |
+|---|---|
+| **All** | `skills/core-skills/*` + `skills/specialized-skills/*/*` |
+| **Core** | `skills/core-skills/*` — 13 skills horizontais: amazon-bedrock, aws-amplify, aws-billing-and-cost-management, aws-cdk, aws-cloudformation, aws-containers, aws-iam, aws-messaging-and-streaming, aws-observability, aws-sdk-js-v3-usage, aws-sdk-python-usage, aws-sdk-swift-usage, aws-serverless |
+| **Analytics** | `skills/specialized-skills/analytics-skills/*` |
+| **Database** | `skills/specialized-skills/database-skills/*` |
+| **EC2 / Compute** | `skills/specialized-skills/ec2-skills/*` |
+| **Migration & Modernization** | `skills/specialized-skills/migration-and-modernization-skills/*` |
+| **Networking & Content Delivery** | `skills/specialized-skills/networking-and-content-delivery-skills/*` |
+| **Operations** | `skills/specialized-skills/operations-skills/*` |
+| **Security & Identity** | `skills/specialized-skills/security-and-identity-skills/*` |
+| **Serverless** | `skills/specialized-skills/serverless-skills/*` |
+| **Storage** | `skills/specialized-skills/storage-skills/*` |
+
+## Fluxo de Trabalho
+
+### 1. Verificar pré-requisitos
+
+Rode cada um via Bash. Em qualquer falha, PARE e imprima o bloco de instrução correspondente:
+
+| Check | Se faltar |
+|---|---|
+| `git --version` | `git é obrigatório. Instale via brew/apt/git-scm.com.` |
+| `uv --version` | `uv é obrigatório. Instale: curl -LsSf https://astral.sh/uv/install.sh \| sh` (macOS/Linux) ou PowerShell equivalente no Windows. |
+| `aws --version` | `aws cli ≥ 2.32.0 é obrigatório. Instale via brew install awscli, winget install Amazon.AWSCLI, ou siga a doc AWS.` |
+| `aws sts get-caller-identity` | `Credenciais AWS faltando/expiradas. Mais fácil: aws login (rotaciona a cada 15 min, valid 12h). SSO: aws configure sso. Keys: aws configure.` |
+
+NÃO prossiga para o passo 2 se algum check falhar.
+
+### 2. Escolher região
+
+Pergunte ao usuário qual região AWS usar. O MCP server é regional — endpoints suportados:
+
+- `us-east-1` → `https://aws-mcp.us-east-1.api.aws/mcp`
+- `eu-central-1` → `https://aws-mcp.eu-central-1.api.aws/mcp`
+
+Default `us-east-1` se o usuário não tiver preferência. O agent pode sobrescrever por query (ex: "list EC2 instances in eu-west-1") — a região do endpoint é só a região de operação default.
+
+### 3. Perguntar quais categorias instalar
+
+Use AskUserQuestion (multi-select se suportar; caso contrário, loop). Apresente as 11 categorias acima. Sugestão default quando indeciso: pergunte "qual parte da AWS você vai mexer?" e mapeie para uma categoria.
+
+### 4. Clone shallow do repo upstream
+
+```bash
+TMP=$(mktemp -d -t dw-aws-skills-XXXXXX)
+git clone --depth=1 https://github.com/aws/agent-toolkit-for-aws.git "$TMP"
+```
+
+Se o clone falhar, PARE e reporte o erro verbatim.
+
+### 5. Filtrar e copiar
+
+Para cada categoria selecionada, glob o caminho upstream correspondente e colete todos os diretórios de skill. Exemplos:
+
+- "Core" → cada subdir de `$TMP/skills/core-skills/`
+- "Database" → cada subdir de `$TMP/skills/specialized-skills/database-skills/`
+- "All" → cada subdir de `$TMP/skills/core-skills/` E cada subdir de `$TMP/skills/specialized-skills/*/`
+
+Antes de copiar, **limpe** `.agents/skills/aws/` para refresh limpo (re-runs substituem seleções anteriores).
+
+Pule qualquer skill cujo root contenha scripts executáveis (`.sh`, `.py`, `.js`, `.ts`, `.ps1`, `.bat`) — dev-workflow instala apenas skills puramente markdown. Reporte a contagem de pulados.
+
+Copie cada diretório casado recursivamente para `.agents/skills/aws/<skill-name>/`. **Achatar** a hierarquia upstream — o destino não tem split `core-skills/` vs `specialized-skills/`. Só o slug da skill como nome de diretório.
+
+### 6. Registrar o AWS MCP Server
+
+Leia `.claude/settings.json`. Parseie o JSON. Upsert em `mcpServers`:
+
+```json
+{
+  "mcpServers": {
+    "aws-mcp": {
+      "command": "uvx",
+      "args": [
+        "mcp-proxy-for-aws@latest",
+        "https://aws-mcp.us-east-1.api.aws/mcp",
+        "--metadata",
+        "AWS_REGION=us-east-1"
+      ],
+      "transport": "stdio",
+      "timeout": 100000
+    }
+  }
+}
+```
+
+Substitua o endpoint e o valor de `AWS_REGION` pela região escolhida no passo 2.
+
+Se `mcpServers.aws-mcp` já existir, deixe intocado — nunca sobrescreva. Diga ao usuário para editar `.claude/settings.json` direto (ou remover a entry e re-rodar) para mudar a região. Outras entradas em `mcpServers` (context7, playwright, microsoft-learn, etc.) DEVEM ser preservadas.
+
+### 7. Escrever `.dw/references/aws-mcp-instructions.md`
+
+Crie (sobrescreva se presente) com a orientação canônica para o agent — as 5 MCP tools (`aws___search_documentation`, `aws___read_documentation`, `aws___retrieve_skill`, `aws___call_aws`, `aws___run_script`), o protocolo de operações destrutivas (confirmar antes de qualquer `create*`/`update*`/`delete*`/`modify*`/IAM/billing), comportamento de região, source-grounding, refresh/uninstall.
+
+A versão CLI deste comando (`npx @brunosps00/dev-workflow install-aws-skills`) já carrega o texto canônico. Se rodando como slash command, replique o mesmo conteúdo do constant `AWS_MCP_INSTRUCTIONS` em `lib/install-aws-skills.js`.
+
+### 8. Cleanup
+
+Remova `$TMP`. Sempre — mesmo se passos anteriores falharam.
+
+### 9. Reportar
+
+```
+## Skills AWS instaladas
+
+Categorias: [lista]
+Região: us-east-1 (ou escolhida)
+Skills copiadas: N (M puladas com scripts executáveis)
+MCP registrado: aws-mcp (ou "já presente, deixado inalterado")
+Instruções do agent: .dw/references/aws-mcp-instructions.md
+
+## Próximos passos
+
+1. Reinicie o Claude Code (ou Codex / Copilot / OpenCode) para o MCP carregar.
+2. Valide com uma pergunta AWS, ex: "Qual o limite de execuções concorrentes do Lambda?"
+3. O agent agora pode chamar APIs AWS via aws___call_aws — revise
+   .dw/references/aws-mcp-instructions.md para o protocolo de operações destrutivas.
+4. Para refrescar do upstream, rode /dw-install-aws-skills de novo.
+5. Para desinstalar: rm -rf .agents/skills/aws/ e remova a entrada "aws-mcp"
+   de .claude/settings.json mcpServers.
+```
+
+## Comportamento Obrigatório
+
+<critical>NUNCA adicione o MCP `aws-mcp` fora deste comando. É opt-in. `init` e `update` NÃO DEVEM mexer.</critical>
+
+<critical>NUNCA registre o AWS Knowledge MCP deprecated (`https://knowledge-mcp.global.api.aws`). A AWS oficialmente substituiu pelo AWS MCP Server unificado; registrar ambos causa tool conflicts que confundem agents.</critical>
+
+<critical>NUNCA auto-instale `uv` ou `aws cli`. Imprima o bloco de instruções e deixe o usuário escolher o caminho de instalação. Evita quebrar o ambiente do usuário com gerenciadores que não controlamos.</critical>
+
+<critical>NUNCA pule a checagem de credenciais. Um install limpo sem `aws sts get-caller-identity` funcionando produz um MCP quebrado que falha em toda tool call. Melhor parar e instruir.</critical>
+
+<critical>NUNCA copie LICENSE/README/CONTRIBUTING do upstream para `.agents/skills/aws/` — pertencem à AWS e poluem a descoberta de skills. Copie apenas `SKILL.md` por skill + conteúdo auxiliar (references/, assets/).</critical>
+
+<critical>NUNCA copie skills com scripts executáveis. O escopo do dev-workflow é markdown-only. Se uma skill precisa de scripts, o usuário deve instalar direto do repo upstream, não por este comando.</critical>
+
+## Atribuição
+
+Skills vêm de [`aws/agent-toolkit-for-aws`](https://github.com/aws/agent-toolkit-for-aws) (Apache 2.0, da AWS). O MCP server está documentado em [docs.aws.amazon.com/aws-mcp/](https://docs.aws.amazon.com/aws-mcp/). O proxy é [`aws/mcp-proxy-for-aws`](https://github.com/aws/mcp-proxy-for-aws). dev-workflow apenas orquestra a instalação.
+
+</system_instructions>

package/scaffold/pt-br/commands/dw-install-azure-skills.md

@@ -0,0 +1,138 @@
+<system_instructions>
+Você instala agent skills opt-in da Azure a partir do `MicrosoftDocs/Agent-Skills` (CC-BY-4.0) em `.agents/skills/azure/` e registra o Microsoft Learn MCP Server (HTTP, sem auth) em `.claude/settings.json`. Mesmo resultado de `npx @brunosps00/dev-workflow install-azure-skills` — interface diferente.
+
+## Quando Usar
+- Use quando o usuário pedir para "instalar skills Azure", "configurar MCP do Microsoft docs", "adicionar expertise Azure", "vou trabalhar com Azure", ou similar.
+- Use quando um projeto existente começa uma feature que toca Azure (Container Apps, OpenAI, AKS, etc.) e ainda não há `.agents/skills/azure/`.
+- NÃO use para AWS, GCP ou qualquer cloud não-Microsoft — não estão no repo upstream.
+- NÃO use para instalar as skills nativas do dev-workflow — essas vêm com `init`/`update`.
+
+## Posição no Pipeline
+**Antecessor:** (pedido explícito do usuário) | **Sucessor:** qualquer trabalho de feature Azure (tipicamente `/dw-plan` ou `/dw-autopilot`).
+
+## Pré-requisitos
+
+<critical>Este comando precisa de `git` no PATH. Se `git --version` falhar, PARE e diga ao usuário para instalar git primeiro.</critical>
+
+## Categorias (curadas)
+
+| Categoria | O que cobre |
+|---|---|
+| All | Todas as skills no diretório `skills/` upstream. |
+| Compute | AKS, App Service, Container Apps/Instances/Registry, Functions, VMs, Batch, Spring Apps. |
+| Data & Storage | Blob, Cosmos DB, SQL, MySQL, PostgreSQL, Cache Redis, Data Lake, Files, Table/Queue Storage, Managed Disks. |
+| AI & ML | OpenAI, AI Foundry, AI Vision, AI Search, AI Services, Machine Learning, Anomaly Detector, Bot Service, Cognitive Services. |
+| Networking | Application Gateway, Front Door, Load Balancer, VPN Gateway, ExpressRoute, Bastion, DNS, CDN, Virtual Network, Virtual WAN, Private Link, Network Watcher, Firewall, Traffic Manager. |
+| Identity & Security | Entra ID (Active Directory), Key Vault, Attestation, Defender, Sentinel, Security Center, Artifact Signing. |
+| DevOps | Boards, Pipelines, Artifacts, Repos, Azure DevOps Server, Test Plans. |
+| Observability | Monitor, Application Insights, Log Analytics. |
+| Integration | Logic Apps, Service Bus, Event Grid, Event Hubs, API Management, API Center, Business Process Tracking. |
+| Architecture | Architecture guidance, Advisor, Blueprints, Well-Architected, Policy, Resource Graph, Resource Manager. |
+
+## Fluxo de Trabalho
+
+### 1. Verificar `git`
+
+Rode `git --version` via Bash. Em caso de falha, PARE com: `git é obrigatório para instalar skills Azure. Instale o git e tente novamente.`
+
+### 2. Perguntar ao usuário quais categorias instalar
+
+Use AskUserQuestion (multi-select se a interface suportar; caso contrário, loop). Apresente as 10 categorias com suas descrições. Sugestão default quando o usuário não decide: pergunte "qual parte da Azure você vai mexer?" e mapeie a resposta para uma categoria.
+
+### 3. Clone shallow do repo upstream
+
+```bash
+TMP=$(mktemp -d -t dw-azure-skills-XXXXXX)
+git clone --depth=1 https://github.com/MicrosoftDocs/Agent-Skills.git "$TMP"
+```
+
+Se o clone falhar (rede, rate limit do GitHub, etc.), PARE e reporte o erro verbatim. Não instale parcialmente.
+
+### 4. Filtrar e copiar
+
+Para cada subdiretório de `$TMP/skills/`, decida se casa com as categorias selecionadas. O match é **por prefixo** — um diretório `azure-aks-edge-essentials` casa com o prefixo `azure-aks`.
+
+**Tabela de prefixos (canônica — manter em sincronia com `lib/azure-categories.js` no repo dev-workflow):**
+
+| Categoria | Prefixos |
+|---|---|
+| **All** | (todo diretório sob `$TMP/skills/`) |
+| **Compute** | `azure-aks`, `azure-app-service`, `azure-container-apps`, `azure-container-instances`, `azure-container-registry`, `azure-functions`, `azure-virtual-machines`, `azure-vmware-solution`, `azure-batch`, `azure-spring-apps` |
+| **Data & Storage** | `azure-blob-storage`, `azure-cosmos-db`, `azure-sql`, `azure-database-for-mysql`, `azure-database-for-postgresql`, `azure-cache-redis`, `azure-data-lake`, `azure-files`, `azure-storage`, `azure-table-storage`, `azure-queue-storage`, `azure-managed-disk` |
+| **AI & ML** | `azure-openai`, `azure-ai-foundry`, `azure-ai-vision`, `azure-ai-search`, `azure-ai-services`, `azure-machine-learning`, `azure-anomaly-detector`, `azure-bot-service`, `azure-cognitive` |
+| **Networking** | `azure-application-gateway`, `azure-front-door`, `azure-load-balancer`, `azure-vpn-gateway`, `azure-expressroute`, `azure-bastion`, `azure-dns`, `azure-cdn`, `azure-virtual-network`, `azure-virtual-wan`, `azure-private-link`, `azure-network-watcher`, `azure-firewall`, `azure-traffic-manager` |
+| **Identity & Security** | `azure-active-directory`, `azure-entra`, `azure-key-vault`, `azure-attestation`, `azure-defender`, `azure-sentinel`, `azure-security-center`, `azure-artifact-signing` |
+| **DevOps** | `azure-boards`, `azure-pipelines`, `azure-artifacts`, `azure-repos`, `azure-devops`, `azure-test-plans` |
+| **Observability** | `azure-monitor`, `azure-application-insights`, `azure-log-analytics` |
+| **Integration** | `azure-logic-apps`, `azure-service-bus`, `azure-event-grid`, `azure-event-hubs`, `azure-api-management`, `azure-api-center`, `azure-business-process-tracking` |
+| **Architecture** | `azure-architecture`, `azure-advisor`, `azure-blueprints`, `azure-well-architected`, `azure-policy`, `azure-resource-graph`, `azure-resource-manager` |
+
+Um diretório casa uma categoria se seu nome é igual a um dos prefixos OU começa com `<prefixo>-`.
+
+Antes de copiar, **limpe** `.agents/skills/azure/` para garantir refresh limpo (re-runs substituem seleções anteriores; intencional).
+
+Pule qualquer skill cujo root contenha scripts executáveis (`.sh`, `.py`, `.js`, `.ts`, `.ps1`, `.bat`) — dev-workflow instala apenas skills puramente markdown. Reporte a contagem de pulados.
+
+Copie cada diretório casado recursivamente para `.agents/skills/azure/<skill-name>/`. Preserve subdiretórios (`references/`, `assets/`).
+
+### 5. Registrar o Microsoft Learn MCP server
+
+Leia `.claude/settings.json` (crie o diretório se faltar). Parseie o JSON. Upsert em `mcpServers`:
+
+```json
+{
+  "mcpServers": {
+    "microsoft-learn": {
+      "type": "http",
+      "url": "https://learn.microsoft.com/api/mcp"
+    }
+  }
+}
+```
+
+Se `mcpServers.microsoft-learn` já existir, deixe intocado — nunca sobrescreva config do usuário. Outras entradas em `mcpServers` (context7, playwright, etc.) DEVEM ser preservadas.
+
+### 6. Escrever `.dw/references/azure-mcp-instructions.md`
+
+Crie o arquivo (sobrescreva se presente) com a orientação para o agent — quando chamar qual MCP tool (`microsoft_docs_search`, `microsoft_docs_fetch`, `microsoft_code_sample_search`), como citar fontes per `dw-source-grounding`, e como refrescar ou desinstalar.
+
+A versão CLI deste comando (`npx @brunosps00/dev-workflow install-azure-skills`) já carrega o texto canônico — se você está rodando como slash command, replique o mesmo conteúdo do constant `AZURE_MCP_INSTRUCTIONS` em `lib/install-azure-skills.js`.
+
+### 7. Cleanup
+
+Remova `$TMP`. Sempre — mesmo se passos anteriores falharam.
+
+### 8. Reportar
+
+```
+## Skills Azure instaladas
+
+Categorias: [lista]
+Skills copiadas: N (M puladas com scripts executáveis)
+MCP registrado: microsoft-learn (ou "já presente, deixado inalterado")
+Instruções do agent: .dw/references/azure-mcp-instructions.md
+
+## Próximos passos
+
+1. Reinicie o Claude Code (ou Codex / Copilot / OpenCode) para o MCP carregar.
+2. Valide com uma pergunta Azure, ex: "Como faço deploy em Azure Container Apps?"
+3. Para refrescar do upstream, rode /dw-install-azure-skills de novo.
+4. Para desinstalar: rm -rf .agents/skills/azure/ e remova a entrada "microsoft-learn"
+   de .claude/settings.json mcpServers.
+```
+
+## Comportamento Obrigatório
+
+<critical>NUNCA adicione o MCP `microsoft-learn` fora deste comando. É opt-in. `init` e `update` NÃO DEVEM mexer.</critical>
+
+<critical>NUNCA copie skills com scripts executáveis. O escopo do dev-workflow é markdown-only. Se uma skill precisa de scripts, o usuário deve instalar direto do repo upstream, não por este comando.</critical>
+
+<critical>NUNCA fabrique a URL do upstream ou do MCP. O repo é `https://github.com/MicrosoftDocs/Agent-Skills.git` e o endpoint do MCP é `https://learn.microsoft.com/api/mcp`. São endpoints first-party Microsoft, atribuição CC-BY-4.0 obrigatória.</critical>
+
+<critical>NUNCA copie LICENSE/README do upstream para `.agents/skills/azure/` — são da Microsoft e poluem a descoberta de skills do agent. Copie apenas `SKILL.md` + conteúdo auxiliar por skill (references/, assets/).</critical>
+
+## Atribuição
+
+Skills vêm de [`MicrosoftDocs/Agent-Skills`](https://github.com/MicrosoftDocs/Agent-Skills) (CC-BY-4.0, da Microsoft). O MCP server está documentado em [Microsoft Learn](https://learn.microsoft.com/en-us/training/support/mcp-get-started). dev-workflow apenas orquestra a instalação — nenhum conteúdo upstream é modificado além de posicionamento.
+
+</system_instructions>

package/scaffold/pt-br/commands/dw-intel.md

@@ -29,6 +29,11 @@ Voce e o assistente de inteligencia do codebase. Dois modos: consultar o indice
 | Skill | Gatilho |
 |-------|---------|
 | `dw-codebase-intel` | **SEMPRE** quando `.dw/intel/` existir. Leia `references/query-patterns.md` para mapear a query do usuario para o arquivo certo (stack/files/apis/deps/arch). |
+| `dw-context-budget` | Use quando arquivos de intel ou codemaps ficarem grandes demais para carregamento eficiente. |
+
+## Agent Dispatch
+
+Quando agentes do projeto estiverem instalados, use `dw-code-explorer` para rastreamento amplo de feature e descoberta focada do codebase. Em build mode, prefira iterative retrieval: busca ampla, avaliacao de relevancia, busca refinada e depois update de codemap.
 
 ## Variaveis de Entrada
 
@@ -39,6 +44,7 @@ Voce e o assistente de inteligencia do codebase. Dois modos: consultar o indice
 ## Localizacao dos Arquivos
 
 - Intel machine-readable (consulta primeira): `.dw/intel/{stack,files,apis,deps,bugfixes}.json` + `.dw/intel/arch.md`
+- Codemaps token-lean: `.dw/intel/codemaps/{architecture,backend,frontend,data,dependencies}.md`
 - Metadados de refresh: `.dw/intel/.last-refresh.json`
 - Rules human-readable (consulta segunda): `.dw/rules/{index,<modulo>,integrations,concerns}.md`
 - Fonte do historico de bugfixes: `.dw/bugfixes/*/SUMMARY.md`