Orquestrar Plano

Conecte um documento de plano à superfície de comandos de barra ECC atual emitindo um comando pronto para colar para cada etapa. Esta habilidade é apenas um roteador: ela escolhe o comando e preenche o formulário de argumento documentado do próprio comando. Ela não compõe cadeias de agentes e não influencia o que um comando executa internamente — cada comando possui seu próprio comportamento de execução. A habilidade é apenas generativa; ela nunca executa comandos. O usuário cola cada linha quando estiver pronto.

Quando Usar

• O usuário tem um documento de plano com várias etapas (PRD, RFC, plano de implementação) e deseja comandos prontos para colar para cada etapa.
• O usuário diz "transforme este plano em comandos", "qual comando devo executar para cada etapa", "orquestre este plano".
• Existe um plano passo a passo, mas o usuário não quer escolher manualmente um comando para cada etapa.

Pular quando:

• O trabalho é uma única etapa ad-hoc → execute o comando de barra apropriado diretamente (veja o catálogo abaixo).
• O plano é ilegível ou vazio. A falta de numeração explícita sozinha não é uma condição de pulo — veja o caso extremo "Sem etapas claras" abaixo.
• O plano deve ser executado autonomamente em segundo plano → prefira dmux-workflows ou os scripts nativos workflows/*.workflow.js em vez disso.

Entradas

<plan-doc-path> [--scope=all|step:<n>|range:<a>-<b>] [--dry-run]

• <plan-doc-path> — obrigatório; caminho relativo ou absoluto (@docs/... aceito).
• --scope — limita as etapas emitidas; padrão é all.
• --dry-run — imprime apenas a decomposição + a justificativa do comando; não emite comandos finais.

Regra de escopo — uma etapa só é emitida se o comando puder carregá-la

Todo comando emitido deve carregar a identidade e o escopo de sua etapa. Um comando aceita argumentos apenas na forma que seu próprio arquivo documenta (frontmatter argument-hint ou uma seção ## Usage; docs/COMMAND-REGISTRY.json é o índice gerado). A única forma que carrega uma etapa de plano é um argumento de descrição de tarefa em formato livre, pois esse argumento viaja com o comando quando ele é colado.

Comandos que carregam escopo — aceitam uma descrição de tarefa em formato livre:

Todo o resto falha fechado. Comandos cujos argumentos documentados não podem carregar escopo de plano — /build-fix, /test-coverage, /update-docs (nenhum formulário de argumento), /code-review (apenas [pr-number | pr-url | blank]), /security-scan (apenas flags [path] e de formato/severidade), /loop-start (apenas [pattern] e --mode) — nunca são emitidos. Uma etapa que se classifica para um deles é relatada como:

BLOCKED — /<command> cannot carry plan scope; run manually if wanted: <exact documented command form>

Etapas bloqueadas aparecem na visão geral e na saída por etapa e são excluídas do bloco de execução em Lote. Isso é deliberado: um /update-docs simples colado dentro de um lote de cinco etapas não tem um link legível por máquina para a etapa para a qual foi planejado. O usuário ainda pode executar o comando manualmente; o roteador apenas se recusa a apresentar um comando sem escopo como se a etapa tivesse sido orquestrada.

Esta tabela é um instantâneo validado dos arquivos de comando, não uma fonte de verdade independente. tests/skills/plan-orchestrate-registry.test.js valida cada comando nomeado aqui contra commands/<name>.md e docs/COMMAND-REGISTRY.json e falha quando eles discordam. Se um arquivo de comando e esta habilidade discordarem em tempo de execução, o arquivo de comando vence. Um comando que foi aposentado do commands/ falha fechado como um comando sem argumentos — a etapa é relatada BLOCKED e o roteador nunca emite um nome que a superfície de comando não tenha mais.

Descrição da tarefa (apenas comandos que carregam escopo)

Para comandos que carregam escopo, cada <task description> emitido deve:

• Ser autônomo (o comando não precisa do documento do plano aberto).
• Começar com [Plan: <path>#step-<id>] — este marcador é o link legível por máquina da etapa.
• Incluir 1–3 critérios de aceitação verificáveis.
• Incluir um guarda de Escopo (Out of scope: ...) apenas se o plano declarar um para esta etapa. Herdar literalmente. Se o plano não tiver uma declaração fora do escopo, omita a cláusula inteiramente — não invente uma.
• Ter entre 200–600 caracteres; uma linha; " embutido escapado como \"; sem novas linhas literais.

…