Entrada do Usuário
$ARGUMENTS
Você DEVE considerar a entrada do usuário antes de prosseguir (se não estiver vazia).
Verificações de Pré-Execução
Verifique por ganchos de extensão (antes do planejamento):
- Verifique se
.specify/extensions.ymlexiste na raiz do projeto. - Se existir, leia-o e procure por entradas sob a chave
hooks.before_plan. - Se o YAML não puder ser analisado ou for inválido, não pule silenciosamente: informe ao usuário que
.specify/extensions.ymlnão pôde ser lido (inclua o erro do analisador) e que nenhum gancho foi verificado, incluindo quaisquer ganchos obrigatórios (optional: false) registrados lá, e continue normalmente. - Filtre os ganchos onde
enabledestá explicitamentefalse. Trate ganchos sem o campoenabledcomo habilitados por padrão. - Para cada gancho restante, não tente interpretar ou avaliar expressões de
conditiondo gancho:- Se o gancho não tiver o campo
condition, ou ele for nulo/vazio, trate o gancho como executável. - Se o gancho definir uma
conditionnão vazia, pule o gancho e deixe a avaliação da condição para a implementação do HookExecutor.
- Se o gancho não tiver o campo
- Ao construir invocações de comando a partir de nomes de comando de gancho, substitua pontos (
.) por hífens (-). Por exemplo,speckit.git.commit→/speckit-git-commit. - Para cada gancho executável, produza o seguinte com base em sua flag
optional:- Gancho opcional (
optional: true):## Ganchos de Extensão **Gancho Pré-Hook Opcional**: {extensão} Comando: `/{comando}` Descrição: {descrição} Prompt: {prompt} Para executar: `/{comando}` - Gancho obrigatório (
optional: false):
Após emitir o bloco acima, você DEVE realmente invocar o gancho e aguardar sua conclusão antes de continuar. Execute-o da mesma forma que você executaria o comando neste agente/sessão (a invocação pode diferir do literal## Ganchos de Extensão **Gancho Pré-Hook Automático**: {extensão} Executando: `/{comando}` EXECUTE_COMMAND: {comando} Aguarde o resultado do comando do gancho antes de prosseguir para o Esboço.{comando}mostrado acima, por exemplo, um agente em modo skills executa como/skill:speckit-...ou$speckit-...). Apenas emitir o bloco não executa o gancho.
- Gancho opcional (
- Se nenhum gancho estiver registrado ou
.specify/extensions.ymlnão existir, pule silenciosamente.
Esboço
-
Configuração: Execute
.specify/scripts/bash/setup-plan.sh --jsonda raiz do repositório e analise o JSON para FEATURE_SPEC, IMPL_PLAN, FEATURE_DIR, BRANCH. Para aspas simples em argumentos como "Eu sou o Groot", use sintaxe de escape: por exemplo 'Eu'''sou o Groot' (ou aspas duplas, se possível: "Eu sou o Groot"). -
Carregar contexto: Leia FEATURE_SPEC e
.specify/memory/constitution.md. Carregue o modelo IMPL_PLAN (já copiado). -
Executar fluxo de trabalho do plano: Siga a estrutura no modelo IMPL_PLAN para:
- Preencher o Contexto Técnico (marque desconhecidos como "PRECISA DE ESCLARECIMENTO")
- Preencher a seção Verificação Constitucional a partir da constituição
- Avaliar portões (ERROR se violações injustificadas)
- Fase 0: Gerar research.md (resolver todos os PRECISA DE ESCLARECIMENTO)
- Fase 1: Gerar data-model.md, contracts/, quickstart.md
- Reavaliar Verificação Constitucional pós-design
Ganchos de Pós-Execução Obrigatórios
Você DEVE concluir esta seção antes de relatar a conclusão ao usuário.
Verifique se .specify/extensions.yml existe na raiz do projeto.
- Se não existir, ou se nenhum gancho estiver registrado sob
hooks.after_plan, pule para o Relatório de Conclusão. - Se existir, leia-o e procure por entradas sob a chave
hooks.after_plan. - Se o YAML não puder ser analisado ou for inválido, não pule silenciosamente: informe ao usuário que
.specify/extensions.ymlnão pôde ser lido (inclua o erro do analisador) e que nenhum gancho foi verificado, incluindo quaisquer ganchos obrigatórios (optional: false) registrados lá, e continue para o Relatório de Conclusão. - Filtre os ganchos onde
enabledestá explicitamentefalse. Trate ganchos sem o campoenabledcomo habilitados por padrão. - Para cada gancho restante, não tente interpretar ou avaliar expressões de
conditiondo gancho:- Se o gancho não tiver o campo
condition, ou ele for nulo/vazio, trate o gancho como executável. - Se o gancho definir uma
conditionnão vazia, pule o gancho e deixe a avaliação da condição para a implementação do HookExecutor.
- Se o gancho não tiver o campo
- Ao construir invocações de comando a partir de nomes de comando de gancho, substitua pontos (
.) por hífens (-). Por exemplo,speckit.git.commit→/speckit-git-commit. - Para cada gancho executável, produza o seguinte com base em sua flag
optional:- Gancho obrigatório (
optional: false) — Você DEVE emitirEXECUTE_COMMAND:para cada gancho obrigatório:
Após emitir o bloco acima, você DEVE realmente invocar o gancho e aguardar sua conclusão antes de continuar. Execute-o da mesma forma que você executaria o comando neste agente/sessão (a invocação pode diferir do literal## Ganchos de Extensão **Gancho Automático**: {extensão} Executando: `/{comando}` EXECUTE_COMMAND: {comando}{comando}mostrado acima, por exemplo, um agente em modo skills executa como/skill:speckit-...ou$speckit-...). Apenas emitir o bloco não executa o gancho. - Gancho opcional (
optional: true):## Ganchos de Extensão **Gancho Opcional**: {extensão} Comando: `/{comando}` Descrição: {descrição} Prompt: {prompt} Para executar: `/{comando}`
- Gancho obrigatório (
Relatório de Conclusão
O comando termina após o design da Fase 1. Relate o branch, o caminho do IMPL_PLAN e os artefatos gerados.
Fases
Fase 0: Esboço e Pesquisa
-
Extraia desconhecidos do Contexto Técnico acima:
- Para cada PRECISA DE ESCLARECIMENTO → tarefa de pesquisa
- Para cada dependência → tarefa de melhores práticas
- Para cada integração → tarefa de padrões
-
Gere e despache agentes de pesquisa:
Para cada desconhecido no Contexto Técnico: Tarefa: "Pesquisar {desconhecido} para {contexto da funcionalidade}" Para cada escolha de tecnologia: Tarefa: "Encontrar melhores práticas para {tecnologia} em {domínio}" -
Consolide os resultados em
research.mdusando o formato:- Decisão: [o que foi escolhido]
- Justificativa: [por que foi escolhido]
- Alternativas consideradas: [o que mais foi avaliado]
Saída: research.md com todos os PRECISA DE ESCLARECIMENTO resolvidos
Fase 1: Design e Contratos
Pré-requisitos: research.md completo
-
Extraia entidades da especificação da funcionalidade →
data-model.md:- Nome da entidade, campos, relacionamentos
- Regras de validação a partir dos requisitos
- Transições de estado, se aplicável
-
Defina contratos de interface (se o projeto tiver interfaces externas) →
/contracts/:- Identifique quais interfaces o projeto expõe para usuários ou outros sistemas
- Documente o formato de contrato apropriado para o tipo de projeto
- Exemplos: APIs públicas para bibliotecas, esquemas de comando para ferramentas CLI, endpoints para serviços web, gramáticas para parsers, contratos de UI para aplicações
- Pule se o projeto for puramente interno (scripts de build, ferramentas descartáveis, etc.)
-
Crie um guia de validação quickstart →
quickstart.md:- Documente cenários de validação executáveis que provem que a funcionalidade funciona de ponta a ponta
- Inclua pré-requisitos, comandos de configuração, comandos de teste/execução e resultados esperados
- Use links ou referências para contratos e detalhes do modelo de dados em vez de duplicá-los
- Não inclua código de implementação completo, corpos de modelos/serviços/controladores, migrações ou suítes de teste completas
- Mantenha este artefato como um guia de validação/execução; os detalhes de implementação pertencem a
tasks.mde à fase de implementação
Saída: data-model.md, /contracts/*, quickstart.md
Regras-chave
- Use caminhos absolutos para operações de sistema de arquivos; use caminhos relativos ao projeto para referências na documentação
- ERROR em falhas de portão ou esclarecimentos não resolvidos
Feito Quando
- Fluxo de trabalho do plano executado e artefatos de design gerados
- Ganchos de extensão despachados ou pulados de acordo com as regras em Ganchos de Pós-Execução Obrigatórios acima
- Conclusão reportada ao usuário com branch, caminho do plano e artefatos gerados