specsfy-07-implement
Executa as tarefas da seção `14. Tarefas` de `spec.md` da feature em ordem de dependência, escreve o código de produção a partir de testes TDD em RED, registra a comprovação na própria spec e fecha o Delivery Gate. Use quando o usuário pedir para implementar, executar, continuar a próxima tarefa pronta ou concluir uma feature já planejada, ou quando uma transição automática iniciar ou retomar a entrega. Não use para apenas criar testes (use specsfy-06-tdd-bdd), apenas decompor tarefas (use specsfy-05-tasks) ou mudar o comportamento acordado (use specsfy-update-spec).
How do I install this agent skill?
npx skills add https://github.com/promovaweb/specsfy --skill specsfy-07-implementIs this agent skill safe to install?
- Gen Agent Trust Hubpass
This skill implements a structured TDD workflow with robust safety gates. It prevents destructive database operations and ensures file operations remain within the project root. External skill installations are confined to the vendor's own GitHub repositories.
- Socketpass
No alerts
- Snykwarn
Risk: MEDIUM · 2 issues
What does this agent skill do?
Implementar as tarefas e criar o código
Esta skill transforma um plano aprovado em código funcionando. Cada tarefa da
seção 14 passa por RED → GREEN → REFACTOR, e spec, testes, código,
comprovação e checkboxes continuam coerentes entre si durante todo o trabalho.
A spec é a fonte única: tudo o que for decidido ou comprovado volta para ela.
Pronto quando
- Toda tarefa da seção 14 está com o pai marcado
- [x]e os seis itensPREP,EXECUTE,VERIFY,VISUAL,EVIDENCEeIMPROVEconcluídos. - Suíte completa, lint, tipos e build disponíveis passaram depois de
SAFE. - A rastreabilidade não tem lacunas e cada
AC,FR,NFRe item da Definition of Done aponta para comprovação atual. specsfy context monitor --checkespecsfy docs build --checkpassam.Delivery Gate: Passed,Status: Reviewinge a spec está emreview/.
Preparação obrigatória
Antes de executar esta skill, carregue obrigatoriamente $specsfy-setup na
raiz do projeto. Em handoff automático, carregue-o de novo antes desta etapa.
Reutilize a raiz confirmada na conversa e não prossiga se o setup apontar uma
pendência.
Modo de interação
Modo de interação: perguntas.
Antes de formular qualquer pergunta, leia e aplique o
Contrato de perguntas numeradas de .specsfy/Spec.md. Pergunte somente o
que a spec e o projeto não respondem, como o runner de testes em projeto Node.
Orquestrar a conversa
Siga a seção Orquestração conversacional de .specsfy/Spec.md. Resumo:
- Pendência dentro do escopo: anuncie
Pendência detectada: <descrição> — ação: resolvendo nesta etapae resolva. - 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. - Correção concluída: anuncie
Retomada automática: $<destino> → $specsfy-07-implement — pendência resolvida: <resultado>e retome.
Reavalie o estado depois de cada handoff para não entrar em ciclo. O handoff dispensa confirmação; ações sensíveis continuam exigindo autorização específica.
Proteção obrigatória do banco
Testes nunca rodam contra o banco de desenvolvimento. Rode esta conferência antes de executar qualquer teste, suíte, regressão ou migration:
specsfy gate database --project <raiz> --command "<comando-pretendido>"
Pelo MCP, use a tool gate_database. Sem o binário instalado, rode o script
equivalente:
node .agents/skills/specsfy-setup/scripts/check_database_safety.mjs \
--project <raiz> --command "<comando-pretendido>"
| Resultado | Ação |
|---|---|
SAFE | execute o comando |
PENDING | não execute teste algum; corrija o ambiente e confira de novo |
IGNORED | ignore o comando: não execute, não vire tarefa, não peça autorização |
Em Laravel, exija .env.testing, APP_ENV=testing e um banco explicitamente
diferente do banco de desenvolvimento definido no .env.
Comandos que apagam, recriam ou zeram banco e schema são sempre ignorados,
mesmo com autorização: migrate:fresh, migrate:refresh, migrate:reset,
migrate:rollback, db:wipe, schema:drop, prisma migrate reset,
DROP DATABASE, DROP SCHEMA, DROP TABLE, TRUNCATE e equivalentes,
inclusive por scripts indiretos e testes com RefreshDatabase ou
DatabaseMigrations. Use isolamento transacional e fixtures mínimas.
Revisão visual obrigatória
Toda tarefa de desenvolvimento passa pela revisão visual, mesmo sem pedido da
pessoa, porque falhas de layout raramente aparecem em testes. O item VISUAL
vem depois de VERIFY e precisa estar concluído antes de EVIDENCE.
- Com interface: leia
DESIGNSYSTEM.MD,INTERFACE.mde os componentes afetados. Inspecione a renderização ou o DOM nos viewports e estados relevantes. Confira bordas, espaçamentos, margens, padding e tipografia do sistema, além de alinhamento, largura, overflow, foco, zoom e quebra de texto. Registre método, viewport, estados, ajustes e resultado na tarefa. - Sem interface: conclua
VISUALcomNão aplicávele um motivo concreto.
Gate inicial
Faça em paralelo as leituras independentes do passo 1; os passos seguintes são sequenciais.
-
Use a raiz confirmada no
$specsfy-setup. Um subdiretório informado pela pessoa é o projeto; não o promova para a raiz Git. Leia<raiz>/specs/planned/<NNNN>-<slug>/spec.md(ou a pasta de estado atual), as fontes indexadas emresearch/, as instruções do repositório e o código relevante. Não procuretasks.md,plan.md,research.mdoudata-model.md. -
Exija
Formato: Specsfy/2.0,Status: PlannedouImplementing,Definition Gate: PassedePlan Gate: Passed. -
Valide a spec e as tarefas:
specsfy gate spec <spec> specsfy gate tasks <spec>Pelo MCP, use as tools
gate_specegate_tasks. Sem o binário instalado, rode os scripts equivalentes:node .agents/skills/specsfy-04-validate/scripts/validate_spec.mjs \ specs/<estado>/<NNNN>-<slug>/spec.md node .agents/skills/specsfy-05-tasks/scripts/validate_tasks.mjs \ specs/<estado>/<NNNN>-<slug>/spec.mdSe o gate falhar por tarefa, predecessor TDD ou RED ausente em um plano antes aprovado, anuncie a pendência e retorne automaticamente para
$specsfy-05-taskssem alterar produção. Essa skill reabre o Ato II, chama TDD/BDD e devolve a entrega depois de validar o plano. Para outra falha, carregue a skill responsável pelo gate. -
Se
Interface para pessoasforSim, confira a interface antes de programar (seção abaixo). -
Para Laravel, consulte
.specsfy/PACKAGES.md,docs/packages/README.mde as fichas existentes antes de adicionar ou trocar uma dependência. Se a tarefa trouxer uma URL do GitHub ou mudar o Composer, carregue$specsfy-specialist-laravel-package-managere reutilize pacotes já instalados que atendam ao requisito. -
Confira o comando da suíte base com
specsfy gate databasee execute-a somente apósSAFE. Registre falhas preexistentes para não atribuí-las à nova mudança. -
Antes da primeira alteração de produção, defina
Status: Implementing,Delivery Gate: In Progresse executespecsfy specs transition <id> in-progress, equivalente aspecsfy specs transition <id> in-progress. ComClickUp Taske ClickUpfy presentes, mova a tarefa remota paraem andamento(In Progress) neste momento, porque um agente passa a executá-la. Antes disso ela permanece em próxima etapa. -
Selecione o próximo trabalho pronto:
specsfy tasks next <spec>Pelo MCP, use a tool
task_next. Sem o binário instalado, rode o script equivalente:node .agents/skills/specsfy-07-implement/scripts/next_task.mjs \ <raiz>/specs/<estado>/<NNNN>-<slug>/spec.mdSem tarefa pronta, diferencie
concluídodebloqueado por dependência.
Conferência de interface
- Leia a seção 10 e confirme que o plano tem tarefas para stack local, telas, menus e navegação principal, formulários, ações, blocos React, componentes shadcn/ui/ReUI, estados e testes de interação.
- Compare stack, telas e fluxos atuais com o projeto e preserve componentes, rotas, conteúdo, permissões e comportamentos fora do alcance registrado.
- Se faltar algum item ou a tecnologia proposta divergir sem confirmação,
retorne automaticamente para
$specsfy-05-tasks. Não entregue um CRUD somente como API ou persistência. - Antes de programar, confirme os itens escolhidos na tabela da seção 10 e em
INTERFACE.md. Depois, registre emINTERFACE.mdtodos os blocos criados, alterados ou reaproveitados. - Em projeto React, carregue
$specsfy-specialist-react-ui-componentsantes de escrever JSX ou TSX. Se ele não estiver instalado, volte ao$specsfy-setuppara instalar o especialista detectado e não implemente a tela até concluir esse preparo. - Em um CRUD, confirme um único
PageHeaderreutilizável em todas as telas,DataGridem largura total, colunaIDsempre visível, link da linha para o detalhe e botões de editar e apagar independentes na linha.
Executar uma tarefa
Atualize cada item no momento em que ele acontece, não em lote no final.
-
PREP. Confirme ID, tipo, referências, dependências, arquivos e resultado verificável. Marque
PREP. -
Teste (
[TEST]). Siga$specsfy-06-tdd-bdd: use o Gherkin da spec como referência para desenhar o teste TDD, adicione os marcadoresSPECSFY:e observe RED válido. Não crie nem execute.feature. Em PHP, use Pest; em Node, somente o runner confirmado pelo usuário. -
Pré-condição de código (
[CODE]). Confirme que o predecessor TDD está concluído para os mesmos IDs, com RED registrado na seção 11. Sem isso, não altere produção: anuncie a pendência e retorne automaticamente para$specsfy-05-tasks, que reabre o plano, chama$specsfy-06-tdd-bdde devolve a entrega após o novoPlan Gate: Passed. -
GREEN. Escreva a menor mudança de produção que deixa o teste verde.
- Interface: implemente a tela, os menus, o formulário e a interação definidos na spec, com os estados descritos. Rota de API, componente vazio ou atalho não substituem a tela acordada.
- React: siga
$specsfy-specialist-react-ui-componentspara localizar, reaproveitar, adaptar e registrar componentes antes de criar uma nova composição. [MIGRATION]: crie primeiro o arquivo versionado no caminho planejado, passe o comando pelospecsfy gate database, aplique a migration no banco de teste e consulte o estado logo depois. Registre os dois comandos com saída zero no comentáriospecsfy:evidenceda tarefa.[DOC]ou[OPS]: produza a comprovação específica pedida.
-
Contexto. Depois de alterar produção, rode:
specsfy context monitor --project <raiz> --checkPelo MCP, use a tool
context_monitor. Sem o binário instalado, rode o script equivalente:node .agents/skills/specsfy-setup/scripts/monitor_context.mjs \ --project <raiz> --checkFaça handoff de stack pendente para
$specsfy-aux-stack, de persistência para$specsfy-aux-databasee de regra confirmada para$specsfy-aux-rules. RevisePROJECT.mdem toda mudança de aplicação; sem impacto material em história, finalidade, capacidades ou limites, registre a avaliação na tarefa e repita com--acknowledge-project-no-change. A tarefa só avança quando o monitor deixar de retornarPENDING. -
Documentação. Depois de cada tarefa
[CODE], anuncieTransição automática: $specsfy-07-implement → $specsfy-documentator — motivo: implementação alterou o sistema — resultado esperado: docs/ reconstruído e atuale carregue$specsfy-documentator. Retome quando o--checkda documentação passar. -
EXECUTE. Marque quando a entrega e a documentação exigida existirem nos caminhos declarados.
-
VERIFY. Confira cada comando com
specsfy gate databasee, apósSAFE, execute o teste TDD focal, a suíte relacionada e os checks estáticos. Marque somente com o resultado esperado. Refatore apenas com tudo verde. -
VISUAL. Aplique a revisão visual descrita acima.
-
EVIDENCE. Registre comando, resultado e IDs nas seções 11 a 13. Com
Evidence Contract: 1, grave também o comentário JSONspecsfy:evidenceno bloco da tarefa e verifique:specsfy gate evidence <spec> --task TNNNPelo MCP, use a tool
gate_evidence. Sem o binário instalado, rode o script equivalente:node .agents/skills/specsfy-07-implement/scripts/verify_evidence.mjs \ specs/<estado>/<NNNN>-<slug>/spec.md . --task TNNNQuando uma execução completa produzir atestação schema 2, verifique de novo com
--attestation PATH. Exija commit compatível, vínculo com a mesma spec e tarefa, refs e comandos idênticos, checks aprovados e SHA-256 atual de cada arquivo. Atestação de--self-testnão prova entrega. -
IMPROVE. Faça uma micro-retrospectiva: aplique uma melhoria segura ou registre “nenhuma melhoria necessária” com justificativa.
-
Fechar. Marque o pai
- [x]somente com os seis itens concluídos, rodespecsfy gate tasks <spec>e recalcule a próxima tarefa comspecsfy tasks next <spec>.
Uma tarefa [MIGRATION] não fecha só porque o model, a query ou o teste
existe. specsfy gate evidence <spec> exige o arquivo da migration, o comando
que a aplicou e a consulta que confirma seu estado; se faltar algum, EXECUTE,
VERIFY e a tarefa continuam abertos.
Tarefas [P] podem ser agrupadas quando não tocam os mesmos arquivos ou
estado. Dependência oculta descoberta na execução vira dependência explícita
na seção 14.
Controlar mudança de escopo
Pare quando a implementação exigir comportamento não descrito, contradizer um
AC ou mudar interface pública, dados, segurança ou fora de escopo. Anuncie a
pendência e carregue automaticamente $specsfy-update-spec. Ela preserva o
pedido, decide se precisa refinar com a pessoa, atualiza a fonte normativa,
reabre somente os gates afetados e percorre validação, tarefas e TDD/BDD.
Retome com os gates novamente aprovados, nesta ordem de atualização:
specs/<estado>/<NNNN>-<slug>/spec.md (seções 1–13) → tarefas (seção 14) → testes → código → comprovação na mesma spec
Correções internas reversíveis podem ser resolvidas no código e citadas no relato sem reabrir a especificação.
Gate de conclusão
Quando todas as tarefas da seção 14 estiverem marcadas, execute em sequência:
-
suíte completa, lint, tipos e build disponíveis, cada comando após
SAFE; -
rastreabilidade:
specsfy gate trace <spec>Pelo MCP, use a tool
gate_trace. Sem o binário instalado, rode o script equivalente:node .agents/skills/specsfy-06-tdd-bdd/scripts/check_traceability.mjs \ specs/<estado>/<NNNN>-<slug>/spec.md . -
comparação de cada
AC,FR,NFRe item da Definition of Done com comprovação atual; -
busca por tarefas abertas, placeholders, testes pulados e falhas conhecidas;
-
specsfy gate evidence <spec>para toda tarefa[MIGRATION], confirmando arquivo, aplicação e consulta de estado; -
specsfy context monitor --project <raiz> --checksem pendências; -
$specsfy-documentatorcomspecsfy docs build --project <raiz> --checkaprovado.
Com tudo comprovado, altere Delivery Gate para Passed, defina
Status: Reviewing e execute specsfy specs transition <id> review, equivalente a
specsfy specs transition <id> review. O aceite final e a mudança para
completed pertencem ao $specsfy-04-validate. Se alguma comprovação faltar,
não declare conclusão.
Com ClickUp Task e ClickUpfy presentes, mova a tarefa remota para revisar
(In Review) na entrega. pronto e concluido só mediante ordem humana.
Se a execução parar antes do Delivery Gate, por pausa, pendência, mudança de
escopo ou fim da sessão, a spec continua em in-progress, mas a tarefa remota
volta para próxima etapa (proxima etapa no ClickUp da Promovaweb, To Do ou
o mapeamento do projeto), com comentário que informe a última tarefa
concluída, a tarefa aberta e o próximo passo. Ao retomar, mova de novo para
em andamento.
Projete o resumo de entrega sem criar arquivo:
specsfy tasks delivery <spec> --format markdown
Pelo MCP, use a tool delivery_render. Sem o binário instalado, rode o script
equivalente:
node .agents/skills/specsfy-07-implement/scripts/render_delivery.mjs \
specs/<estado>/<NNNN>-<slug>/spec.md --format markdown
Use --preview enquanto a entrega estiver aberta. O script escreve somente em
stdout; publicar o texto em PR, commit ou ferramenta externa exige pedido
explícito. Leia references/completion-gates.md para a lista completa do
fechamento.
Relatar
Informe em texto curto: tarefas concluídas, arquivos alterados, comandos e
resultados, cobertura de IDs, falhas preexistentes e a próxima tarefa pronta
ou o gate final. Ao final, anuncie e carregue automaticamente
$specsfy-progress para conferir a visão global. Em falha, anuncie a
pendência, carregue a skill responsável quando necessário e deixe a tarefa
aberta até a correção.
Especialistas sob demanda
Leia references/specialists.md antes de executar uma tarefa cuja tecnologia ou consequência de falha não esteja coberta pelo contexto local. Instale somente com autorização no projeto consumidor.
How can the creator link this skill?
Add the canonical catalog link to the repository README so users can inspect current installs and available audits. The publishing guide covers the complete discovery path.
<a href="https://skillzs.dev/skills/promovaweb/specsfy/specsfy-07-implement">View specsfy-07-implement on skillZs</a>