Montar a especificação única
Crie ou atualize o pacote specs/draft/<NNNN>-<slug>/, no qual spec.md é a
única fonte normativa de todo o fluxo SDD. Somente o diretório recebe o
número; o arquivo se chama sempre spec.md. A spec consolida descoberta,
research, esclarecimentos, produto, plano técnico, modelo de dados, contratos,
TDD, BDD, validações, tarefas, decisões e conclusão em três atos explícitos.
Evidências externas consultadas vivem em research/. Não gere plan.md,
research.md, data-model.md, tasks.md, checklists ou uma segunda
especificação, porque fontes paralelas divergem e quebram a rastreabilidade.
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.
Pronto quando
specs/draft/<NNNN>-<slug>/spec.md existe com os três atos e as 18 seções do
template, sem placeholders do modelo;
- cada
US, FR, NFR e a feature inteira têm no mínimo três AC que os
declaram em **Cobre**;
specsfy gate spec <spec> --allow-draft passa;
- research material está indexada e nenhum claim
critical segue sem
verificação;
- a transição automática para
$specsfy-04-validate foi anunciada.
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-03-specify → $<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-03-specify — 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.
Preparar
Resolva a raiz do projeto pelo diretório informado pelo usuário ou pelo
diretório atual quando ele não informar outro. Não procure nem promova o
destino para uma raiz Git.
Ao criar uma spec, resolva o diretório desta skill e execute antes de
escrever:
specsfy specs new \
--title "<nome da especificação>" [--slug <slug>] [--project <raiz>]
Pelo MCP, use a tool spec_create. Sem o binário instalado, rode o script
equivalente:
node <diretório-da-skill>/scripts/iniciar_spec.mjs \
--title "<nome da especificação>" [--slug <slug>] [--root <raiz>]
Use o caminho absoluto impresso pelo comando. Ele aloca o próximo ID local,
prefere .specsfy/templates/custom/Spec.md, recorre ao template gerenciado
.specsfy/templates/Spec.md e cria somente
specs/draft/<NNNN>-<slug>/spec.md. Não renomeie o arquivo para incluir o
ID. Ao desenvolver este repositório, o script usa skills/templates/Spec.md
como fallback; no projeto consumidor, template ausente exige
specsfy install.
Ao atualizar, use o caminho da spec existente fornecido ou descoberto sob a
raiz atual, sem executar o inicializador de novo.
Leia em paralelo a captura de origem em specs/inbox/, o item de backlog, o
brief do refinamento, o pedido atual, a spec nesse caminho, seu research/,
.specsfy/DATABASE.md quando existir e os arquivos do repositório que
revelem restrições reais.
Em spec Laravel, leia também .specsfy/PACKAGES.md,
docs/packages/README.md e as fichas de docs/packages/. Se a solicitação
trouxer uma URL GitHub de pacote ou depender de uma biblioteca Composer,
carregue $specsfy-specialist-laravel-package-manager para conferir se o
pacote já existe e registrar a necessidade sem duplicar dependências.
Se faltar informação para identificar problema, ator e resultado, anuncie a
pendência e carregue $specsfy-02-backlog para executar o ciclo. Retome
esta skill ao final e use o brief completo ou parcial produzido.
Leia references/mcr-10.md ao receber relato, história, transcrição ou
especificação a refinar.
Se a jornada depender de informações guardadas e .specsfy/DATABASE.md não
explicar o que o produto precisa lembrar, quem usa essas informações ou
quando elas deixam de ser necessárias, carregue $specsfy-data-discovery e
retome esta skill depois do registro confirmado.
Aplicar o MCR-10
- Preserve a formulação original e identifique finalidade, ator e resultado.
- Analise termos ambíguos, equivalências terminológicas e derivações.
- Use substância, quantidade, qualidade, relação, lugar, tempo, posição,
posse, ação e afecção como lentes adaptativas, não como questionário.
- Distinga cada declaração da pessoa de inferência, hipótese, decisão,
conflito ou questão aberta produzida durante a análise.
- Se existir lacuna aplicável, carregue
$specsfy-02-backlog para executar o
ciclo limitado a oito perguntas por área e retome esta skill ao final do
ciclo. Se a pessoa escolher avançar, aplique a confirmação e o registro
definidos no contrato central. Mantenha Status: Draft e
Definition Gate: Pending quando restarem pontos aplicáveis; não promova a
spec a Defined e não reabra o mesmo ciclo nesta retomada.
- Recombine decisões em afirmações com sujeito, condição, ação e efeito
observável; derive regras, histórias, Gherkin, limites e falhas.
- Registre o resultado nas seções existentes de
spec.md, sem relatório MCR
separado e sem copiar a referência para o pacote da fatia.
Escrever
Pacote e proveniência
- Grave em
<raiz>/specs/draft/<NNNN>-<slug>/spec.md; o ID pertence ao
diretório e o arquivo permanece exatamente spec.md.
- Use
<raiz>/specs/draft/<NNNN>-<slug>/research/ somente para cópias,
snapshots, contratos, schemas, exemplos e notas de proveniência realmente
consultados. Código de produção, testes e documentos normativos ficam fora
desse diretório.
- Ao pesquisar uma API ou documentação externa, armazene a evidência permitida
em
research/ e indexe caminho, origem, versão/data, licença e impacto em
Artefatos de pesquisa armazenados. Se licença ou termos impedirem a cópia,
armazene metadados, URL, data de acesso, checksum/versão quando disponível e
notas próprias, sem reproduzir conteúdo protegido.
- Fora de
spec.md e research/, não crie outra entrada no pacote da feature.
- Ao promover
specs/backlog/<NNNN>-<slug>.md, registre esse caminho na spec e
atualize o item para Status: Promoted com o caminho da spec criada. O
backlog preserva proveniência, mas deixa de governar o comportamento.
- Ao derivar diretamente de
specs/inbox/<data-hora>-<slug>.md, registre o
caminho na spec e preserve a captura sem alteração. A análise inicial é
contexto, não requisito confirmado. A captura continua em specs/inbox/
enquanto a spec estiver em Draft; ela só passa para specs/inbox/processed/
quando $specsfy-04-validate aprovar o Definition Gate e confirmar que as
specs cobrem o pedido inteiro.
Estrutura
Preserve o cabeçalho como uma tabela Markdown de duas colunas, Campo e
Valor; não converta seus metadados em linhas **Campo**: valor.
Na tabela, declare ID como SPEC-NNNN e Slug como <NNNN>-<slug>, com
o slug igual ao diretório pai.
Preserve exatamente os três atos e as 18 seções do template resolvido:
.specsfy/templates/custom/Spec.md quando existir ou
.specsfy/templates/Spec.md caso contrário.
Substitua o conteúdo editorial restante do modelo durante o refinamento; não
deixe seus exemplos ou placeholders na spec promovida para Defined.
Ao atualizar, edite o arquivo existente e preserve IDs e decisões ainda
válidas.
Numere novos itens sem reutilizar ou renumerar IDs removidos:
| Item |
Formato |
| histórias |
US-001 |
| requisitos funcionais |
FR-001 |
| requisitos não funcionais |
NFR-001 |
| cenários de aceite |
AC-001 |
| decisões |
DEC-001 |
Conteúdo
- Escreva cada requisito como comportamento verificável.
- Escreva cada cenário com Given/When/Then e associe-o a pelo menos um
requisito.
- Defina no mínimo três
AC distintos para a feature inteira e para cada
US, FR e NFR. Conte cobertura somente quando o AC declarar o ID em
**Cobre**; use caminho feliz, variação/regra crítica e falha ou limite
material para ampliar contexto sem duplicar cenários equivalentes.
- Inclua fora de escopo, erros, limites, segurança e acessibilidade quando
relevantes.
- Mantenha a seção técnica concreta o bastante para permitir tarefas com
caminhos de arquivo, sem confundir escolha interna com resultado do usuário.
- Registre defaults reversíveis em
Suposições; peça esclarecimento apenas
quando opções plausíveis mudarem materialmente escopo, dados, segurança, UX
ou testes.
- Não deixe placeholders, exemplos do template,
TBD, TODO ou marcadores de
clarificação em um arquivo marcado como Defined.
- Mantenha tarefas futuras na seção
14. Tarefas; skills posteriores
atualizam a mesma seção, não outro arquivo.
- Use os metadados
Definition Gate, Plan Gate e Delivery Gate para
expressar prontidão sem criar relatórios separados.
Interface
- Quando o cabeçalho declarar
Interface para pessoas: Sim, preencha na seção
10 as nove partes do template: stack e convenções locais, telas, fluxo de
informação, menus e navegação principal, formulários e ações, composição,
blocos React e componentes shadcn/ui/ReUI, estados e acessibilidade.
- Use
INTERFACE.md, .specsfy/STACK.md, manifests, telas e código existente
como fonte da stack e do sistema atual; registre o que será preservado e
alterado. Sem esse exame, não proponha biblioteca incompatível nem
reestruture uma tela existente.
- Carregue
$specsfy-specialist-ux-design, $specsfy-specialist-ui-design e
o especialista da stack de interface. Não aceite uma descrição de CRUD que
tenha somente API, banco ou serviço.
- Em Laravel com React, registre explicitamente shadcn/ui e ReUI, todos os
blocos React previstos, suas responsabilidades, arquivos, componentes de
origem e regra de reuso. A página apenas compõe esses blocos.
- Quando não houver interface, declare
Interface para pessoas: Não e explique
por que a entrega não será usada por uma pessoa em uma tela.
Respeitar specs já aprovadas
Se a spec já obteve Definition Gate: Passed e a pessoa pedir para adicionar,
remover, corrigir ou mudar algo, anuncie a pendência e carregue
automaticamente $specsfy-update-spec. Essa skill classifica o impacto,
atualiza a fonte normativa e invalida somente os gates afetados. Retome esta
skill apenas se a mudança devolver a spec ao estado de definição inicial.
Preservar rastreabilidade
Para cada FR e NFR, aponte no mínimo três cenários AC e mantenha
explícito o método de verificação dos NFRs. Para cada história, identifique os
requisitos que entregam seu valor e ao menos três AC. Os mesmos IDs serão
usados mais tarde nos casos TDD e na seção 14.
Controlar research
Antes do planejamento, carregue somente as evidências indexadas e valide os
claims com:
specsfy specs research <spec>
<spec> aceita número, nome da pasta, slug ou caminho. Pelo MCP, use a tool
spec_research. Sem o binário instalado, rode o script equivalente:
node .agents/skills/specsfy-03-specify/scripts/load_research.mjs \
specs/<estado>/<NNNN>-<slug>/spec.md
Para pesquisa material, registre R-ID, criticalidade, claim, veredito,
confiança, evidência local e orçamento na seção 2. Claim critical ainda não
verificado impede o handoff; claim refutado permanece registrado. IDs devem
ser únicos, o gasto não pode superar o limite e a âncora Markdown citada
precisa existir no arquivo local.
Autovalidar
Enquanto o arquivo estiver em Draft, execute a validação estrutural
intermediária:
specsfy gate spec <spec> --allow-draft
Pelo MCP, use a tool gate_spec. Sem o binário instalado, rode o script
equivalente:
node .agents/skills/specsfy-04-validate/scripts/validate_spec.mjs \
specs/<estado>/<NNNN>-<slug>/spec.md --allow-draft
Corrija falhas estruturais em no máximo três ciclos. A skill
specsfy-04-validate faz a revisão semântica, registra o resultado na seção 13
e promove Definition Gate: Passed e Status: Defined. Até lá, mantenha
Status: Draft, Definition Gate: Pending e relate decisões bloqueantes.
Relatar
Informe:
- caminho
specs/<estado>/<NNNN>-<slug>/spec.md;
- caminhos de research armazenados ou a declaração de que não houve fonte
externa;
- status;
- contagem de
US, FR, NFR e AC;
- suposições relevantes;
- transição automática para
$specsfy-04-validate, com motivo e resultado
esperado.
Especialistas sob demanda
Leia references/specialists.md quando requisitos,
NFRs, dados ou decisões técnicas exigirem conhecimento especializado. Registre
o requisito na spec e proponha carregar o especialista. Se ele não estiver
instalado, peça autorização específica antes de instalar.
1---2name: specsfy-03-specify3description: "Cria, inicia ou consolida uma especificação nova ou ainda em Draft em `spec.md`, promovendo uma entrada ou um backlog já refinado. Use também quando uma transição automática exigir criar ou completar a fonte normativa inicial. Inicializa specs em `specs/draft/` e aplica o MCR-10. Para mudar spec aprovada use specsfy-update-spec; para captura sem perguntas use specsfy-01-inbox; para refinamento use specsfy-02-backlog; para revisão sem edição use specsfy-04-validate."4metadata:5 source: https://skillmd.com/skills/promovaweb/specsfy-03-specify6---78# Montar a especificação única910Crie ou atualize o pacote `specs/draft/<NNNN>-<slug>/`, no qual `spec.md` é a11única fonte normativa de todo o fluxo SDD. Somente o diretório recebe o12número; o arquivo se chama sempre `spec.md`. A spec consolida descoberta,13research, esclarecimentos, produto, plano técnico, modelo de dados, contratos,14TDD, BDD, validações, tarefas, decisões e conclusão em três atos explícitos.15Evidências externas consultadas vivem em `research/`. Não gere `plan.md`,16`research.md`, `data-model.md`, `tasks.md`, checklists ou uma segunda17especificação, porque fontes paralelas divergem e quebram a rastreabilidade.1819## Preparação obrigatória2021Antes de executar esta skill, carregue obrigatoriamente `$specsfy-setup` na22raiz do projeto. Em handoff automático, carregue-o de novo antes desta etapa.23Reutilize a raiz confirmada na conversa e não prossiga se o setup apontar uma24pendência.2526## Modo de interação2728Modo de interação: `perguntas`.29Antes de formular qualquer pergunta, leia e aplique o30`Contrato de perguntas numeradas` de `.specsfy/Spec.md`.3132## Pronto quando3334- `specs/draft/<NNNN>-<slug>/spec.md` existe com os três atos e as 18 seções do35 template, sem placeholders do modelo;36- cada `US`, `FR`, `NFR` e a feature inteira têm no mínimo três `AC` que os37 declaram em `**Cobre**`;38- `specsfy gate spec <spec> --allow-draft` passa;39- research material está indexada e nenhum claim `critical` segue sem40 verificação;41- a transição automática para `$specsfy-04-validate` foi anunciada.4243## Orquestrar a conversa4445Ao concluir esta etapa ou detectar trabalho de outra etapa, anuncie46`Pendência detectada: <descrição> — ação: resolvendo nesta etapa` e resolva-a47quando pertencer ao próprio escopo. Quando houver troca de responsabilidade,48anuncie `Transição automática: $specsfy-03-specify → $<destino> — motivo:49<motivo> — resultado esperado: <resultado>` e carregue imediatamente a skill de50destino, sem pedir confirmação nem repetir o comando. Continue na mesma51conversa. Depois de uma correção necessária a esta etapa, anuncie `Retomada52automática: $<destino> → $specsfy-03-specify — pendência resolvida:53<resultado>` e retome-a imediatamente. Reavalie o estado após cada handoff para54evitar ciclos. Não peça confirmação para o handoff; ações sensíveis continuam55exigindo autorização específica.5657## Preparar58591. Resolva a raiz do projeto pelo diretório informado pelo usuário ou pelo60 diretório atual quando ele não informar outro. Não procure nem promova o61 destino para uma raiz Git.622. Ao criar uma spec, resolva o diretório desta skill e execute antes de63 escrever:6465 ```bash66 specsfy specs new \67 --title "<nome da especificação>" [--slug <slug>] [--project <raiz>]68 ```6970 Pelo MCP, use a tool `spec_create`. Sem o binário instalado, rode o script71 equivalente:7273 ```bash74 node <diretório-da-skill>/scripts/iniciar_spec.mjs \75 --title "<nome da especificação>" [--slug <slug>] [--root <raiz>]76 ```7778 Use o caminho absoluto impresso pelo comando. Ele aloca o próximo ID local,79 prefere `.specsfy/templates/custom/Spec.md`, recorre ao template gerenciado80 `.specsfy/templates/Spec.md` e cria somente81 `specs/draft/<NNNN>-<slug>/spec.md`. Não renomeie o arquivo para incluir o82 ID. Ao desenvolver este repositório, o script usa `skills/templates/Spec.md`83 como fallback; no projeto consumidor, template ausente exige84 `specsfy install`.853. Ao atualizar, use o caminho da spec existente fornecido ou descoberto sob a86 raiz atual, sem executar o inicializador de novo.874. Leia em paralelo a captura de origem em `specs/inbox/`, o item de backlog, o88 brief do refinamento, o pedido atual, a spec nesse caminho, seu `research/`,89 `.specsfy/DATABASE.md` quando existir e os arquivos do repositório que90 revelem restrições reais.915. Em spec Laravel, leia também `.specsfy/PACKAGES.md`,92 `docs/packages/README.md` e as fichas de `docs/packages/`. Se a solicitação93 trouxer uma URL GitHub de pacote ou depender de uma biblioteca Composer,94 carregue `$specsfy-specialist-laravel-package-manager` para conferir se o95 pacote já existe e registrar a necessidade sem duplicar dependências.966. Se faltar informação para identificar problema, ator e resultado, anuncie a97 pendência e carregue `$specsfy-02-backlog` para executar o ciclo. Retome98 esta skill ao final e use o brief completo ou parcial produzido.997. Leia `references/mcr-10.md` ao receber relato, história, transcrição ou100 especificação a refinar.1018. Se a jornada depender de informações guardadas e `.specsfy/DATABASE.md` não102 explicar o que o produto precisa lembrar, quem usa essas informações ou103 quando elas deixam de ser necessárias, carregue `$specsfy-data-discovery` e104 retome esta skill depois do registro confirmado.105106## Aplicar o MCR-101071081. Preserve a formulação original e identifique finalidade, ator e resultado.1092. Analise termos ambíguos, equivalências terminológicas e derivações.1103. Use substância, quantidade, qualidade, relação, lugar, tempo, posição,111 posse, ação e afecção como lentes adaptativas, não como questionário.1124. Distinga cada declaração da pessoa de inferência, hipótese, decisão,113 conflito ou questão aberta produzida durante a análise.1145. Se existir lacuna aplicável, carregue `$specsfy-02-backlog` para executar o115 ciclo limitado a oito perguntas por área e retome esta skill ao final do116 ciclo. Se a pessoa escolher `avançar`, aplique a confirmação e o registro117 definidos no contrato central. Mantenha `Status: Draft` e118 `Definition Gate: Pending` quando restarem pontos aplicáveis; não promova a119 spec a `Defined` e não reabra o mesmo ciclo nesta retomada.1206. Recombine decisões em afirmações com sujeito, condição, ação e efeito121 observável; derive regras, histórias, Gherkin, limites e falhas.1227. Registre o resultado nas seções existentes de `spec.md`, sem relatório MCR123 separado e sem copiar a referência para o pacote da fatia.124125## Escrever126127### Pacote e proveniência128129- Grave em `<raiz>/specs/draft/<NNNN>-<slug>/spec.md`; o ID pertence ao130 diretório e o arquivo permanece exatamente `spec.md`.131- Use `<raiz>/specs/draft/<NNNN>-<slug>/research/` somente para cópias,132 snapshots, contratos, schemas, exemplos e notas de proveniência realmente133 consultados. Código de produção, testes e documentos normativos ficam fora134 desse diretório.135- Ao pesquisar uma API ou documentação externa, armazene a evidência permitida136 em `research/` e indexe caminho, origem, versão/data, licença e impacto em137 `Artefatos de pesquisa armazenados`. Se licença ou termos impedirem a cópia,138 armazene metadados, URL, data de acesso, checksum/versão quando disponível e139 notas próprias, sem reproduzir conteúdo protegido.140- Fora de `spec.md` e `research/`, não crie outra entrada no pacote da feature.141- Ao promover `specs/backlog/<NNNN>-<slug>.md`, registre esse caminho na spec e142 atualize o item para `Status: Promoted` com o caminho da spec criada. O143 backlog preserva proveniência, mas deixa de governar o comportamento.144- Ao derivar diretamente de `specs/inbox/<data-hora>-<slug>.md`, registre o145 caminho na spec e preserve a captura sem alteração. A análise inicial é146 contexto, não requisito confirmado. A captura continua em `specs/inbox/`147 enquanto a spec estiver em Draft; ela só passa para `specs/inbox/processed/`148 quando `$specsfy-04-validate` aprovar o Definition Gate e confirmar que as149 specs cobrem o pedido inteiro.150151### Estrutura152153- Preserve o cabeçalho como uma tabela Markdown de duas colunas, `Campo` e154 `Valor`; não converta seus metadados em linhas `**Campo**: valor`.155- Na tabela, declare `ID` como `SPEC-NNNN` e `Slug` como `<NNNN>-<slug>`, com156 o slug igual ao diretório pai.157- Preserve exatamente os três atos e as 18 seções do template resolvido:158 `.specsfy/templates/custom/Spec.md` quando existir ou159 `.specsfy/templates/Spec.md` caso contrário.160- Substitua o conteúdo editorial restante do modelo durante o refinamento; não161 deixe seus exemplos ou placeholders na spec promovida para `Defined`.162- Ao atualizar, edite o arquivo existente e preserve IDs e decisões ainda163 válidas.164- Numere novos itens sem reutilizar ou renumerar IDs removidos:165166 | Item | Formato |167 | --- | --- |168 | histórias | `US-001` |169 | requisitos funcionais | `FR-001` |170 | requisitos não funcionais | `NFR-001` |171 | cenários de aceite | `AC-001` |172 | decisões | `DEC-001` |173174### Conteúdo175176- Escreva cada requisito como comportamento verificável.177- Escreva cada cenário com Given/When/Then e associe-o a pelo menos um178 requisito.179- Defina no mínimo três `AC` distintos para a feature inteira e para cada180 `US`, `FR` e `NFR`. Conte cobertura somente quando o `AC` declarar o ID em181 `**Cobre**`; use caminho feliz, variação/regra crítica e falha ou limite182 material para ampliar contexto sem duplicar cenários equivalentes.183- Inclua fora de escopo, erros, limites, segurança e acessibilidade quando184 relevantes.185- Mantenha a seção técnica concreta o bastante para permitir tarefas com186 caminhos de arquivo, sem confundir escolha interna com resultado do usuário.187- Registre defaults reversíveis em `Suposições`; peça esclarecimento apenas188 quando opções plausíveis mudarem materialmente escopo, dados, segurança, UX189 ou testes.190- Não deixe placeholders, exemplos do template, `TBD`, `TODO` ou marcadores de191 clarificação em um arquivo marcado como `Defined`.192- Mantenha tarefas futuras na seção `14. Tarefas`; skills posteriores193 atualizam a mesma seção, não outro arquivo.194- Use os metadados `Definition Gate`, `Plan Gate` e `Delivery Gate` para195 expressar prontidão sem criar relatórios separados.196197### Interface198199- Quando o cabeçalho declarar `Interface para pessoas: Sim`, preencha na seção200 10 as nove partes do template: stack e convenções locais, telas, fluxo de201 informação, menus e navegação principal, formulários e ações, composição,202 blocos React e componentes shadcn/ui/ReUI, estados e acessibilidade.203- Use `INTERFACE.md`, `.specsfy/STACK.md`, manifests, telas e código existente204 como fonte da stack e do sistema atual; registre o que será preservado e205 alterado. Sem esse exame, não proponha biblioteca incompatível nem206 reestruture uma tela existente.207- Carregue `$specsfy-specialist-ux-design`, `$specsfy-specialist-ui-design` e208 o especialista da stack de interface. Não aceite uma descrição de CRUD que209 tenha somente API, banco ou serviço.210- Em Laravel com React, registre explicitamente shadcn/ui e ReUI, todos os211 blocos React previstos, suas responsabilidades, arquivos, componentes de212 origem e regra de reuso. A página apenas compõe esses blocos.213- Quando não houver interface, declare `Interface para pessoas: Não` e explique214 por que a entrega não será usada por uma pessoa em uma tela.215216## Respeitar specs já aprovadas217218Se a spec já obteve `Definition Gate: Passed` e a pessoa pedir para adicionar,219remover, corrigir ou mudar algo, anuncie a pendência e carregue220automaticamente `$specsfy-update-spec`. Essa skill classifica o impacto,221atualiza a fonte normativa e invalida somente os gates afetados. Retome esta222skill apenas se a mudança devolver a spec ao estado de definição inicial.223224## Preservar rastreabilidade225226Para cada `FR` e `NFR`, aponte no mínimo três cenários `AC` e mantenha227explícito o método de verificação dos NFRs. Para cada história, identifique os228requisitos que entregam seu valor e ao menos três `AC`. Os mesmos IDs serão229usados mais tarde nos casos TDD e na seção 14.230231## Controlar research232233Antes do planejamento, carregue somente as evidências indexadas e valide os234claims com:235236```bash237specsfy specs research <spec>238```239240`<spec>` aceita número, nome da pasta, slug ou caminho. Pelo MCP, use a tool241`spec_research`. Sem o binário instalado, rode o script equivalente:242243```bash244node .agents/skills/specsfy-03-specify/scripts/load_research.mjs \245 specs/<estado>/<NNNN>-<slug>/spec.md246```247248Para pesquisa material, registre `R-ID`, criticalidade, claim, veredito,249confiança, evidência local e orçamento na seção 2. Claim `critical` ainda não250verificado impede o handoff; claim refutado permanece registrado. IDs devem251ser únicos, o gasto não pode superar o limite e a âncora Markdown citada252precisa existir no arquivo local.253254## Autovalidar255256Enquanto o arquivo estiver em Draft, execute a validação estrutural257intermediária:258259```bash260specsfy gate spec <spec> --allow-draft261```262263Pelo MCP, use a tool `gate_spec`. Sem o binário instalado, rode o script264equivalente:265266```bash267node .agents/skills/specsfy-04-validate/scripts/validate_spec.mjs \268 specs/<estado>/<NNNN>-<slug>/spec.md --allow-draft269```270271Corrija falhas estruturais em no máximo três ciclos. A skill272`specsfy-04-validate` faz a revisão semântica, registra o resultado na seção 13273e promove `Definition Gate: Passed` e `Status: Defined`. Até lá, mantenha274`Status: Draft`, `Definition Gate: Pending` e relate decisões bloqueantes.275276## Relatar277278Informe:279280- caminho `specs/<estado>/<NNNN>-<slug>/spec.md`;281- caminhos de research armazenados ou a declaração de que não houve fonte282 externa;283- status;284- contagem de `US`, `FR`, `NFR` e `AC`;285- suposições relevantes;286- transição automática para `$specsfy-04-validate`, com motivo e resultado287 esperado.288289## Especialistas sob demanda290291Leia [references/specialists.md](references/specialists.md) quando requisitos,292NFRs, dados ou decisões técnicas exigirem conhecimento especializado. Registre293o requisito na spec e proponha carregar o especialista. Se ele não estiver294instalado, peça autorização específica antes de instalar.