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
Verificar hooks de extensão (antes da geração de tarefas):
- Verifique se
.specify/extensions.ymlexiste na raiz do projeto. - Se existir, leia-o e procure por entradas sob a chave
hooks.before_tasks. - Se o YAML não puder ser analisado ou for inválido, não ignore silenciosamente: informe ao usuário que
.specify/extensions.ymlnão pôde ser lido (inclua o erro do analisador) e que nenhum hook foi verificado, incluindo quaisquer hooks obrigatórios (optional: false) registrados ali, depois continue normalmente. - Filtre hooks onde
enabledé explicitamentefalse. Trate hooks sem um campoenabledcomo habilitados por padrão. - Para cada hook restante, não tente interpretar ou avaliar expressões de
conditiondo hook:- Se o hook não tiver um campo
condition, ou ele for nulo/vazio, trate o hook como executável. - Se o hook definir uma
conditionnão vazia, pule o hook e deixe a avaliação da condição para a implementação do HookExecutor.
- Se o hook não tiver um campo
- Ao construir invocações de comando a partir de nomes de comando de hook, substitua pontos (
.) por hífens (-). Por exemplo,speckit.git.commit→/speckit-git-commit. - Para cada hook executável, produza a seguinte saída com base em sua flag
optional:- Hook opcional (
optional: true):## Extension Hooks **Pre-Hook Opcional**: {extension} Comando: `/{command}` Descrição: {description} Prompt: {prompt} Para executar: `/{command}` - Hook obrigatório (
optional: false):
Após emitir o bloco acima, você DEVE realmente invocar o hook 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## Extension Hooks **Pre-Hook Automático**: {extension} Executando: `/{command}` EXECUTE_COMMAND: {command} Aguarde o resultado do comando do hook antes de prosseguir para o Esboço.{command}literal mostrado acima, por exemplo, um agente em modo skills o executa como/skill:speckit-...ou$speckit-...). Apenas emitir o bloco não executa o hook.
- Hook opcional (
- Se nenhum hook estiver registrado ou
.specify/extensions.ymlnão existir, ignore silenciosamente.
Esboço
-
Configuração: Execute
.specify/scripts/bash/setup-tasks.sh --jsona partir da raiz do repositório e analise FEATURE_DIR, TASKS_TEMPLATE_CONTENT, TASKS_TEMPLATE e AVAILABLE_DOCS.FEATURE_DIReTASKS_TEMPLATEdevem ser caminhos absolutos quando fornecidos.AVAILABLE_DOCSé uma lista de nomes de documentos/caminhos relativos disponíveis emFEATURE_DIR(por exemplo,research.mdoucontracts/). Para aspas simples em argumentos como "I'm Groot", use sintaxe de escape: por exemplo, 'I'''m Groot' (ou aspas duplas se possível: "I'm Groot"). -
Carregar documentos de design: Leia de FEATURE_DIR:
- Obrigatório: plan.md (stack tecnológica, bibliotecas, estrutura), spec.md (histórias de usuário com prioridades).
- Opcional: data-model.md (entidades), contracts/ (contratos de interface), research.md (decisões), quickstart.md (cenários de teste).
- SE EXISTIR: Carregue
.specify/memory/constitution.mdpara princípios do projeto e restrições de governança. - Nota: Nem todos os projetos têm todos os documentos. Gere tarefas com base no que estiver disponível.
-
Executar o fluxo de trabalho de geração de tarefas:
- Carregue plan.md e extraia stack tecnológica, bibliotecas, estrutura do projeto.
- Carregue spec.md e extraia histórias de usuário com suas prioridades (P1, P2, P3, etc.).
- Se data-model.md existir: Extraia entidades e mapeie para histórias de usuário.
- Se contracts/ existir: Mapeie contratos de interface para histórias de usuário.
- Se research.md existir: Extraia decisões para tarefas de configuração.
- Gere tarefas organizadas por história de usuário (veja Regras de Geração de Tarefas abaixo).
- Gere o grafo de dependências mostrando a ordem de conclusão das histórias de usuário.
- Crie exemplos de execução paralela por história de usuário.
- Valide a completude das tarefas (cada história de usuário tem todas as tarefas necessárias, testáveis independentemente).
-
Gerar tasks.md: Use TASKS_TEMPLATE_CONTENT (da saída JSON acima) como estrutura. Para compatibilidade com scripts de configuração mais antigos que omitem TASKS_TEMPLATE_CONTENT, leia TASKS_TEMPLATE em vez disso. Preencha com:
- Nome correto da funcionalidade de plan.md.
- Fase 1: Tarefas de configuração (inicialização do projeto).
- Fase 2: Tarefas fundamentais (pré-requisitos bloqueantes para todas as histórias de usuário).
- Fase 3+: Uma fase por história de usuário (em ordem de prioridade de spec.md).
- Cada fase inclui: objetivo da história, critérios de teste independentes, testes (se solicitados), tarefas de implementação.
- Fase Final: Polimento e preocupações transversais.
- Todas as tarefas devem seguir o formato rigoroso de lista de verificação (veja Regras de Geração de Tarefas abaixo).
- Caminhos de arquivo claros para cada tarefa.
- Seção de dependências mostrando ordem de conclusão das histórias.
- Exemplos de execução paralela por história.
- Seção de estratégia de implementação (MVP primeiro, entrega incremental).
Hooks 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 nenhum hook estiver registrado sob a chave
hooks.after_tasks, pule para o Relatório de Conclusão. - Se existir, leia-o e procure por entradas sob a chave
hooks.after_tasks. - Se o YAML não puder ser analisado ou for inválido, não ignore silenciosamente: informe ao usuário que
.specify/extensions.ymlnão pôde ser lido (inclua o erro do analisador) e que nenhum hook foi verificado, incluindo quaisquer hooks obrigatórios (optional: false) registrados ali, depois continue para o Relatório de Conclusão. - Filtre hooks onde
enabledé explicitamentefalse. Trate hooks sem um campoenabledcomo habilitados por padrão. - Para cada hook restante, não tente interpretar ou avaliar expressões de
conditiondo hook:- Se o hook não tiver um campo
condition, ou ele for nulo/vazio, trate o hook como executável. - Se o hook definir uma
conditionnão vazia, pule o hook e deixe a avaliação da condição para a implementação do HookExecutor.
- Se o hook não tiver um campo
- Ao construir invocações de comando a partir de nomes de comando de hook, substitua pontos (
.) por hífens (-). Por exemplo,speckit.git.commit→/speckit-git-commit. - Para cada hook executável, produza a seguinte saída com base em sua flag
optional:- Hook obrigatório (
optional: false) — Você DEVE emitirEXECUTE_COMMAND:para cada hook obrigatório:
Após emitir o bloco acima, você DEVE realmente invocar o hook 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## Extension Hooks **Hook Automático**: {extension} Executando: `/{command}` EXECUTE_COMMAND: {command}{command}literal mostrado acima, por exemplo, um agente em modo skills o executa como/skill:speckit-...ou$speckit-...). Apenas emitir o bloco não executa o hook. - Hook opcional (
optional: true):## Extension Hooks **Hook Opcional**: {extension} Comando: `/{command}` Descrição: {description} Prompt: {prompt} Para executar: `/{command}`
- Hook obrigatório (
Relatório de Conclusão
Caminho de saída para tasks.md gerado e resumo:
- Contagem total de tarefas.
- Contagem de tarefas por história de usuário.
- Oportunidades paralelas identificadas.
- Critérios de teste independentes para cada história.
- Escopo MVP sugerido (tipicamente apenas a História de Usuário 1).
- Validação de formato: Confirme que TODAS as tarefas seguem o formato de lista de verificação (caixa de seleção, ID, rótulos, caminhos de arquivo).
Contexto para geração de tarefas: $ARGUMENTS
O tasks.md deve ser imediatamente executável — cada tarefa deve ser específica o suficiente para que um LLM possa completá-la sem contexto adicional.
Regras de Geração de Tarefas
CRÍTICO: Tarefas DEVEM ser organizadas por história de usuário para permitir implementação e teste independentes.
Testes são OPCIONAIS: Gere tarefas de teste apenas se explicitamente solicitado na especificação da funcionalidade ou se o usuário solicitar abordagem TDD.
Formato de Lista de Verificação (OBRIGATÓRIO)
Cada tarefa DEVE seguir estritamente este formato:
- [ ] [TaskID] [P?] [Story?] Descrição com caminho do arquivo
Componentes do Formato:
- Caixa de seleção: SEMPRE comece com
- [ ](caixa de seleção markdown). - ID da Tarefa: Número sequencial (T001, T002, T003...) em ordem de execução.
- Marcador [P]: Inclua APENAS se a tarefa for paralelizável (arquivos diferentes, sem dependências de tarefas incompletas).
- Rótulo [Story]: OBRIGATÓRIO para tarefas da fase de história de usuário apenas.
- Formato: [US1], [US2], [US3], etc. (mapeia para histórias de usuário de spec.md).
- Fase de configuração: SEM rótulo de história.
- Fase fundamental: SEM rótulo de história.
- Fases de história de usuário: DEVEM ter rótulo de história.
- Fase de polimento: SEM rótulo de história.
- Descrição: Ação clara com caminho exato do arquivo.
Exemplos:
- ✅ CORRETO:
- [ ] T001 Criar estrutura do projeto conforme plano de implementação - ✅ CORRETO:
- [ ] T005 [P] Implementar middleware de autenticação em src/middleware/auth.py - ✅ CORRETO:
- [ ] T012 [P] [US1] Criar modelo User em src/models/user.py - ✅ CORRETO:
- [ ] T014 [US1] Implementar UserService em src/services/user_service.py - ❌ ERRADO:
- [ ] Criar modelo User(faltando ID e rótulo de história) - ❌ ERRADO:
T001 [US1] Criar modelo(faltando caixa de seleção) - ❌ ERRADO:
- [ ] [US1] Criar modelo User(faltando ID da tarefa) - ❌ ERRADO:
- [ ] T001 [US1] Criar modelo(faltando caminho do arquivo)
Organização de Tarefas
-
Das Histórias de Usuário (spec.md) — ORGANIZAÇÃO PRIMÁRIA:
- Cada história de usuário (P1, P2, P3...) recebe sua própria fase.
- Mapeie todos os componentes relacionados para sua história:
- Modelos necessários para aquela história.
- Serviços necessários para aquela história.
- Interfaces/UI necessárias para aquela história.
- Se testes forem solicitados: Testes específicos para aquela história.
- Marque dependências das histórias (a maioria das histórias deve ser independente).
-
Dos Contratos:
- Mapeie cada contrato de interface → para a história de usuário que ele serve.
- Se testes forem solicitados: Cada contrato de interface → tarefa de teste de contrato [P] antes da implementação na fase daquela história.
-
Do Modelo de Dados:
- Mapeie cada entidade para a(s) história(s) de usuário que precisam dela.
- Se a entidade serve múltiplas histórias: Coloque na história mais antiga ou na fase de Configuração.
- Relacionamentos → tarefas de camada de serviço na fase de história apropriada.
- Para cada campo com restrições em data-model.md (comprimento máximo, nullable/obrigatório, valores de enum, regras de validação), cite a restrição literalmente na descrição da tarefa para que não seja deixada ao critério do momento da implementação.
-
Da Configuração/Infraestrutura:
- Infraestrutura compartilhada → Fase de Configuração (Fase 1).
- Tarefas fundamentais/bloqueantes → Fase Fundamental (Fase 2).
- Configuração específica da história → dentro da fase daquela história.
Estrutura de Fases
- Fase 1: Configuração (inicialização do projeto).
- Fase 2: Fundamental (pré-requisitos bloqueantes — DEVE ser concluída antes das histórias de usuário).
- Fase 3+: Histórias de Usuário em ordem de prioridade (P1, P2, P3...).
- Dentro de cada história: Testes (se solicitados) → Modelos → Serviços → Endpoints → Integração.
- Cada fase deve ser um incremento completo e testável independentemente.
- Fase Final: Polimento e Preocupações Transversais.
Concluído Quando
- tasks.md gerado com todas as fases, IDs de tarefas e caminhos de arquivo.
- Hooks de extensão despachados ou ignorados de acordo com as regras em Hooks de Pós-Execução Obrigatórios acima.
- Conclusão relatada ao usuário com contagem de tarefas, detalhamento por história e escopo MVP.