ecc-recipes

Receitas ECC

Um ponto de entrada para "qual grupo de comandos-barra ECC executa meu fluxo de trabalho, em que ordem e quando devo parar." Também navega por todas as famílias de receitas de grupos de comandos.

Preenche a lacuna entre duas habilidades existentes:

• ecc-guide — lista comandos e onde ler a documentação, mas como um catálogo plano.
• prompt-optimizer — combina uma tarefa com componentes, mas gera um único prompt, não um grupo de vários comandos com ordem de execução e condição de parada.

Esta habilidade adiciona: agrupamento por família + ordem de execução + condição de parada.

Quando Ativar

• "Qual grupo de comandos executo para ?"
• "Qual é a sequência de comandos para construir um MVP / corrigir um defeito / refatorar?"
• "Mostre-me todas as receitas de grupos de comandos ECC" (modo catálogo)
• "Quantos pipelines de fluxo o ECC tem?"
• Usuário invoca /ecc-recipes com ou sem uma descrição.

Não Usar Quando

• O usuário quer a tarefa executada agora — direcione para o comando real, não o descreva.
• O usuário quer documentação aprofundada para UM comando — use ecc-guide.
• O usuário quer reescrever um rascunho de prompt — use prompt-optimizer.

Princípio Central

Responder a partir dos arquivos atuais, não da memória. O conjunto de comandos muda; nunca codifique contagens ou listas de membros. Leia o diretório commands/ ativo a cada execução e classifique em famílias.

Leituras em tempo real

Resolva o diretório de comandos (o primeiro que existir) e liste os nomes:

for D in \
  "$HOME"/.claude/plugins/marketplaces/ecc/commands \
  "$HOME"/.claude/plugins/cache/ecc/ecc/*/commands \
  ./commands \
  ./.claude/commands \
  "$HOME"/.claude/commands; do
  [ -d "$D" ] && CMD_DIR="$D" && break
done
[ -z "${CMD_DIR:-}" ] && { echo "Nenhum diretório de comandos ECC encontrado."; return 1; }
find "$CMD_DIR" -maxdepth 1 -name '*.md' -exec basename {} .md \; | sort

Opcionalmente, leia manifests/install-*.json se presente para agrupamento mais rico. Use o menor conjunto de leituras necessário.

Classificação por Família (por prefixo)

Agrupe nomes de comandos pelo prefixo principal; mapeie singletons conhecidos manualmente. As famílias são derivadas em tempo real — a tabela abaixo é a regra de classificação, não uma lista congelada.

Prefixo da família	Significado da receita	Ordem de execução típica
orch-*	Pesquisa, Planejamento, TDD, Revisão, Commit por tipo de tarefa	escolha um orch-* pelo tipo de tarefa; ele executa suas próprias fases internas
multi-*	Fluxo de trabalho multimodelo	multi-plan depois multi-execute depois revisão (ou multi-workflow ponta a ponta)
prp-*	Pipeline de PRD para plano para implementação para PR	prp-prd depois prp-plan depois prp-implement depois prp-commit depois prp-pr
epic-*	Épica grande com múltiplas unidades, paralela	epic-decompose depois epic-claim depois epic-validate depois epic-review depois epic-unblock depois epic-sync depois epic-publish
loop-*	Loop autônomo gerenciado e monitor	loop-start <padrão> depois acompanhe com loop-status
gan-*	Loop de gerador e avaliador	gan-build (código) ou gan-design (UI); auto-loop
*-build / *-review / *-test	Tríade CI por linguagem	<lang>-test (TDD) depois <lang>-build (corrigir) depois <lang>-review
hookify-*	Gerenciamento de hooks de comportamento	hookify depois hookify-list depois hookify-configure
learn / instinct-* / evolve / promote / prune	Aprendizado contínuo	learn depois instinct-status depois evolve depois promote
singletons	santa-loop, plan, plan-prd, pr, code-review, checkpoint, etc.	independentes ou cola entre grupos

Qualquer comando que não corresponda a uma regra de prefixo → liste-o em singletons com sua descrição de uma linha.

Como Funciona

1. Leia em tempo real os nomes dos comandos de CMD_DIR.
2. Classifique em famílias por prefixo e um mapa de singletons.
3. Se uma descrição de fluxo foi fornecida -> MODO COMBINAÇÃO.
   Se nenhuma -> MODO CATÁLOGO.
4. Apenas consultivo: exiba o plano. Nunca execute os comandos combinados.

Modo catálogo (sem descrição)

Gere a tabela de famílias: cada família, contagem de membros, membros, significado em uma linha, ordem de execução típica. Termine com a contagem total de comandos e um prompt para descrever um fluxo para uma receita combinada.

Modo combinação (descrição fornecida)

1. Reafirme o fluxo em uma frase.
2. Selecione as 1-2 melhores famílias; diga POR QUÊ em uma linha cada.
3. Bloco de ordem de execução — sequência exata de comandos para a família combinada.
4. Condição de parada — sempre explícita (máximo de execuções, sinal de conclusão, aprovações de revisão ou execução única). Para loops autônomos, avise sobre consumo de créditos/assinatura e recomende um limite de segurança.
5. Onde ler — o caminho commands/<nome>.md mais /ecc-guide <nome>.

Modelo de Saída (modo combinação)

Fluxo: <reafirmação em uma frase>

Melhor ajuste: <família> — <porquê>
(Alt: <família> — <porquê>)

Ordem de execução:
  /<cmd1>   # tarefa
  /<cmd2>   # tarefa
  /<cmd3>   # tarefa
  PARAR quando: <condição>
  AVISO (apenas loops autônomos): um loop ilimitado consome assinatura/créditos —
  adicione um limite de iteração máxima ou custo máximo junto com o sinal de conclusão.

Leia a documentação completa:
  commands/<cmd1>.md   (ou: /ecc-guide <cmd1>)

Exemplos

Catálogo: /ecc-recipes → exibe a tabela de famílias e a contagem total.

Combinação: /ecc-recipes planejar um aplicativo inteiro antecipadamente e depois construir automaticamente com revisão adversarial até concluir → Melhor ajuste: loop-* (autônomo) envolvendo gan-* ou santa-loop (adversarial). Ordem de execução: plan-prd depois loop-start rfc-dag --mode safe depois monitorar loop-status; PARAR quando todas as unidades passarem na revisão N vezes consecutivas (adicione um limite de iteração máxima para conter o consumo).

Combinação: /ecc-recipes corrigir um bug no meu serviço Go → Melhor ajuste: orch-fix-defect (reproduzir, corrigir, revisar, commitar). Alt: go-test depois go-build depois go-review. PARAR: teste de regressão verde e aprovação na revisão.

Não Metas

• Não é um executor — apenas consultivo.
• Não é documentação aprofundada por comando — isso é ecc-guide.
• Não é reescrita de prompt — isso é prompt-optimizer.
• Nunca codificar contagens de comandos ou listas de membros — sempre ler em tempo real.