msd-core/docs/pt-BR/INVENTORY.md

Inventário de Superfícies Entregues do MSD

Registro autoritativo de toda superfície MSD entregue: comandos, agentes, workflows, referências, módulos de CLI e hooks. Quando a documentação ampla (AGENTS.md, COMMANDS.md, ARCHITECTURE.md, CLI-TOOLS.md) divergir do sistema de arquivos, este arquivo e a árvore do repositório são a fonte de verdade.

Como Usar Este Arquivo

• As contagens aqui são derivadas do sistema de arquivos no pino v1.36.0 e podem divergir entre versões. Para contagens ao vivo, execute ls commands/msd/*.md | wc -l, ls agents/msd-*.md | wc -l, etc. na cópia local do repositório.
• Este arquivo enumera toda superfície entregue em todas as seis famílias (agentes, comandos, workflows, referências, módulos de CLI, hooks). Documentações amplas podem apresentar narrativas ou subconjuntos curados; quando discordarem do sistema de arquivos, este arquivo e as listagens de diretório são autoritativos.
• Novas superfícies adicionadas após v1.36.0 devem aparecer aqui primeiro, depois propagar para as documentações amplas. O teste de controle de drift em tests/inventory-manifest-sync.test.cjs ancora o conteúdo do registro ao sistema de arquivos.

Este é o registro autoritativo de toda superfície do MSD Core entregue. Veja o índice de documentação para navegar por tópico.

---

Agentes (33 entregues)

Registro completo em agents/msd-*.md. A coluna "Documento primário" indica se docs/AGENTS.md apresenta um cartão de função completo (primary), um stub resumido na seção "Agentes Avançados e Especializados" (advanced stub), ou nenhuma cobertura (inventory only).

Agente	Função (uma linha)	Invocado por	Documento primário
msd-project-researcher	Pesquisa o ecossistema do domínio antes da criação do roadmap (stack, funcionalidades, arquitetura, armadilhas).	/msd-new-project, /msd-new-milestone	primary
msd-phase-researcher	Pesquisa a abordagem de implementação para uma fase específica antes do planejamento.	/msd-plan-phase	primary
msd-ui-researcher	Produz contratos de design de UI para fases de frontend.	/msd-ui-phase	primary
msd-assumptions-analyzer	Produz premissas embasadas em evidências para a discuss-phase (modo de premissas).	workflow discuss-phase-assumptions	primary
msd-advisor-researcher	Pesquisa uma única decisão em zona cinzenta durante o modo advisordiscuss-phase.	workflow discuss-phase (modo advisor)	primary
msd-research-synthesizer	Combina saídas de pesquisadores paralelos em um SUMMARY.md unificado.	/msd-new-project	primary
msd-planner	Cria planos de fase executáveis com detalhamento de tarefas e verificação retroativa a partir dos objetivos.	/msd-plan-phase, /msd-quick	primary
msd-roadmapper	Cria roadmaps de projeto com detalhamento de fases e mapeamento de requisitos.	/msd-new-project	primary
msd-executor	Executa planos MSD com commits atômicos e tratamento de desvios.	/msd-execute-phase, /msd-quick	primary
msd-plan-checker	Verifica se os planos vão atingir os objetivos da fase (8 dimensões de verificação).	/msd-plan-phase (loop de verificação)	primary
msd-integration-checker	Verifica a integração entre fases e fluxos de ponta a ponta.	/msd-audit-milestone	primary
msd-ui-checker	Valida contratos de design UI-SPEC.md contra dimensões de qualidade.	/msd-ui-phase (loop de validação)	primary
msd-verifier	Verifica o alcance dos objetivos da fase por meio de análise retroativa a partir dos objetivos.	/msd-execute-phase	primary
msd-nyquist-auditor	Preenche lacunas de validação Nyquist gerando testes.	/msd-validate-phase	primary
msd-ui-auditor	Auditoria visual retroativa de 6 pilares do código frontend implementado.	/msd-ui-review	primary
msd-codebase-mapper	Explora a base de código e escreve documentos de análise estruturados.	/msd-map-codebase	primary
msd-debugger	Investiga bugs usando o método científico com estado persistente.	/msd-debug, /msd-verify-work	primary
msd-user-profiler	Avalia o comportamento do desenvolvedor em 8 dimensões.	/msd-profile-user	primary
msd-doc-writer	Escreve e atualiza a documentação do projeto.	/msd-docs-update	primary
msd-doc-verifier	Verifica afirmações factuais na documentação gerada.	/msd-docs-update	primary
msd-security-auditor	Verifica mitigações de ameaças do modelo de ameaças do PLAN.md.	/msd-secure-phase	primary
msd-pattern-mapper	Mapeia novos arquivos para os análogos existentes mais próximos; escreve PATTERNS.md para o planejador.	/msd-plan-phase (entre pesquisa e planejamento)	advanced stub
msd-debug-session-manager	Executa o loop completo de checkpoint e continuação do /msd-debug em contexto isolado para manter o contexto principal enxuto.	/msd-debug	advanced stub
msd-code-reviewer	Revisa arquivos-fonte em busca de bugs, problemas de segurança e qualidade de código; produz REVIEW.md.	/msd-code-review	advanced stub
msd-code-fixer	Aplica correções às descobertas do REVIEW.md com commits atômicos por correção; produz REVIEW-FIX.md.	/msd-code-review --fix	advanced stub
msd-ai-researcher	Pesquisa a documentação oficial de um framework de IA escolhido em orientações prontas para implementação (AI-SPEC.md §3–§4b).	/msd-ai-integration-phase	advanced stub
msd-domain-researcher	Levanta critérios de avaliação de especialistas de domínio e modos de falha para um sistema de IA (AI-SPEC.md §1b).	/msd-ai-integration-phase	advanced stub
msd-eval-planner	Projeta uma estratégia de avaliação estruturada para uma fase de IA (AI-SPEC.md §5–§7).	/msd-ai-integration-phase	advanced stub
msd-eval-auditor	Auditoria retroativa da cobertura de avaliação de uma fase de IA; produz EVAL-REVIEW.md (COVERED/PARTIAL/MISSING).	/msd-eval-review	advanced stub
msd-framework-selector	Matriz de decisão interativa com ≤6 perguntas que pontua e recomenda um framework de IA/LLM.	/msd-ai-integration-phase	advanced stub
msd-intel-updater	Escreve arquivos de intel estruturados (.planning/intel/*.json) usados como base de conhecimento consultável da base de código.	/msd-map-codebase --query	advanced stub
msd-doc-classifier	Classifica um único documento de planejamento como ADR, PRD, SPEC, DOC ou UNKNOWN; invocado em paralelo para processar o corpus de documentos.	/msd-ingest-docs	advanced stub
msd-doc-synthesizer	Sintetiza documentos de planejamento classificados em um único contexto consolidado com regras de precedência, detecção de ciclos e relatório de conflitos em três categorias.	/msd-ingest-docs	advanced stub

Nota de cobertura. docs/AGENTS.md fornece cartões de função completos para 21 agentes primários, além de stubs concisos para os 12 agentes avançados. O Resumo de Permissões de Ferramenta de Agente nesse arquivo cobre apenas os 21 agentes primários; as listas de ferramentas dos agentes avançados estão capturadas no frontmatter de cada agente em agents/msd-*.md.

---

Comandos (67 entregues)

Registro completo em commands/msd/*.md. Os agrupamentos abaixo espelham a ordem das seções de docs/COMMANDS.md; cada linha traz o nome do comando, uma função em uma linha derivada do description: do frontmatter do comando e um link para o arquivo-fonte. tests/command-count-sync.test.cjs trava a contagem contra o sistema de arquivos.

Meta-Skills de Namespace

Esses seis roteadores são entradas apenas descritivas que o modelo seleciona primeiro; o corpo de cada um contém uma tabela de roteamento que aponta para a sub-habilidade concreta correta. Eles existem para manter baixo o custo de tokens da listagem ansiosa de habilidades enquanto toda a superfície permanece acessível. Veja #2792 para a justificativa; as tabelas de roteamento apontam para a superfície consolidada pós-#2790.

Comando	Função	Fonte
/msd-workflow	Roteador de pipeline de fase — discuss / plan / execute / verify / phase / progress.	commands/msd/ns-workflow.md
/msd-project	Roteador de ciclo de vida do projeto — milestones, auditorias, resumo.	commands/msd/ns-project.md
/msd-quality	Roteador de portão de qualidade — revisão de código, debug, auditoria, segurança, avaliação, ui.	commands/msd/ns-review.md
/msd-context	Roteador de inteligência da base de código — map, graphify, docs, learnings.	commands/msd/ns-context.md
/msd-manage	Roteador de gerenciamento — config, workspace, workstreams, thread, update, ship, inbox.	commands/msd/ns-manage.md
/msd-ideate	Roteador de exploração e captura — explore, sketch, spike, spec, capture.	commands/msd/ns-ideate.md

Workflow Principal

Comando	Função	Fonte
/msd-new-project	Inicializa um novo projeto com coleta profunda de contexto e PROJECT.md.	commands/msd/new-project.md
/msd-onboard	Guia código existente por mapeamento, ingestão de docs, configuração de projeto e onboarding summary.	commands/msd/onboard.md
/msd-workspace	Gerencia workspaces MSD — criar (--new), listar (--list) ou remover (--remove) ambientes de workspace isolados.	commands/msd/workspace.md
/msd-discuss-phase	Coleta contexto da fase por meio de perguntas adaptativas antes do planejamento.	commands/msd/discuss-phase.md
/msd-mvp-phase	Planeja uma fase como uma fatia vertical de MVP — história de usuário, divisão SPIDR, depois plan-phase.	commands/msd/mvp-phase.md
/msd-spec-phase	Refinamento socrático de especificação produzindo um SPEC.md com requisitos falsificáveis.	commands/msd/spec-phase.md
/msd-ui-phase	Gera contrato de design de UI (UI-SPEC.md) para fases de frontend.	commands/msd/ui-phase.md
/msd-ai-integration-phase	Gera contrato de design de IA (AI-SPEC.md) via seleção de framework, pesquisa e planejamento de avaliação.	commands/msd/ai-integration-phase.md
/msd-plan-phase	Cria plano de fase detalhado (PLAN.md) com loop de verificação.	commands/msd/plan-phase.md
/msd-plan-review-convergence	Loop de convergência de plano entre IAs — replanejar com feedback de revisão até que não restem preocupações HIGH (máx. 3 ciclos).	commands/msd/plan-review-convergence.md
/msd-ultraplan-phase	[BETA] Delega a fase de planejamento ao ultraplan cloud do Claude Code — rascunhos remotamente, revisar no navegador, importar de volta via /msd-import. Apenas Claude Code.	commands/msd/ultraplan-phase.md
/msd-spike	Realiza um spike rápido de uma ideia com experimentos descartáveis; use --wrap-up para empacotar as descobertas como uma habilidade persistente.	commands/msd/spike.md
/msd-sketch	Esboça rapidamente ideias de UI/design usando mockups HTML descartáveis; use --wrap-up para empacotar as descobertas.	commands/msd/sketch.md
/msd-execute-phase	Executa todos os planos de uma fase com paralelização baseada em ondas.	commands/msd/execute-phase.md
/msd-verify-work	Valida funcionalidades construídas por meio de UAT conversacional com autodiagnóstico.	commands/msd/verify-work.md
/msd-ship	Cria PR, executa revisão e prepara para merge após verificação.	commands/msd/ship.md
/msd-fast	Executa uma tarefa trivial inline — sem subagentes, sem overhead de planejamento.	commands/msd/fast.md
/msd-quick	Executa uma tarefa rápida com garantias MSD (commits atômicos, rastreamento de estado) mas pula agentes opcionais.	commands/msd/quick.md
/msd-ui-review	Auditoria visual retroativa de 6 pilares do código frontend implementado.	commands/msd/ui-review.md
/msd-code-review	Revisa arquivos-fonte alterados durante uma fase em busca de bugs, segurança e problemas de qualidade de código; use --fix para aplicar as descobertas automaticamente.	commands/msd/code-review.md
/msd-eval-review	Audita retroativamente a cobertura de avaliação de uma fase de IA executada; produz EVAL-REVIEW.md.	commands/msd/eval-review.md

Gerenciamento de Fases e Milestones

Comando	Função	Fonte
/msd-phase	CRUD de fases — adicionar (padrão), inserir (--insert), remover (--remove) ou editar (--edit) fases no ROADMAP.md.	commands/msd/phase.md
/msd-add-tests	Gera testes para uma fase concluída com base nos critérios de UAT e na implementação.	commands/msd/add-tests.md
/msd-validate-phase	Audita retroativamente e preenche lacunas de validação Nyquist para uma fase concluída.	commands/msd/validate-phase.md
/msd-secure-phase	Verifica retroativamente as mitigações de ameaças para uma fase concluída.	commands/msd/secure-phase.md
/msd-audit-milestone	Audita a conclusão do milestone contra a intenção original antes do arquivamento.	commands/msd/audit-milestone.md
/msd-audit-uat	Auditoria entre fases de todos os itens de UAT e verificação pendentes.	commands/msd/audit-uat.md
/msd-audit-fix	Pipeline autônomo de auditoria para correção — encontrar problemas, classificar, corrigir, testar, commitar.	commands/msd/audit-fix.md
/msd-complete-milestone	Arquiva o milestone concluído e prepara para a próxima versão.	commands/msd/complete-milestone.md
/msd-new-milestone	Inicia um novo ciclo de milestone — atualizar PROJECT.md e rotear para os requisitos.	commands/msd/new-milestone.md
/msd-milestone-summary	Gera um resumo abrangente do projeto a partir dos artefatos do milestone.	commands/msd/milestone-summary.md
/msd-cleanup	Arquiva diretórios de fases acumulados de milestones concluídos.	commands/msd/cleanup.md
/msd-manager	Central de comando interativa para gerenciar múltiplas fases de um terminal.	commands/msd/manager.md
/msd-workstreams	Gerencia workstreams paralelos — listar, criar, alternar, status, progresso, concluir, retomar.	commands/msd/workstreams.md
/msd-autonomous	Executa todas as fases restantes de forma autônoma — discuss → plan → execute por fase.	commands/msd/autonomous.md
/msd-undo	Reversão git segura — reverter commits de fase ou plano usando o manifesto da fase.	commands/msd/undo.md

Sessão e Navegação

Comando	Função	Fonte
/msd-progress	Verifica o progresso do projeto, exibe contexto e roteia para a próxima ação; use --next para avançar automaticamente ou --do para executar uma tarefa de forma livre.	commands/msd/progress.md
/msd-capture	Captura ideias, tarefas, notas e seeds — todo (padrão), --note, --backlog, --seed ou --list de todos pendentes.	commands/msd/capture.md
/msd-stats	Exibe estatísticas do projeto — fases, planos, requisitos, métricas git, linha do tempo.	commands/msd/stats.md
/msd-pause-work	Cria handoff de contexto ao pausar o trabalho no meio de uma fase.	commands/msd/pause-work.md
/msd-resume-work	Retoma o trabalho da sessão anterior com restauração completa do contexto.	commands/msd/resume-work.md
/msd-explore	Ideação socrática e roteamento de ideias — pensar nas ideias antes de se comprometer.	commands/msd/explore.md
/msd-review-backlog	Revisa e promove itens do backlog para o milestone ativo.	commands/msd/review-backlog.md
/msd-thread	Gerencia threads de contexto persistentes para trabalho entre sessões.	commands/msd/thread.md

Inteligência da Base de Código

Comando	Função	Fonte
/msd-map-codebase	Analisa a base de código com agentes mapeadores paralelos; use --fast para varredura leve ou --query para consultas de intel.	commands/msd/map-codebase.md
/msd-graphify	Constrói, consulta e inspeciona o grafo de conhecimento do projeto em .planning/graphs/.	commands/msd/graphify.md
/msd-extract-learnings	Extrai decisões, lições, padrões e surpresas de artefatos de fases concluídas.	commands/msd/extract-learnings.md

Revisão, Debug e Recuperação

Comando	Função	Fonte
/msd-review	Solicita revisão de pares entre IAs de planos de fase a partir de CLIs de IA externos.	commands/msd/review.md
/msd-debug	Depuração sistemática com estado persistente entre resets de contexto.	commands/msd/debug.md
/msd-forensics	Investigação post-mortem de workflows MSD com falha — analisa git, artefatos, estado.	commands/msd/forensics.md
/msd-health	Diagnostica a integridade do diretório de planejamento e opcionalmente repara problemas.	commands/msd/health.md
/msd-import	Ingere planos externos com detecção de conflitos contra decisões do projeto.	commands/msd/import.md
/msd-inbox	Faz triagem e revisão de todas as issues e PRs abertas do GitHub contra os templates do projeto.	commands/msd/inbox.md

Documentação, Perfil e Utilitários

Comando	Função	Fonte
/msd-docs-update	Gera ou atualiza a documentação do projeto verificada contra a base de código.	commands/msd/docs-update.md
/msd-ingest-docs	Varre um repositório em busca de ADRs/PRDs/SPECs/DOCs mistos e inicializa ou mescla a configuração completa de .planning/ com classificação, síntese e relatório de conflitos.	commands/msd/ingest-docs.md
/msd-profile-user	Gera perfil comportamental do desenvolvedor e artefatos descobríveis pelo Claude.	commands/msd/profile-user.md
/msd-settings	Configura alternâncias de workflow MSD e perfil de modelo.	commands/msd/settings.md
/msd-config	Configura as definições MSD — alternâncias de workflow (padrão), parâmetros avançados (--advanced), integrações (--integrations) ou perfil de modelo (--profile).	commands/msd/config.md
/msd-pr-branch	Cria um branch limpo de PR filtrando commits de .planning/.	commands/msd/pr-branch.md
/msd-surface	Alterna quais habilidades são expostas — aplica um perfil, lista ou desativa um cluster sem reinstalar.	commands/msd/surface.md
/msd-update	Atualiza o MSD para a versão mais recente; use --sync para sincronizar habilidades entre runtimes ou --reapply para reaplicar patches locais.	commands/msd/update.md
/msd-help	Exibe os comandos MSD disponíveis e o guia de uso.	commands/msd/help.md

---

Workflows (88 entregues)

Registro completo em msd-core/workflows/*.md. Workflows são orquestradores enxutos que os comandos referenciam internamente; a maioria não é lida diretamente pelos usuários finais. As linhas abaixo mapeiam cada arquivo de workflow para sua função (derivada do bloco <purpose>) e, quando aplicável, para o comando que o invoca.

Workflow	Função	Invocado por
add-backlog.md	Adiciona um item de backlog ao ROADMAP.md usando numeração 999.x.	/msd-capture --backlog
add-phase.md	Adiciona uma nova fase inteira ao final do milestone atual no roadmap.	/msd-phase (padrão)
add-tests.md	Gera testes unitários e E2E para uma fase concluída com base em seus artefatos.	/msd-add-tests
add-todo.md	Captura uma ideia ou tarefa que surge durante uma sessão como um todo estruturado.	/msd-capture (padrão)
ai-integration-phase.md	Orquestra seleção de framework → pesquisa de IA → pesquisa de domínio → planejamento de avaliação no AI-SPEC.md.	/msd-ai-integration-phase
analyze-dependencies.md	Analisa as fases do ROADMAP.md para sobreposição de arquivos e dependências semânticas; sugere arestas Depends on.	/msd-manager --analyze-deps
audit-fix.md	Pipeline autônomo de auditoria para correção — executar auditoria, analisar, classificar, corrigir, testar, commitar.	/msd-audit-fix
audit-milestone.md	Verifica se o milestone atendeu sua definição de pronto ao agregar verificações de fase.	/msd-audit-milestone
audit-uat.md	Auditoria entre fases de arquivos de UAT e verificação; produz lista priorizada de itens pendentes.	/msd-audit-uat
autonomous.md	Conduz as fases do milestone de forma autônoma — todas restantes, um intervalo ou uma única fase.	/msd-autonomous
check-todos.md	Lista todos pendentes, permite seleção, carrega contexto e roteia para a ação apropriada.	/msd-capture --list
cleanup.md	Arquiva diretórios de fases acumulados de milestones concluídos.	/msd-cleanup
code-review-fix.md	Autocorrige problemas do REVIEW.md via msd-code-fixer com commits atômicos por correção.	/msd-code-review --fix
code-review.md	Revisa alterações de código-fonte da fase via msd-code-reviewer; produz REVIEW.md.	/msd-code-review
complete-milestone.md	Marca uma versão entregue como concluída — entrada no MILESTONES.md, evolução do PROJECT.md, tag.	/msd-complete-milestone
diagnose-issues.md	Orquestra agentes de debug paralelos para investigar lacunas de UAT e encontrar causas raiz.	/msd-verify-work (autodiagnóstico)
discuss-phase-assumptions.md	Discuss no modo de premissas — extrai decisões de implementação via análise com base no código primeiro.	/msd-discuss-phase (quando discuss_mode=assumptions)
discuss-phase-power.md	Discuss para usuário avançado — pré-gera todas as perguntas em um arquivo de estado JSON + UI HTML.	/msd-discuss-phase --power
discuss-phase.md	Extrai decisões de implementação por meio de discussão iterativa de zonas cinzentas.	/msd-discuss-phase
mvp-phase.md	Planeja uma fase como uma fatia vertical de MVP — história de usuário, divisão SPIDR, depois plan-phase.	/msd-mvp-phase
do.md	Roteia texto livre do usuário para o comando MSD mais adequado.	/msd-progress --do
docs-update.md	Gera, atualiza e verifica documentação canônica e escrita à mão do projeto.	/msd-docs-update
edit-phase.md	Edita qualquer campo de uma fase existente no ROADMAP.md no lugar, preservando número e posição.	/msd-phase --edit
eval-review.md	Auditoria retroativa da cobertura de avaliação de uma fase de IA implementada.	/msd-eval-review
execute-phase.md	Executa todos os planos de uma fase usando execução paralela baseada em ondas.	/msd-execute-phase
execute-plan.md	Executa um prompt de fase (PLAN.md) e cria o resumo do resultado (SUMMARY.md).	execute-phase.md (subagente por plano)
explore.md	Ideação socrática — guia o desenvolvedor por perguntas investigativas.	/msd-explore
debug.md	Depuração sistemática — roteamento de subcomandos, criação de sessão, delegação para msd-debug-session-manager.	/msd-debug
extract-learnings.md	Extrai decisões, lições, padrões e surpresas de artefatos de fases concluídas.	/msd-extract-learnings
fast.md	Executa uma tarefa trivial inline sem overhead de subagente.	/msd-fast
forensics.md	Investigação forense de workflows com falha — análise de git, artefatos e estado.	/msd-forensics
graduation.md	Agrupa itens recorrentes do LEARNINGS.md entre fases e levanta candidatos de promoção HITL.	transition.md (etapa graduation_scan)
health.md	Valida a integridade do diretório .planning/ e reporta problemas acionáveis.	/msd-health
help.md	Exibe a referência completa de comandos do MSD Core.	/msd-help
import.md	Ingere planos externos com detecção de conflitos contra decisões existentes do projeto.	/msd-import
inbox.md	Faz triagem de issues e PRs abertas do GitHub contra templates de contribuição do projeto.	/msd-inbox
ingest-docs.md	Varre um repositório em busca de documentos de planejamento mistos; classifica, sintetiza e inicializa ou mescla no .planning/ com um relatório de conflitos.	/msd-ingest-docs
insert-phase.md	Insere uma fase decimal para trabalho urgente descoberto no meio de um milestone.	/msd-phase --insert
list-phase-assumptions.md	Levanta as premissas do Claude sobre uma fase antes do planejamento.	/msd-discuss-phase --assumptions
list-workspaces.md	Lista todos os workspaces MSD encontrados em ~/msd-workspaces/ com seu status.	/msd-workspace --list
manager.md	Central de comando interativa de milestone — dashboard, discuss inline, plan/execute em segundo plano.	/msd-manager
map-codebase.md	Orquestra agentes mapeadores paralelos da base de código para produzir documentos em .planning/codebase/.	/msd-map-codebase
milestone-summary.md	Síntese do resumo do milestone — artefato de onboarding e revisão a partir dos artefatos do milestone.	/msd-milestone-summary
new-milestone.md	Inicia um novo ciclo de milestone — carregar contexto do projeto, coletar objetivos, atualizar PROJECT.md/STATE.md.	/msd-new-milestone
new-project.md	Fluxo unificado de novo projeto — questionamento, pesquisa (opcional), requisitos, roadmap.	/msd-new-project
onboard.md	Orquestração de onboarding brownfield — mapear código, ingerir docs, inicializar planning e resumir próximo passo.	/msd-onboard
new-workspace.md	Cria um workspace isolado com worktrees/clones do repositório e um .planning/ independente.	/msd-workspace --new
next.md	Detecta o estado atual do projeto e avança automaticamente para o próximo passo lógico.	/msd-progress --next
node-repair.md	Operador de reparo autônomo para verificação de tarefa com falha; invocado por execute-plan.	execute-plan.md (recuperação)
note.md	Captura de ideia sem atrito — uma chamada Write, uma linha de confirmação.	/msd-capture --note
pause-work.md	Cria os arquivos de handoff estruturados .planning/HANDOFF.json e .continue-here.md.	/msd-pause-work
plan-phase.md	Cria arquivos PLAN.md executáveis com pesquisa integrada e loop de verificação.	/msd-plan-phase, /msd-quick
plan-review-convergence.md	Loop de convergência de plano entre IAs — replanejar com feedback de revisão até que não restem preocupações HIGH.	/msd-plan-review-convergence
plant-seed.md	Captura uma ideia prospectiva como um arquivo de seed estruturado com condições de acionamento.	/msd-capture --seed
pr-branch.md	Cria um branch limpo para pull requests filtrando commits de .planning/.	/msd-pr-branch
profile-user.md	Orquestra o fluxo completo de perfil do desenvolvedor — consentimento, varredura de sessão, geração de perfil.	/msd-profile-user
progress.md	Renderização de progresso — contexto do projeto, posição e roteamento para próxima ação.	/msd-progress
quick.md	Execução de tarefa rápida com garantias MSD (commits atômicos, rastreamento de estado).	/msd-quick
reapply-patches.md	Reaaplica modificações locais após uma atualização do MSD.	/msd-update --reapply
remove-phase.md	Remove uma fase futura do roadmap e renumera as fases subsequentes.	/msd-phase --remove
remove-workspace.md	Remove um workspace MSD e limpa worktrees.	/msd-workspace --remove
resume-project.md	Retoma o trabalho — restaura o contexto completo do STATE.md, HANDOFF.json e artefatos.	/msd-resume-work
review.md	Revisão de plano entre IAs via CLIs externos; produz REVIEWS.md.	/msd-review
scan.md	Varredura rápida e focada da base de código — alternativa leve ao map-codebase.	/msd-map-codebase --fast
secure-phase.md	Auditoria retroativa de mitigação de ameaças para uma fase concluída.	/msd-secure-phase
session-report.md	Relatório de sessão — uso de tokens, resumo do trabalho, resultados.	/msd-pause-work --report
settings.md	Configura alternâncias de workflow MSD e perfil de modelo.	/msd-settings, /msd-config --profile
settings-advanced.md	Configura parâmetros avançados do MSD — bouncing de plano, timeouts, templates de branch, execução entre IAs, parâmetros de runtime.	/msd-config --advanced
settings-integrations.md	Configura chaves de API de terceiros (Brave/Firecrawl/Exa), roteamento de CLI review.models.<cli> e injeção de agent_skills.<agent-type> com exibição mascarada (****<last-4>).	/msd-config --integrations
ship.md	Cria PR, executa revisão e prepara para merge após verificação.	/msd-ship
sketch.md	Explora direções de design por meio de mockups HTML descartáveis com 2–3 variantes por sketch.	/msd-sketch
sketch-wrap-up.md	Curadoria das descobertas do sketch e empacotamento como uma habilidade persistente sketch-findings-[project].	/msd-sketch --wrap-up
spec-phase.md	Refinamento socrático de especificação com pontuação de ambiguidade; produz SPEC.md.	/msd-spec-phase
spike.md	Validação rápida de viabilidade por meio de experimentos focados e descartáveis.	/msd-spike
spike-wrap-up.md	Curadoria das descobertas do spike e empacotamento como uma habilidade persistente spike-findings-[project].	/msd-spike --wrap-up
stats.md	Renderização de estatísticas do projeto — fases, planos, requisitos, métricas git.	/msd-stats
sync-skills.md	Sincronização de habilidades MSD entre runtimes — diff e aplicação de diretórios de habilidades msd-* entre raízes de runtime.	/msd-update --sync
transition.md	Workflow de transição de limite de fase — verificações de workstream, avanço de estado.	execute-phase.md, /msd-progress --next
ui-phase.md	Gera contrato de design UI-SPEC.md via msd-ui-researcher.	/msd-ui-phase
ui-review.md	Auditoria visual retroativa de 6 pilares via msd-ui-auditor.	/msd-ui-review
ultraplan-phase.md	[BETA] Delega o planejamento ao ultraplan cloud do Claude Code; rascunhos remotamente e importa de volta via /msd-import.	/msd-ultraplan-phase
undo.md	Reversão git segura — commits de fase ou plano usando o manifesto da fase.	/msd-undo
thread.md	Cria, lista, fecha ou retoma threads de contexto persistentes para trabalho entre sessões.	/msd-thread
update.md	Atualiza o MSD para a versão mais recente com exibição do changelog.	/msd-update
validate-phase.md	Audita retroativamente e preenche lacunas de validação Nyquist para uma fase concluída.	/msd-validate-phase
verify-work.md	UAT conversacional com autodiagnóstico — produz UAT.md e planos de correção.	/msd-verify-work

Nota: Alguns workflows não têm comando direto voltado ao usuário (p. ex. execute-plan.md, transition.md, node-repair.md, diagnose-issues.md) — eles são invocados internamente por workflows orquestradores.

---

Referências (62 entregues)

Registro completo em msd-core/references/*.md. Referências são documentos de conhecimento compartilhado que workflows e agentes @-reference. Os agrupamentos abaixo correspondem a docs/ARCHITECTURE.md — clusters principais, de workflow, de modelo de raciocínio e a decomposição modular do planejador.

Referências Principais

Referência	Função
checkpoints.md	Definições de tipos de checkpoint e padrões de interação.
gates.md	4 tipos canônicos de portão (Confirm, Quality, Safety, Transition) conectados ao plan-checker e verifier.
model-profiles.md	Atribuições de nível de modelo por agente.
model-profile-resolution.md	Documentação do algoritmo de resolução de modelo.
verification-patterns.md	Como verificar diferentes tipos de artefato.
verification-overrides.md	Regras de substituição de verificação por artefato.
verifier-phase-gates.md	Gates de verificação carregados eager pelo msd-verifier (migrados do workflow verify-phase aposentado, #1892): validação de cobertura de decisões (#2492), auditoria de qualidade de testes, escopo de human-verification para fases de infraestrutura (#2504).
planning-config.md	Esquema completo de configuração e comportamento.
git-integration.md	Padrões de commit git, ramificação e histórico.
git-planning-commit.md	Convenções de commit do diretório de planejamento.
questioning.md	Filosofia de extração de sonhos para a inicialização do projeto.
tdd.md	Padrões de integração de desenvolvimento orientado a testes.
ui-brand.md	Padrões de formatação de saída visual.
common-bug-patterns.md	Padrões comuns de bugs para revisão de código e verificação.
debugger-philosophy.md	Disciplinas de depuração perenes carregadas pelo msd-debugger.
mandatory-initial-read.md	Boilerplate de leitura obrigatória compartilhado injetado nos prompts de agentes.
project-skills-discovery.md	Boilerplate de descoberta de habilidades do projeto injetado nos prompts de agentes.

Referências de Workflow

Referência	Função
agent-contracts.md	Interface formal entre orquestradores e agentes.
context-budget.md	Regras de alocação do orçamento da janela de contexto.
continuation-format.md	Formato de continuação/retomada de sessão.
domain-probes.md	Perguntas de sondagem específicas de domínio para a discuss-phase.
gate-prompts.md	Templates de prompt de portão/checkpoint.
scout-codebase.md	Tabela de seleção de tipo de fase → mapa de base de código para a etapa de scout da discuss-phase (extraída via a divisão progressiva discuss-phase/modes, #717).
revision-loop.md	Padrões de iteração de revisão de plano.
universal-anti-patterns.md	Antipadrões universais a detectar e evitar.
worktree-path-safety.md	Guardas de caminho do executor: pin de raiz fornecida (etapa 0p, #4254 — todo modo; o execute-phase.md binda a raiz validada pelo orquestrador em dispatches sequenciais como <project_root_pin>), sentinela de drift de cwd (etapa 0a, #3097) e guarda de caminho absoluto (etapa 0b, #3099) — carregados nos prompts de spawn do executor via <execution_context>.
artifact-types.md	Definições de tipos de artefato de planejamento.
phase-argument-parsing.md	Convenções de análise de argumentos de fase.
decimal-phase-calculation.md	Regras de numeração de subfases decimais.
workstream-flag.md	Convenções de ponteiro ativo de workstream (--ws).
user-profiling.md	Heurísticas de detecção de perfil comportamental do usuário.
thinking-partner.md	Ativação condicional do parceiro de raciocínio em pontos de decisão.
autonomous-smart-discuss.md	Lógica de smart-discuss para o modo autônomo.
ios-scaffold.md	Padrões de scaffolding de aplicativo iOS.
ai-evals.md	Referência de design de avaliação de IA para /msd-ai-integration-phase.
ai-frameworks.md	Referência da matriz de decisão de frameworks de IA para msd-framework-selector.
executor-examples.md	Exemplos resolvidos para o agente msd-executor.
doc-conflict-engine.md	Contrato compartilhado de detecção de conflitos para workflows de ingest/import.
execute-mvp-tdd.md	Semântica de portão de runtime para execute-phase em MVP+TDD — verificação de teste com falha pré-tarefa, revisão bloqueante no final da fase.
mvp-concepts.md	Índice de referência cruzada dos seis arquivos de referência relacionados a MVP; mapeia cada arquivo para sua finalidade e qual workflow o carrega.
verify-mvp-mode.md	Regras de enquadramento de UAT para fases em modo MVP — ordenação com fluxo de usuário primeiro, verificações técnicas adiadas, guarda de formato de história de usuário.

Referências de Sketch

Referências consumidas pelo workflow /msd-sketch e seu companion de wrap-up.

Referência	Função
sketch-interactivity.md	Regras para tornar os sketches HTML interativos e vivos.
sketch-theme-system.md	Sistema de variáveis de tema CSS compartilhado para consistência entre sketches.
sketch-tooling.md	Utilitários de barra de ferramentas flutuante incluídos em todo sketch.
sketch-variant-patterns.md	Padrões HTML de múltiplas variantes (abas, lado a lado, sobreposições).

Referências de Modelo de Raciocínio

Referências para integrar modelos de classe de raciocínio (o3, o4-mini, Gemini 2.5 Pro) em workflows MSD.

Referência	Função
thinking-models-debug.md	Padrões de modelo de raciocínio para workflows de debug.
thinking-models-execution.md	Padrões de modelo de raciocínio para agentes de execução.
thinking-models-planning.md	Padrões de modelo de raciocínio para agentes de planejamento.
thinking-models-research.md	Padrões de modelo de raciocínio para agentes de pesquisa.
thinking-models-verification.md	Padrões de modelo de raciocínio para agentes de verificação.

Decomposição Modular do Planejador

O agente msd-planner é decomposto em um agente principal mais módulos de referência para caber nos limites de caracteres do runtime.

Referência	Função
planner-antipatterns.md	Antipadrões do planejador e exemplos de especificidade.
planner-chunked.md	Formatos de retorno do modo chunked (## OUTLINE COMPLETE, ## PLAN COMPLETE) para mitigação do travamento de stdio no Windows.
planner-gap-closure.md	Comportamento do modo de fechamento de lacuna (lê VERIFICATION.md, replanejamento direcionado).
planner-reviews.md	Integração de revisão entre IAs (lê REVIEWS.md do /msd-review).
planner-revision.md	Padrões de revisão de plano para refinamento iterativo.
planner-source-audit.md	Regras de auditoria de fonte e limite de autoridade do planejador.
planner-mvp-mode.md	Regras de planejamento em fatia vertical para o modo MVP.
planner-human-verify-mode.md	Regras para workflow.human_verify_mode = end-of-phase: suprime a emissão de tarefas checkpoint:human-verify e roteia itens adiados via <verify><human-check>.
planner-graphify-auto-update.md	Como load_graph_context levanta o estado de atualização automática de .last-build-status.json (running / failed / stale head) junto com a anotação de desatualização existente. Opt-in via graphify.auto_update (#3347).
planner-interface-context.md	Regras de contexto de interface para executores — como extrair interfaces/tipos/exportações chave do código existente e documentar novas interfaces que planos subsequentes consumirão.
skeleton-template.md	Template do SKELETON.md emitido para o Walking Skeleton de novo projeto (Fase 1 + --mvp).
user-story-template.md	Formato de história de usuário para planejamento MVP — campos estruturados "Como / Quero / Para que".
spidr-splitting.md	Regras de decomposição de divisão SPIDR para lidar com histórias de usuário grandes no modo MVP.

Subdiretório: msd-core/references/few-shot-examples/ contém exemplos adicionais de few-shot (plan-checker.md, verifier.md) que são referenciados por agentes específicos. Estes não são contados nas 62 referências de nível superior.

---

Módulos de CLI (81 entregues)

Listagem completa: msd-core/bin/lib/*.cjs.

Módulo	Responsabilidade
active-workstream-store.cjs	Precedência de fonte e seleção de workstream (CLI --ws > env MSD_WORKSTREAM > ponteiro armazenado); validação de nome e propagação de ambiente
adr-parser.cjs	Analisador de decisão ADR para o caminho expresso de ingestão da plan-phase; normaliza sinônimos de seção, analisa cercas de status/decisão/escopo e aplica portões de rejeição de status
agent-command-router.cjs	Adaptador de roteador de subcomando CJS fino para msd-tools agent
artifacts.cjs	Registro canônico de artefatos — nomes de arquivos raiz conhecidos de .planning/; usado pelo lint W019 do msd-health
audit.cjs	Despacho de auditoria, sessões abertas de auditoria, auxiliares de armazenamento de auditoria
check-command-router.cjs	Adaptador de roteador de subcomando CJS fino para msd-tools check
cjs-command-router-adapter.cjs	Adaptador de compatibilidade compartilhado para roteadores de família de comandos CJS com suporte de manifesto
clock.cjs	Costura de relógio injetável (now/sleep) para teste determinístico de bloqueio
clusters.cjs	Definições de cluster de habilidades para o módulo de superfície de runtime (ADR-0011 Fase 2)
code-review-flags.cjs	Analisador de flags tipado para /msd-code-review; exporta parseCodeReviewFlags(argv) (→ { fix, all, auto, depth, files }) e resolveCodeReviewWorkflow(flags) (→ 'code-review.md' | 'code-review-fix.md'); costura de despacho canônica para roteamento de --fix/--all/--auto
command-aliases.cjs	Metadados de alias/subcomando para roteadores de família com suporte de manifesto
command-arg-projection.cjs	Auxiliares de projeção de flag tipada e argumento posicional compartilhados entre roteadores de família de comandos
command-routing-hub.cjs	Hub de despacho de resultado puro que centraliza a decisão de modo (SDK vs CJS), taxonomia de erros e contrato sem lançamento para todos os roteadores de família de comandos (#3788)
commands.cjs	Comandos CLI diversos (slug, timestamp, todos, scaffolding, stats)
config-schema.cjs	Fonte única de verdade para VALID_CONFIG_KEYS e padrões de chave dinâmica; importado tanto pelo validador quanto pelo teste de paridade config-schema-docs
config.cjs	Leitura/escrita de config.json, inicialização de seção; importa validador de config-schema.cjs
config-types.cjs	Definições de tipo TypeScript para o bloco de configuração model_policy — ModelPolicyConfig, TierEntry, RuntimeTiers; compilado de src/config-types.cts no momento da publicação (ADR-457)
configuration.cjs	Módulo de Configuração — carregamento canônico de configuração, normalização de chave legada, merge de padrões e migração explícita em disco; fonte de verdade para consumidores SDK e CJS
context-utilization.cjs	Classificador puro para msd-health --context — converte (tokensUsed, contextWindow) em um resultado de triagem { percent, state } contra os limiares de ponto de fratura de 60%/70% (#2792)
core.cjs	Tratamento de erros, formatação de saída, utilitários compartilhados, fallbacks de runtime; re-exportações de compatibilidade para auxiliares de planning-workspace
decisions.cjs	Analisa blocos <decisions> do CONTEXT.md; aceita IDs numéricos (D-42) e alfanuméricos (D-INFRA-01); retorna {id, text, category, tags, trackable}
docs.cjs	Inicialização do workflow docs-update, varredura de Markdown, detecção de monorepo
drift.cjs	Detector de drift estrutural pós-execução da base de código (#2003): classifica alterações de arquivo em categorias new-dir/barrel/migration/route e faz round-trip do frontmatter last_mapped_commit
fallow-runner.cjs	Adaptador de auditoria fallow para /msd-code-review: resolução binária (node_modules/.bin depois PATH), erros acionáveis de binário ausente e normalização de descobertas estruturais
frontmatter.cjs	Operações CRUD de frontmatter YAML
gap-checker.cjs	Análise de lacunas pós-planejamento (#2493): relatório unificado de cobertura de decisões do REQUIREMENTS.md + CONTEXT.md vs PLAN.md (msd-tools gap-analysis)
graphify.cjs	Build/consulta/status/diff do grafo de conhecimento para /msd-graphify
gsd2-import.cjs	Ingestão de plano externo para /msd-import --from-gsd2
init-command-router.cjs	Adaptador de roteador de subcomando CJS fino para msd-tools init
init.cjs	Carregamento de contexto composto para cada tipo de workflow
install-profiles.cjs	Lista de permissões de perfil de instalação + staging de habilidades para instalação --minimal (#2762); fonte única de verdade para quais habilidades/agentes msd-* ficam nos diretórios de configuração de runtime
installer-migration-authoring.cjs	Barreiras de autoria de migração do instalador para metadados de registro, escopos explícitos, evidência de propriedade e citações de contrato de runtime
installer-migration-report.cjs	Projeção de relatório de migração do instalador e guarda de ação bloqueada para integração de instalação/atualização
installer-migrations.cjs	Planejamento de migração do instalador, classificação de artefatos, persistência do estado de instalação, aplicação com journal e auxiliares de rollback
intel.cjs	Armazenamento de intel da base de código suportando /msd-map-codebase --query e msd-intel-updater
learnings.cjs	Extração de aprendizados entre fases para /msd-extract-learnings
milestone.cjs	Arquivamento de milestone, marcação de requisitos
model-catalog.cjs	Adaptador CJS sobre o JSON do catálogo de modelos compartilhado; exporta padrões canônicos de nível de runtime, mapas de perfil de agente, mapas de alias e metadados de roteamento para todos os consumidores de CLI
model-profiles.cjs	Auxiliares de perfil compatíveis com versões anteriores derivados de model-catalog.cjs; não possui mais sua própria tabela de modelos
package-identity.cjs	Fonte única gerada para as coordenadas do pacote publicado do MSD (nome npm, nome bin, slug do repositório, URL do changelog, comando de instalação manual), derivado do package.json; lido pelo worker de atualização, check-latest-version e instalador (#498)
phase-command-router.cjs	Adaptador de roteador de subcomando CJS fino para msd-tools phase
phase-lifecycle.cjs	Auxiliares de ciclo de vida de fase de computação pura extraídos do handler SDK de ciclo de vida de fase
phase.cjs	Operações de diretório de fase, numeração decimal, indexação de planos
phases-command-router.cjs	Adaptador de roteador de subcomando CJS fino para msd-tools phases
plan-scan.cjs	Scanner canônico de plano de fase para detectar arquivos de plano e resumo em layouts planos e aninhados (k014)
planning-workspace.cjs	Costura de caminho/workstream de planejamento (planningDir, planningPaths, roteamento de workstream ativo, orquestração de .planning/.lock)
project-root.cjs	Resolve uma raiz de projeto a partir de um diretório inicial usando quatro heurísticas (guarda de .planning/ próprio, config sub_repos, flag multiRepo, heurística .git)
profile-output.cjs	Renderização de perfil, geração de USER-PROFILE.md e dev-preferences.md
profile-pipeline.cjs	Pipeline de dados de perfil comportamental do usuário, varredura de arquivos de sessão
prompt-budget.cjs	Contabilidade pura de orçamento de tokens para prompts de revisão — estima tokens, aplica prioridade de corte determinística (redução de cabeça PROJECT.md, truncamento proporcional de plano, descarte de contexto/pesquisa/requisitos, guarda de falha rígida), retorna metadados estruturados para review.max_prompt_tokens (#3081)
review-reviewer-selection.cjs	Auxiliares de seleção/normalização de revisor para política de revisor padrão e precedência do /msd-review
roadmap-command-router.cjs	Adaptador de roteador de subcomando CJS fino para msd-tools roadmap
roadmap-upgrade.cjs	Ferramenta de migração para converter entradas legadas Phase N para a convenção prefixada de milestone Phase M-NN; computeMigrationPlan + applyMigration com padrão dry-run e rollback atômico
roadmap.cjs	Análise de ROADMAP.md, extração de fases, progresso de plano
runtime-artifact-layout.cjs	Módulo de layout de artefatos de runtime — resolve as formas do diretório de artefatos (comandos, agentes, habilidades) para cada runtime suportado; fonte única de verdade para posicionamento de artefatos por runtime (#3663)
runtime-name-policy.cjs	Política de normalização de nome de runtime — sanitização canônica de token para identificadores de runtime usados na construção de caminhos e exibição
runtime-homes.cjs	Mapeamento canônico de runtime → diretório de configuração/habilidades global; suporte de primeira classe para todos os runtimes suportados
runtime-slash.cjs	Formatador de comando slash com reconhecimento de runtime — fonte única de verdade para emitir /msd-<cmd> (runtimes baseados em habilidades) e $msd-<cmd> (codex) em saída voltada ao usuário e artefatos persistidos (#3584)
schema-detect.cjs	Detecção de drift de esquema para padrões ORM (Prisma, Drizzle, Supabase, TypeORM, Payload); exporta detectSchemaFiles, detectSchemaOrm, checkSchemaDrift, SCHEMA_PATTERNS, ORM_INFO
secrets.cjs	Convenção de mascaramento de configuração de segredo (****<last-4>) para chaves de integração; exporta SECRET_CONFIG_KEYS, isSecretKey, maskSecret, maskIfSecret
semver-compare.cjs	Auxiliares de política de comparação semver compartilhados (compareSemverCore, validação de tripla estável, análise de tupla normalizada) consumidos por hooks de verificação de atualização, detecção de instalação dev da linha de status e lógica de intervalo de extração de changeset (#10)
security.cjs	Prevenção de path traversal, detecção de injeção de prompt, auxiliares JSON/shell seguros
shell-command-projection.cjs	Projeção de comando shell com reconhecimento de runtime para serialização de hook gerenciado: decide o uso do operador de chamada PowerShell por runtime/plataforma e normaliza tokens de caminho de script Windows
state-command-router.cjs	Adaptador de roteador de subcomando CJS fino para msd-tools state
state.cjs	Análise, atualização, progressão e métricas do STATE.md
state-document.cjs	Extração de campo, substituição, normalização de status e transformações de cálculo de progresso puras do STATE.md
surface.cjs	Módulo de superfície de runtime — gerencia o estado de superfície de habilitação/desabilitação do runtime independentemente do marcador de perfil no momento da instalação (ADR-0011 Fase 2)
task-command-router.cjs	Adaptador de roteador de subcomando CJS fino para msd-tools task
template.cjs	Seleção e preenchimento de template com substituição de variáveis
uat.cjs	Análise de arquivo UAT, rastreamento de dívida de verificação, suporte audit-uat
ui-safety-gate.cjs	Detector de token de UI de limite de palavra sem shell (#3706, #3718); lê texto de seção de fase do stdin, sai com 0 (UI encontrada) ou 1 (sem UI); também implantado em msd-core/bin/lib/ para que o instalador MSD o entregue em $RUNTIME_DIR (#448)
update-context.cjs	Resolvedor de contexto de instalação puro para /msd-update — detecção de runtime/escopo/config-dir/versão (LOCAL/GLOBAL/UNKNOWN) portada do bash de update.md; sustenta msd-tools update-context (#498)
validate-command-router.cjs	Adaptador de roteador de subcomando CJS fino para msd-tools validate
validate.cjs	Auxiliares de normalização de variante de fase puros (phaseVariants, buildRoadmapPhaseVariants, buildNotStartedPhaseVariants) usados por verify.cjs para verificações W006/W007; sem I/O, sem async
verify-command-router.cjs	Adaptador de roteador de subcomando CJS fino para msd-tools verify
verify.cjs	Estrutura de plano, completude de fase, referência, validação de commit
workstream-inventory-builder.cjs	Construtor de projeção de inventário de workstream puro
workstream-inventory.cjs	Projeção de inventário de workstream compartilhada: campos de estado, contagens de fase/plano/resumo, contagem de fase do roadmap e marcador ativo — orquestrador fino que delega projeção pura para workstream-inventory-builder.cjs
workstream-name-policy.cjs	Validação canônica de nome de workstream (isValidActiveWorkstreamName, hasInvalidPathSegment, validateWorkstreamName) e normalização de slug (toWorkstreamSlug)
workstream.cjs	CRUD de workstream, migração, ponteiro ativo com escopo de sessão
worktree-safety.cjs	Resolução de raiz de worktree e decisões de política de poda não destrutiva; possui a lógica de verificação de integridade W017

docs/CLI-TOOLS.md pode descrever um subconjunto desses módulos; quando discordar do sistema de arquivos, esta tabela e a listagem de diretório são autoritativas.

---

Hooks (14 entregues)

Listagem completa: hooks/.

Hook	Evento	Finalidade
msd-statusline.js	statusLine	Exibe modelo, tarefa, diretório, uso de contexto
msd-context-monitor.js	PostToolUse / AfterTool	Injeta avisos de contexto voltados ao agente a 35%/25% de contexto restante
msd-check-update.js	SessionStart	Verificação em segundo plano de novas versões do MSD
msd-check-update-worker.js	(worker)	Auxiliar de worker em segundo plano para check-update
msd-update-banner.js	SessionStart	Banner opt-in que levanta a disponibilidade de atualização quando a statusline MSD não é usada (PR #2795)
msd-prompt-guard.js	PreToolUse	Varre escritas em .planning/ em busca de padrões de injeção de prompt (consultivo)
msd-workflow-guard.js	PreToolUse	Detecta edições de arquivo fora do contexto de workflow MSD (consultivo, opt-in)
msd-read-guard.js	PreToolUse	Guarda consultiva que impede Edit/Write em arquivos não lidos
msd-read-injection-scanner.js	PostToolUse	Varre resultados de Read de ferramenta em busca de padrões de injeção de prompt (v1.36+, PR #2201)
msd-worktree-path-guard.js	PreToolUse	Bloqueia rigorosamente Edit/Write/MultiEdit com caminhos absolutos fora da raiz do worktree (PR #579, #260)
msd-agent-isolation-guard.js	PreToolUse	Bloqueia rigorosamente um dispatch Agent() de executor que não tenha o parâmetro de isolamento do harness quando o isolamento de dispatch resolvido do projeto é harness-worktree (#3045)
msd-write-guard.js	PreToolUse	Bloqueia rigorosamente um Write de arquivo inteiro que encolhe catastroficamente um artefato curado de .planning/ (ROADMAP.md, roadmaps de milestone, STATE.md); override via o sentinela de uso único .planning/.msd-allow-shrink (passos de workflow) ou MSD_ALLOW_PLANNING_SHRINK=1 (interativo) (#2255, correção 3 de #973)
msd-secret-read-guard.js	PreToolUse	Bloqueia rigorosamente leituras de .env, .env.<suffix> (exceto templates como .env.example) e .secrets via Read / Grep / Bash; substitui as regras deny Read(.env*) que o instalador escrevia (#4221)
msd-session-state.sh	SessionStart	Rastreamento de estado de sessão para runtimes baseados em shell
msd-validate-commit.sh	PreToolUse	Validação de commit para aplicação de conventional-commit
msd-phase-boundary.sh	PostToolUse	Detecção de limite de fase para transições de workflow
msd-graphify-update.sh	PostToolUse	Reconstrução automática do grafo de conhecimento após o avanço do HEAD principal (opt-in, padrão desativado — #3347)

---

Manutenção

• Quando um novo comando, agente, workflow, referência, módulo de CLI ou hook for entregue, atualize a seção correspondente aqui antes que a versão seja liberada.
• Os testes de guarda de drift em tests/ (veja "Como Usar Este Arquivo" acima) asseguram que todo arquivo entregue está enumerado neste inventário. Um novo arquivo sem uma linha correspondente aqui falhará no CI.
• Quando o sistema de arquivos divergir das contagens de docs/ARCHITECTURE.md ou de documentações de subconjunto curado (p. ex. o registro primário do docs/AGENTS.md), este arquivo é a fonte de verdade.

Relacionados

• Comandos — referência de comandos voltados ao usuário
• Arquitetura — como as superfícies se encaixam
• índice de documentação