Receitas ECC

Um ponto de partida para "qual grupo de comandos 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 — associa uma tarefa a componentes, mas gera um único prompt, não um grupo de múltiplos 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 devo executar para <fluxo de trabalho>?"
• "Qual é a sequência de comandos para construir um MVP / corrigir um defeito / refatorar?"
• "Mostre todas as receitas de grupos de comandos ECC" (modo catálogo)
• "Quantos pipelines de fluxo de trabalho o ECC tem?"
• O usuário invoca /ecc-recipes com ou sem descrição.

Não Usar Quando

• O usuário quer que a tarefa seja feita 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 que um rascunho de prompt seja reescrito — use prompt-optimizer.

Princípio Central

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

Leituras ao Vivo

Resolva o diretório de comandos (o primeiro que existir), então 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 "No ECC commands directory found."; return 1; }
find "$CMD_DIR" -maxdepth 1 -name '*.md' -exec basename {} .md \; | sort

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

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

Agrupe nomes de comandos por prefixo inicial; mapeie singletons conhecidos manualmente. As famílias são derivadas ao vivo — a tabela abaixo é a regra de classificação, não uma lista congelada.

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. Live-read command names from CMD_DIR.
2. Classify into families by prefix and a singleton map.
3. If a workflow description was given -> MATCH MODE.
   If none -> CATALOG MODE.
4. Advisory only: print the plan. Never run the matched commands.

Modo Catálogo (sem descrição)

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

Modo de Correspondência (descrição fornecida)

1. Refaça o fluxo de trabalho em uma frase.
2. Escolha 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 correspondente.
4. Condição de parada — sempre explícita (max-execuções, sinal de conclusão, passes de revisão ou tiro único). Para loops autônomos, avise sobre o consumo de assinatura e recomende um limite de segurança.
5. Onde ler — o caminho commands/<name>.md mais /ecc-guide <name>.

Modelo de Saída (modo de correspondência)

…