Quebrar a especificação em tarefas
Preencha as seções 14. Tarefas e 15. Ordem de execução de
specs/<estado>/<NNNN>-<slug>/spec.md. Cada tarefa precisa ser pequena,
verificável, ordenada e ligada a IDs definidos na spec, porque é esse vínculo
que permite provar a entrega depois. O arquivo continua sendo a única fonte da
verdade.
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. A pergunta típica
desta skill é qual runner de testes adotar em projeto Node sem PHP.
Pronto quando
specsfy gate tasks <spec> passa com e sem --allow-draft e, havendo
interface para pessoas, specsfy gate interface <spec> também passa;
- todo
FR, NFR e AC aplicável tem tarefa, e toda tarefa [CODE] depende
de um predecessor TDD com RED registrado;
Plan Gate: Passed, Status: Planned e Gate do Ato II — Plano estão
registrados, e specsfy specs transition <id> planned, equivalente a
specsfy specs transition <id> planned, foi executado;
$specsfy-07-implement foi carregada.
Proteção do banco no plano
Em projeto Laravel, execute specsfy gate database --project <raiz> antes de
planejar ou liberar qualquer tarefa [TEST]. Pelo MCP, use a tool
gate_database. Sem o binário instalado, rode
node .agents/skills/specsfy-setup/scripts/check_database_safety.mjs --project <raiz>. O plano mantém .env.testing, APP_ENV=testing e um banco de
teste explicitamente diferente do banco do .env, para que nenhum teste toque
dados de desenvolvimento.
- Com
PENDING, nenhuma tarefa de teste fica pronta e a skill não chama o
runner.
- Com
IGNORED, descarte o comando que apagaria estruturas ou registros.
- Não inclua em tarefa, teste, preparação, regressão ou Definition of Done os
comandos destrutivos listados em
Proteção do banco de desenvolvimento de
.specsfy/Spec.md: migrate:fresh, migrate:refresh, migrate:reset,
migrate:rollback, db:wipe, schema:drop, prisma migrate reset,
DROP DATABASE, DROP SCHEMA, DROP TABLE, TRUNCATE, RefreshDatabase,
DatabaseMigrations ou equivalentes.
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-05-tasks → $<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-05-tasks — 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.
Pré-condições
Leia em paralelo a spec, o template de tarefas resolvido e os manifests e
configurações do repositório. Depois siga a ordem:
Leia a spec indicada em specs/defined/<NNNN>-<slug>/spec.md e exija
Formato: Specsfy/2.0, Definition Gate: Passed e Status Defined,
Planned ou Implementing. Aceite os dois últimos somente para
replanejamento automático de uma pendência detectada em etapa posterior.
Execute a validação da especificação quando o gate ainda não estiver
comprovado.
Use a stack, os comandos e os caminhos reais do repositório. Em PHP, use
Pest para TDD; em Node sem PHP, pergunte qual runner adotar e recomende
Vitest antes de gerar caminhos ou comandos.
Execute o monitor antes de planejar:
specsfy context monitor --project .
Pelo 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 .
Use os sinais de stack, aplicação, regras e persistência para planejar a
documentação junto da mudança, sem inferir requisito novo.
Se faltar uma decisão que mude arquitetura, dados ou aceite, anuncie e
retorne automaticamente para $specsfy-02-backlog. Depois da decisão, use
$specsfy-update-spec quando a spec já tiver sido aprovada ou
$specsfy-03-specify durante a definição inicial.
Gerar
Use .specsfy/templates/custom/Tasks.md como contrato quando existir e
.specsfy/templates/Tasks.md caso contrário. Substitua somente o conteúdo das
seções 14. Tarefas e 15. Ordem de execução em
<raiz>/specs/<estado>/<NNNN>-<slug>/spec.md e preserve todas as outras.
Reabrir o plano antes de editar
- Se a spec estiver
Planned ou Implementing, anuncie a pendência, reabra o
Ato II e defina Status: Defined, Plan Gate: Pending e
Delivery Gate: Pending antes de editar. Gate e evidência posteriores perdem
a validade sobre um plano alterado.
- Em uma spec já
Defined, defina Plan Gate: Pending e
Delivery Gate: Pending antes de editar.
- Preserve IDs existentes ao atualizar e não renumere tarefas concluídas.
Estrutura do plano
- Organize em setup mínimo, fundação indispensável, histórias em prioridade e
fechamento.
- Mantenha histórias como fatias verticais demonstráveis de forma
independente.
- Dê a cada tarefa um resultado único, caminho exato e critério verificável.
- Declare dependências por ID, sem depender apenas da ordem visual.
- Marque
[P] somente quando as tarefas não compartilham arquivos, estado
mutável ou dependência.
- Cubra todo
FR, NFR e AC aplicável. Toda tarefa tem referência, exceto
setup ou acabamento claramente justificado.
- Não inclua exemplos genéricos nem placeholders.
Testes e código
- Para cada
AC, crie uma tarefa [TEST] [TDD] distinta cujo desenho usa como
referência o Gherkin mantido na spec. O conjunto dessas tarefas materializa
pelo menos três casos TDD distintos para a feature inteira e para cada US,
FR e NFR.
- O Gherkin da spec é contrato de referência: não crie tarefa para arquivo
.feature ou step definition e não o execute.
- Em PHP, a tarefa TDD aponta para teste Pest e exige marcador
SPECSFY; em
Node, usa o runner confirmado pelo usuário e o script test:tdd.
- Faça cada tarefa
[CODE] depender do predecessor TDD da mesma fatia com RED.
- Faça toda tarefa
[CODE] exigir a reconstrução independente de docs/ por
$specsfy-documentator antes de EXECUTE, inclusive quando a documentação
já existia.
Interface para pessoas
Quando Interface para pessoas for Sim:
- crie tarefas explícitas para as telas, menus e navegação principal,
formulário e ações descritos na seção 10, além da camada de dados ou API;
- inclua testes de comportamento da interface para navegação, envio,
validação, recuperação de erro e o padrão de abertura escolhido, como painel
lateral ou modal;
- use somente os componentes, convenções e runners da stack de interface
registrada; cada tarefa aponta os blocos React, componentes shadcn/ui e ReUI
ou rotas reais;
- inclua uma tarefa para atualizar
INTERFACE.md com finalidade, arquivo, API,
estados, consumidores e regra de reaproveitamento de todos os blocos criados
ou alterados;
- em projetos React, cada tarefa de tela registra no
PREP o uso de
$specsfy-specialist-react-ui-components antes da implementação, porque essa
skill orienta a busca, o reaproveitamento e a adaptação dos componentes reais
do projeto. Se ela não estiver instalada, retorne ao $specsfy-setup para
instalar o especialista detectado antes de liberar a tarefa [CODE];
- agrupe essas tarefas na subseção obrigatória
#### Fase de interface da
seção 14. Cada tela registrada recebe ao menos uma tarefa própria, em vez de
ficar escondida dentro de uma tarefa genérica de backend.
Migrations
- Sempre que uma tarefa criar ou alterar schema, tabela, coluna, índice,
relação ou model persistente, crie uma tarefa
[CODE] [MIGRATION] separada.
Ela aponta para o arquivo versionado no diretório de migrations do projeto,
depende dos testes TDD e precede o código que usa a nova estrutura.
- Use a tag
[MIGRATION] somente junto de [CODE] ou [OPS], com caminho em
database/migrations/, migrations/, prisma/migrations/ ou
supabase/migrations/, conforme a stack encontrada.
- Leitura, consulta ou uso de tabela existente não exige
[MIGRATION] por si
só. A tag é obrigatória quando o plano cria ou altera a estrutura.
- O item
VERIFY da tarefa [MIGRATION] registra dois comandos aprovados pelo
specsfy gate database: um aplica a migration no banco de teste e outro
consulta o estado das migrations. Não aprove o Plan Gate sem essa tarefa.
Contexto persistente
| A fatia altera |
Tarefa exigida |
| manifests ou configuração estrutural |
[DOC] para .specsfy/STACK.md |
| banco, schema, model persistente, tabela, campo, relação ou migration |
[DOC] obrigatória para .specsfy/DATABASE.md |
| convenção que virou regra confirmada |
[DOC] para .specsfy/RULES.md |
| aplicação |
revisão de PROJECT.md no fechamento da tarefa; sem impacto material, justificativa na evidência em vez de conteúdo artificial |
Checklist de cada tarefa
- Anexe a cada tarefa, exatamente nesta ordem, os itens
PREP, EXECUTE,
VERIFY, VISUAL, EVIDENCE e IMPROVE definidos no template Tasks.md
resolvido.
- Escreva os itens como resultados específicos da tarefa, não como frases
genéricas copiadas.
- O item
VISUAL vale mesmo sem pedido da pessoa: ele confere bordas,
espaçamentos, margens, padding e tipografia do sistema durante o
desenvolvimento. Sem interface, registre Não aplicável e o motivo concreto.
- O item
IMPROVE registra uma melhoria concreta aplicada ou declara que
nenhuma foi necessária, com justificativa.
- Mantenha pai e itens abertos ao gerar tarefas; a skill de implementação marca
cada item logo após sua evidência.
- Quando a spec declarar
Evidence Contract: 1, cada tarefa [CODE] concluída
contém um comentário specsfy:evidence JSON com task, refs, files e
commands (run e exit), gravado dentro do bloco da tarefa e não em
arquivo paralelo.
Formato canônico
- [ ] T001 [TEST] [TDD] [US-001] Derivar teste Pest do BDD da spec em tests/Feature/AuthTest.php — Refs: FR-002, AC-003 — Depends: none
- [ ] T002 [CODE] [US-001] Implementar validação em app/Services/AuthService.php — Refs: FR-002, AC-003 — Depends: T001
Tags permitidas após o ID: [P], [TEST], [TDD], [CODE], [DOC],
[OPS], [MIGRATION] (somente com [CODE] ou [OPS]) e [US-NNN].
Validar
Execute:
specsfy gate tasks <spec> --allow-draft
Pelo MCP, use a tool gate_tasks. Sem o binário instalado, rode o script
equivalente:
node .agents/skills/specsfy-05-tasks/scripts/validate_tasks.mjs specs/<estado>/<NNNN>-<slug>/spec.md --allow-draft
Quando houver interface para pessoas, execute também:
specsfy gate interface <spec>
Pelo MCP, use a tool gate_interface. Sem o binário, rode o script equivalente:
node .agents/skills/specsfy-05-tasks/scripts/validate_interface_tasks.mjs specs/<estado>/<NNNN>-<slug>/spec.md
Corrija o que o validador apontar, em no máximo três ciclos: IDs duplicados,
dependências inválidas ou cíclicas, referências inexistentes, itens sem três
cenários BDD, AC sem tarefa TDD distinta, plano sem três predecessores ou
casos TDD por feature, US, FR e NFR, código sem predecessor TDD,
checklist ausente ou fora de ordem, pai e itens incoerentes, progresso em
tarefa bloqueada ou tarefas vagas. No contrato de evidência, o mesmo validador
também rejeita arquivo ausente, referência inválida, comando sem exit: 0 ou
tarefa concluída sem evidence.
Fechar o Plan Gate
Quando a estrutura passar ainda com Plan Gate: Pending, chame
automaticamente $specsfy-06-tdd-bdd no modo prepare. Ele usa o BDD da spec
para materializar o predecessor TDD, observa RED e conclui somente essa tarefa
de teste. Ao retomar esta skill, siga em ordem:
- execute novamente o validador com
--allow-draft;
- altere
Plan Gate para Passed e defina Status: Planned;
- registre o resultado em
Gate do Ato II — Plano;
- execute
specsfy gate tasks <spec> sem --allow-draft;
- execute
specsfy specs transition <id> planned, equivalente a
specsfy specs transition <id> planned.
O modo estrito rejeita Plan Gate: Passed enquanto algum predecessor TDD de
uma tarefa [CODE] continuar aberto. Se a validação falhar, mantenha
Status: Defined, Plan Gate: Failed, Delivery Gate: Pending e relate as
pendências.
Quando a conversa alterar abrangência, dependência ou capacidade necessária,
chame $specsfy-interviewer antes de replanejar e atualize o Effort com
justificativa.
Relatar
Informe a contagem total e por tipo, o caminho crítico, as oportunidades
[P] e a cobertura de IDs. Quando o gate passar, anuncie e carregue
automaticamente $specsfy-07-implement. O plano vive somente na spec, sem
tasks.md.
Especialistas sob demanda
Leia references/specialists.md ao decompor
trabalho de tecnologia, dados, interface ou operação que demande checklist
próprio.
1---2name: specsfy-05-tasks3description: "Decompõe uma spec aprovada em tarefas pequenas, ordenadas e rastreáveis nas seções 14 e 15 da própria spec.md e conduz o Plan Gate. Use quando o usuário quiser quebrar a especificação em tarefas, preencher ou atualizar a seção 14. Tarefas, ordenar dependências, planejar fatias verticais ou preparar a execução, e quando uma transição automática pedir planejamento, replanejamento ou retomada após RED. Edita somente o plano dentro da fonte única: não cria tasks.md, não escreve código e não marca trabalho como concluído. Testes e RED ficam com specsfy-06-tdd-bdd e a execução com specsfy-07-implement."4metadata:5 source: https://skillmd.com/skills/promovaweb/specsfy-05-tasks6---78# Quebrar a especificação em tarefas910Preencha as seções `14. Tarefas` e `15. Ordem de execução` de11`specs/<estado>/<NNNN>-<slug>/spec.md`. Cada tarefa precisa ser pequena,12verificável, ordenada e ligada a IDs definidos na spec, porque é esse vínculo13que permite provar a entrega depois. O arquivo continua sendo a única fonte da14verdade.1516## Preparação obrigatória1718Antes de executar esta skill, carregue obrigatoriamente `$specsfy-setup` na19raiz do projeto. Em handoff automático, carregue-o de novo antes desta etapa.20Reutilize a raiz confirmada na conversa e não prossiga se o setup apontar uma21pendência.2223## Modo de interação2425Modo de interação: `perguntas`.26Antes de formular qualquer pergunta, leia e aplique o27`Contrato de perguntas numeradas` de `.specsfy/Spec.md`. A pergunta típica28desta skill é qual runner de testes adotar em projeto Node sem PHP.2930## Pronto quando3132- `specsfy gate tasks <spec>` passa com e sem `--allow-draft` e, havendo33 interface para pessoas, `specsfy gate interface <spec>` também passa;34- todo `FR`, `NFR` e `AC` aplicável tem tarefa, e toda tarefa `[CODE]` depende35 de um predecessor TDD com RED registrado;36- `Plan Gate: Passed`, `Status: Planned` e `Gate do Ato II — Plano` estão37 registrados, e `specsfy specs transition <id> planned`, equivalente a38 `specsfy specs transition <id> planned`, foi executado;39- `$specsfy-07-implement` foi carregada.4041## Proteção do banco no plano4243Em projeto Laravel, execute `specsfy gate database --project <raiz>` antes de44planejar ou liberar qualquer tarefa `[TEST]`. Pelo MCP, use a tool45`gate_database`. Sem o binário instalado, rode46`node .agents/skills/specsfy-setup/scripts/check_database_safety.mjs --project47<raiz>`. O plano mantém `.env.testing`, `APP_ENV=testing` e um banco de48teste explicitamente diferente do banco do `.env`, para que nenhum teste toque49dados de desenvolvimento.5051- Com `PENDING`, nenhuma tarefa de teste fica pronta e a skill não chama o52 runner.53- Com `IGNORED`, descarte o comando que apagaria estruturas ou registros.54- Não inclua em tarefa, teste, preparação, regressão ou Definition of Done os55 comandos destrutivos listados em `Proteção do banco de desenvolvimento` de56 `.specsfy/Spec.md`: `migrate:fresh`, `migrate:refresh`, `migrate:reset`,57 `migrate:rollback`, `db:wipe`, `schema:drop`, `prisma migrate reset`,58 `DROP DATABASE`, `DROP SCHEMA`, `DROP TABLE`, `TRUNCATE`, `RefreshDatabase`,59 `DatabaseMigrations` ou equivalentes.6061## Orquestrar a conversa6263Ao concluir esta etapa ou detectar trabalho de outra etapa, anuncie64`Pendência detectada: <descrição> — ação: resolvendo nesta etapa` e resolva-a65quando pertencer ao próprio escopo. Quando houver troca de responsabilidade,66anuncie `Transição automática: $specsfy-05-tasks → $<destino> — motivo:67<motivo> — resultado esperado: <resultado>` e carregue imediatamente a skill de68destino, sem pedir confirmação nem repetir o comando. Continue na mesma69conversa. Depois de uma correção necessária a esta etapa, anuncie `Retomada70automática: $<destino> → $specsfy-05-tasks — pendência resolvida:71<resultado>` e retome-a imediatamente. Reavalie o estado após cada handoff para72evitar ciclos. Não peça confirmação para o handoff; ações sensíveis continuam73exigindo autorização específica.7475## Pré-condições7677Leia em paralelo a spec, o template de tarefas resolvido e os manifests e78configurações do repositório. Depois siga a ordem:79801. Leia a spec indicada em `specs/defined/<NNNN>-<slug>/spec.md` e exija81 `Formato: Specsfy/2.0`, `Definition Gate: Passed` e `Status` `Defined`,82 `Planned` ou `Implementing`. Aceite os dois últimos somente para83 replanejamento automático de uma pendência detectada em etapa posterior.842. Execute a validação da especificação quando o gate ainda não estiver85 comprovado.863. Use a stack, os comandos e os caminhos reais do repositório. Em PHP, use87 Pest para TDD; em Node sem PHP, pergunte qual runner adotar e recomende88 Vitest antes de gerar caminhos ou comandos.894. Execute o monitor antes de planejar:9091 ```bash92 specsfy context monitor --project .93 ```9495 Pelo MCP, use a tool `context_monitor`. Sem o binário instalado, rode o96 script equivalente:9798 ```bash99 node .agents/skills/specsfy-setup/scripts/monitor_context.mjs \100 --project .101 ```102103 Use os sinais de stack, aplicação, regras e persistência para planejar a104 documentação junto da mudança, sem inferir requisito novo.1055. Se faltar uma decisão que mude arquitetura, dados ou aceite, anuncie e106 retorne automaticamente para `$specsfy-02-backlog`. Depois da decisão, use107 `$specsfy-update-spec` quando a spec já tiver sido aprovada ou108 `$specsfy-03-specify` durante a definição inicial.109110## Gerar111112Use `.specsfy/templates/custom/Tasks.md` como contrato quando existir e113`.specsfy/templates/Tasks.md` caso contrário. Substitua somente o conteúdo das114seções `14. Tarefas` e `15. Ordem de execução` em115`<raiz>/specs/<estado>/<NNNN>-<slug>/spec.md` e preserve todas as outras.116117### Reabrir o plano antes de editar118119- Se a spec estiver `Planned` ou `Implementing`, anuncie a pendência, reabra o120 Ato II e defina `Status: Defined`, `Plan Gate: Pending` e121 `Delivery Gate: Pending` antes de editar. Gate e evidência posteriores perdem122 a validade sobre um plano alterado.123- Em uma spec já `Defined`, defina `Plan Gate: Pending` e124 `Delivery Gate: Pending` antes de editar.125- Preserve IDs existentes ao atualizar e não renumere tarefas concluídas.126127### Estrutura do plano128129- Organize em setup mínimo, fundação indispensável, histórias em prioridade e130 fechamento.131- Mantenha histórias como fatias verticais demonstráveis de forma132 independente.133- Dê a cada tarefa um resultado único, caminho exato e critério verificável.134- Declare dependências por ID, sem depender apenas da ordem visual.135- Marque `[P]` somente quando as tarefas não compartilham arquivos, estado136 mutável ou dependência.137- Cubra todo `FR`, `NFR` e `AC` aplicável. Toda tarefa tem referência, exceto138 setup ou acabamento claramente justificado.139- Não inclua exemplos genéricos nem placeholders.140141### Testes e código142143- Para cada `AC`, crie uma tarefa `[TEST] [TDD]` distinta cujo desenho usa como144 referência o Gherkin mantido na spec. O conjunto dessas tarefas materializa145 pelo menos três casos TDD distintos para a feature inteira e para cada `US`,146 `FR` e `NFR`.147- O Gherkin da spec é contrato de referência: não crie tarefa para arquivo148 `.feature` ou step definition e não o execute.149- Em PHP, a tarefa TDD aponta para teste Pest e exige marcador `SPECSFY`; em150 Node, usa o runner confirmado pelo usuário e o script `test:tdd`.151- Faça cada tarefa `[CODE]` depender do predecessor TDD da mesma fatia com RED.152- Faça toda tarefa `[CODE]` exigir a reconstrução independente de `docs/` por153 `$specsfy-documentator` antes de `EXECUTE`, inclusive quando a documentação154 já existia.155156### Interface para pessoas157158Quando `Interface para pessoas` for `Sim`:159160- crie tarefas explícitas para as telas, menus e navegação principal,161 formulário e ações descritos na seção 10, além da camada de dados ou API;162- inclua testes de comportamento da interface para navegação, envio,163 validação, recuperação de erro e o padrão de abertura escolhido, como painel164 lateral ou modal;165- use somente os componentes, convenções e runners da stack de interface166 registrada; cada tarefa aponta os blocos React, componentes shadcn/ui e ReUI167 ou rotas reais;168- inclua uma tarefa para atualizar `INTERFACE.md` com finalidade, arquivo, API,169 estados, consumidores e regra de reaproveitamento de todos os blocos criados170 ou alterados;171- em projetos React, cada tarefa de tela registra no `PREP` o uso de172 `$specsfy-specialist-react-ui-components` antes da implementação, porque essa173 skill orienta a busca, o reaproveitamento e a adaptação dos componentes reais174 do projeto. Se ela não estiver instalada, retorne ao `$specsfy-setup` para175 instalar o especialista detectado antes de liberar a tarefa `[CODE]`;176- agrupe essas tarefas na subseção obrigatória `#### Fase de interface` da177 seção 14. Cada tela registrada recebe ao menos uma tarefa própria, em vez de178 ficar escondida dentro de uma tarefa genérica de backend.179180### Migrations181182- Sempre que uma tarefa criar ou alterar schema, tabela, coluna, índice,183 relação ou model persistente, crie uma tarefa `[CODE] [MIGRATION]` separada.184 Ela aponta para o arquivo versionado no diretório de migrations do projeto,185 depende dos testes TDD e precede o código que usa a nova estrutura.186- Use a tag `[MIGRATION]` somente junto de `[CODE]` ou `[OPS]`, com caminho em187 `database/migrations/`, `migrations/`, `prisma/migrations/` ou188 `supabase/migrations/`, conforme a stack encontrada.189- Leitura, consulta ou uso de tabela existente não exige `[MIGRATION]` por si190 só. A tag é obrigatória quando o plano cria ou altera a estrutura.191- O item `VERIFY` da tarefa `[MIGRATION]` registra dois comandos aprovados pelo192 `specsfy gate database`: um aplica a migration no banco de teste e outro193 consulta o estado das migrations. Não aprove o Plan Gate sem essa tarefa.194195### Contexto persistente196197| A fatia altera | Tarefa exigida |198| --- | --- |199| manifests ou configuração estrutural | `[DOC]` para `.specsfy/STACK.md` |200| banco, schema, model persistente, tabela, campo, relação ou migration | `[DOC]` obrigatória para `.specsfy/DATABASE.md` |201| convenção que virou regra confirmada | `[DOC]` para `.specsfy/RULES.md` |202| aplicação | revisão de `PROJECT.md` no fechamento da tarefa; sem impacto material, justificativa na evidência em vez de conteúdo artificial |203204### Checklist de cada tarefa205206- Anexe a cada tarefa, exatamente nesta ordem, os itens `PREP`, `EXECUTE`,207 `VERIFY`, `VISUAL`, `EVIDENCE` e `IMPROVE` definidos no template `Tasks.md`208 resolvido.209- Escreva os itens como resultados específicos da tarefa, não como frases210 genéricas copiadas.211- O item `VISUAL` vale mesmo sem pedido da pessoa: ele confere bordas,212 espaçamentos, margens, padding e tipografia do sistema durante o213 desenvolvimento. Sem interface, registre `Não aplicável` e o motivo concreto.214- O item `IMPROVE` registra uma melhoria concreta aplicada ou declara que215 nenhuma foi necessária, com justificativa.216- Mantenha pai e itens abertos ao gerar tarefas; a skill de implementação marca217 cada item logo após sua evidência.218- Quando a spec declarar `Evidence Contract: 1`, cada tarefa `[CODE]` concluída219 contém um comentário `specsfy:evidence` JSON com `task`, `refs`, `files` e220 `commands` (`run` e `exit`), gravado dentro do bloco da tarefa e não em221 arquivo paralelo.222223### Formato canônico224225```markdown226- [ ] T001 [TEST] [TDD] [US-001] Derivar teste Pest do BDD da spec em tests/Feature/AuthTest.php — Refs: FR-002, AC-003 — Depends: none227- [ ] T002 [CODE] [US-001] Implementar validação em app/Services/AuthService.php — Refs: FR-002, AC-003 — Depends: T001228```229230Tags permitidas após o ID: `[P]`, `[TEST]`, `[TDD]`, `[CODE]`, `[DOC]`,231`[OPS]`, `[MIGRATION]` (somente com `[CODE]` ou `[OPS]`) e `[US-NNN]`.232233## Validar234235Execute:236237```bash238specsfy gate tasks <spec> --allow-draft239```240241Pelo MCP, use a tool `gate_tasks`. Sem o binário instalado, rode o script242equivalente:243244```bash245node .agents/skills/specsfy-05-tasks/scripts/validate_tasks.mjs specs/<estado>/<NNNN>-<slug>/spec.md --allow-draft246```247248Quando houver interface para pessoas, execute também:249250```bash251specsfy gate interface <spec>252```253254Pelo MCP, use a tool `gate_interface`. Sem o binário, rode o script equivalente:255256```bash257node .agents/skills/specsfy-05-tasks/scripts/validate_interface_tasks.mjs specs/<estado>/<NNNN>-<slug>/spec.md258```259260Corrija o que o validador apontar, em no máximo três ciclos: IDs duplicados,261dependências inválidas ou cíclicas, referências inexistentes, itens sem três262cenários BDD, AC sem tarefa TDD distinta, plano sem três predecessores ou263casos TDD por feature, `US`, `FR` e `NFR`, código sem predecessor TDD,264checklist ausente ou fora de ordem, pai e itens incoerentes, progresso em265tarefa bloqueada ou tarefas vagas. No contrato de evidência, o mesmo validador266também rejeita arquivo ausente, referência inválida, comando sem `exit: 0` ou267tarefa concluída sem evidence.268269### Fechar o Plan Gate270271Quando a estrutura passar ainda com `Plan Gate: Pending`, chame272automaticamente `$specsfy-06-tdd-bdd` no modo `prepare`. Ele usa o BDD da spec273para materializar o predecessor TDD, observa RED e conclui somente essa tarefa274de teste. Ao retomar esta skill, siga em ordem:2752761. execute novamente o validador com `--allow-draft`;2772. altere `Plan Gate` para `Passed` e defina `Status: Planned`;2783. registre o resultado em `Gate do Ato II — Plano`;2794. execute `specsfy gate tasks <spec>` sem `--allow-draft`;2805. execute `specsfy specs transition <id> planned`, equivalente a281 `specsfy specs transition <id> planned`.282283O modo estrito rejeita `Plan Gate: Passed` enquanto algum predecessor TDD de284uma tarefa `[CODE]` continuar aberto. Se a validação falhar, mantenha285`Status: Defined`, `Plan Gate: Failed`, `Delivery Gate: Pending` e relate as286pendências.287288Quando a conversa alterar abrangência, dependência ou capacidade necessária,289chame `$specsfy-interviewer` antes de replanejar e atualize o Effort com290justificativa.291292## Relatar293294Informe a contagem total e por tipo, o caminho crítico, as oportunidades295`[P]` e a cobertura de IDs. Quando o gate passar, anuncie e carregue296automaticamente `$specsfy-07-implement`. O plano vive somente na spec, sem297`tasks.md`.298299## Especialistas sob demanda300301Leia [references/specialists.md](references/specialists.md) ao decompor302trabalho de tecnologia, dados, interface ou operação que demande checklist303próprio.