Implementar as tarefas e criar o código
Modo de interação
Modo de interação:
.
Antes de formular qualquer pergunta, leia e aplique o
Contrato de perguntas numeradas
de
.
Execute a seção
de
em ordem de dependência, mantendo a fonte única, testes, código, evidências e checkboxes coerentes.
Orquestrar a conversa
Ao concluir esta etapa ou detectar trabalho de outra etapa, anuncie
Pendência detectada: <descrição> — ação: resolvendo nesta etapa
e resolva-a
quando pertencer ao próprio escopo. Quando houver troca de responsabilidade,
anuncie
Transição automática: $specsfy-07-implement → $<destino> — motivo: <motivo> — resultado esperado: <resultado>
e carregue imediatamente a skill de
destino, sem pedir confirmação nem repetir o comando. Continue na mesma
conversa. Depois de uma correção necessária a esta etapa, anuncie
Retomada automática: $<destino> → $specsfy-07-implement — pendência resolvida: <resultado>
e retome-a imediatamente. Reavalie o estado após cada handoff para
evitar ciclos. Não peça confirmação para o handoff; ações sensíveis continuam
exigindo autorização específica.
Gate inicial
- Leia
specs/planned/<NNNN>-<slug>/spec.md
- Exija , ou ,
e .
- Execute os validadores contra
specs/<estado>/<NNNN>-<slug>/spec.md
- Execute a suite base relevante. Registre falhas preexistentes e não as atribua à nova mudança.
- Antes da primeira alteração de produção, defina ,
Delivery Gate: In Progress
specsfy transition <id> in-progress
- Selecione trabalho pronto com:
bash
node .agents/skills/specsfy-07-implement/scripts/next_task.mjs specs/<estado>/<NNNN>-<slug>/spec.md
Se não houver tarefa pronta, diferencie
de
bloqueado por dependência
.
Executar uma tarefa
- Confirme ID, tipo, referências, dependências, arquivos e resultado verificável; marque imediatamente após essa confirmação.
- Para , siga : leia o Gherkin de referência na
spec e use-o para desenhar o teste TDD; adicione marcadores e observe RED
válido. Nunca crie ou execute . Em PHP, use Pest; em Node, use
somente o runner confirmado pelo usuário.
- Para , confirme o predecessor TDD concluído cobrindo os mesmos IDs,
com RED registrado na seção 11. Sem isso, pare e não altere produção.
Anuncie a pendência e retorne automaticamente para
, que reabre o plano, chama e
retoma esta skill depois do novo .
- Escreva a menor mudança de produção que torna o teste TDD verde.
- Depois de alterar produção e antes de marcar , monitore o contexto:
bash
node .agents/skills/specsfy-setup/scripts/monitor_context.mjs \
--project . --check
Para stack pendente, faça handoff a
; para persistência,
a
; para regra confirmada, a
. Revise
em toda mudança de aplicação. Se
não houver impacto material na história, finalidade, capacidades ou limites,
registre a avaliação na evidência da tarefa e repita com
--acknowledge-project-no-change
. Não marque a tarefa enquanto o monitor
retornar
.
6. Depois de cada tarefa
, anuncie
Transição automática: $specsfy-07-implement → $specsfy-documentator — motivo: implementação alterou o sistema — resultado esperado: docs/ reconstruído e atual
e carregue
. Reconstrua a
documentação a partir de todo o código existente, execute seu
e
retome esta skill somente quando a documentação estiver atual.
7. Para
ou
, produza a evidência específica pedida.
8. Marque
somente quando a entrega e a documentação exigida existirem
nos caminhos declarados.
9. Execute o teste TDD focal, a suite relacionada e checks estáticos;
marque
somente com o resultado esperado.
10. Refatore somente com tudo verde.
11. Registre comando, resultado e IDs nas seções 11–13 e então marque
.
Quando houver
, grave também o comentário JSON
no bloco da tarefa e execute:
bash
node .agents/skills/specsfy-07-implement/scripts/verify_evidence.mjs \
specs/<estado>/<NNNN>-<slug>/spec.md . --task TNNN
Quando uma execução completa produzir atestação schema 2, verifique novamente
com
. Exija commit compatível, binding da mesma spec/tarefa,
refs e comandos idênticos, checks realmente aprovados e SHA-256 atual de cada
arquivo. Atestação de
não prova entrega.
12. Faça uma micro-retrospectiva: aplique uma melhoria segura encontrada ou registre “nenhuma melhoria necessária” com justificativa; então marque
.
13. Na seção 14 de
specs/<estado>/<NNNN>-<slug>/spec.md
, altere o pai de
para
somente quando os cinco itens estiverem concluídos.
14. Execute
, recalcule a próxima tarefa e confira o próximo item retornado por
.
Atualize os itens conforme o trabalho acontece; não os marque em lote no encerramento. Tarefas
podem ser agrupadas apenas quando não tocam os mesmos arquivos ou estado. Se a execução revelar dependência oculta, torne-a explícita na seção 14.
Controlar mudança de escopo
Pare quando a implementação exigir comportamento não descrito, contradizer um
ou mudar interface pública, dados, segurança ou fora de escopo. Anuncie a
pendência e carregue automaticamente
. Essa skill
preserva o pedido, decide se precisa refinar a pessoa, atualiza a fonte
normativa, reabre somente os gates afetados e percorre validação, tarefas e
TDD/BDD. Retome esta skill somente com os gates novamente aprovados. Atualize na
ordem:
text
specs/<estado>/<NNNN>-<slug>/spec.md (seções 1–13) → tarefas (seção 14) → testes → código → evidências na mesma spec
Correções internas reversíveis podem ser decididas no código e registradas no relato sem reabrir a especificação.
Gate de conclusão
Quando todas as tarefas da seção 14 estiverem marcadas:
- execute a suite completa disponível, lint, tipos e build;
- execute a rastreabilidade de testes;
- compare cada , , e item da Definition of Done com evidência atual;
- procure tarefas abertas, placeholders, testes pulados e falhas conhecidas;
- execute novamente
monitor_context.mjs --project . --check
- carregue , reconstrua e exija que o
build_documentation.mjs --project . --check
- não declare conclusão se alguma evidência estiver ausente;
- altere para somente com rastreabilidade completa,
defina e execute
specsfy transition <id> review
Depois do gate final, projete o resumo de entrega sem criar arquivo:
bash
node .agents/skills/specsfy-07-implement/scripts/render_delivery.mjs \
specs/<estado>/<NNNN>-<slug>/spec.md --format markdown
Use
enquanto a entrega estiver aberta. Publicar o texto em PR,
commit ou ferramenta externa exige pedido explícito; o script escreve somente
em stdout.
Leia
references/completion-gates.md
para o fechamento.
Relatar
Informe tarefas concluídas, arquivos alterados, comandos e resultados, cobertura
de IDs, falhas preexistentes, próxima tarefa pronta ou o gate final. Ao final,
anuncie e carregue automaticamente
para conferir a
visão global derivada da fonte. Em falha, anuncie a pendência, carregue
automaticamente a skill responsável quando necessário e deixe a tarefa aberta
até a correção e retomada.
Especialistas sob demanda
Leia references/specialists.md antes de executar
uma tarefa cuja tecnologia ou risco não esteja coberto pelo contexto local.
Instale somente com autorização no projeto consumidor.