Montar a especificação única
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.
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;
mantenha o arquivo sempre como spec.md. Consolide 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.
Antes de consolidar uma spec Laravel, leia .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.
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 por
Path.cwd() 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:
node <diretório-da-skill>/scripts/iniciar_spec.mjs \
--title "<nome da especificação>" [--slug <slug>] [--root <raiz>]
- Use o caminho absoluto impresso pelo script. 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; nunca 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; não execute o inicializador novamente.
- Leia a captura de origem em
specs/inbox/, o item de backlog, o brief da
refinamento do backlog, o pedido atual, a spec nesse caminho, seu research/
e arquivos
do repositório que revelem restrições reais.
- Se não houver informação suficiente para identificar problema, ator e
resultado, anuncie a pendência e carregue
$specsfy-02-backlog para executar
o ciclo.
Retome esta skill ao final do ciclo 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.
- Leia
.specsfy/DATABASE.md quando existir. Se a jornada depender de
informações guardadas e o arquivo 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; não gere relatório
MCR separado nem copie a referência para o pacote da fatia.
Escrever
- Grave sempre 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. Não coloque código de produção, testes ou documentos normativos
nesse 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.
- 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> e mantenha 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:
- histórias:
US-001;
- requisitos funcionais:
FR-001;
- requisitos não funcionais:
NFR-001;
- cenários de aceite:
AC-001;
- decisões:
DEC-001.
- 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.
- Quando o cabeçalho declarar
Interface para pessoas: Sim, preencha na seção
10 as nove partes do template com 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. Não proponha
biblioteca incompatível nem reestruture uma tela existente sem esse exame.
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.
- 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, nunca outro arquivo.
- Use os metadados
Definition Gate, Plan Gate e Delivery Gate para
expressar prontidão sem criar relatórios separados.
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 retornar 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 o método
de verificação explícito dos NFRs. Para cada história, identifique os requisitos
que entregam seu valor e ao menos três AC. Use os mesmos IDs mais tarde nos
casos TDD e na seção 14.
Controlar research
- Antes do planejamento, carregue somente as evidências indexadas e valide
claims com:
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 bloqueia o handoff; claim refutado permanece registrado. IDs devem
ser únicos, 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:
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-specify-23description: "Use quando o usuário pede para promover uma entrada ou backlog já refinado, criar, iniciar ou consolidar uma especificação nova ou ainda em Draft em `spec.md`. 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 e para revisão sem edição use specsfy-04-validate."4metadata:5 source: https://skillmd.com/skills/promovaweb/specsfy-03-specify-26---78# Montar a especificação única910## Preparação obrigatória1112Antes de executar esta skill, carregue obrigatoriamente `$specsfy-setup` na13raiz do projeto. Em handoff automático, carregue-o de novo antes desta etapa.14Reutilize a raiz confirmada na conversa e não prossiga se o setup apontar uma15pendência.1617## Modo de interação1819Modo de interação: `perguntas`.20Antes de formular qualquer pergunta, leia e aplique o21`Contrato de perguntas numeradas` de `.specsfy/Spec.md`.2223Crie ou atualize o pacote `specs/draft/<NNNN>-<slug>/`, no qual `spec.md` é a24única fonte normativa de todo o fluxo SDD. Somente o diretório recebe o número;25mantenha o arquivo sempre como `spec.md`. Consolide descoberta, research,26esclarecimentos, produto, plano técnico, modelo de dados, contratos, TDD, BDD,27validações, tarefas, decisões e conclusão em três atos explícitos. Evidências28externas consultadas vivem em `research/`; não gere `plan.md`, `research.md`,29`data-model.md`, `tasks.md`, checklists ou uma segunda especificação.3031Antes de consolidar uma spec Laravel, leia `.specsfy/PACKAGES.md`,32`docs/packages/README.md` e as fichas de `docs/packages/`. Se a solicitação33trouxer uma URL GitHub de pacote ou depender de uma biblioteca Composer,34carregue `$specsfy-specialist-laravel-package-manager` para conferir se o35pacote já existe e registrar a necessidade sem duplicar dependências.3637## Orquestrar a conversa3839Ao concluir esta etapa ou detectar trabalho de outra etapa, anuncie40`Pendência detectada: <descrição> — ação: resolvendo nesta etapa` e resolva-a41quando pertencer ao próprio escopo. Quando houver troca de responsabilidade,42anuncie `Transição automática: $specsfy-03-specify → $<destino> — motivo:43<motivo> — resultado esperado: <resultado>` e carregue imediatamente a skill de44destino, sem pedir confirmação nem repetir o comando. Continue na mesma45conversa. Depois de uma correção necessária a esta etapa, anuncie `Retomada46automática: $<destino> → $specsfy-03-specify — pendência resolvida:47<resultado>` e retome-a imediatamente. Reavalie o estado após cada handoff para48evitar ciclos. Não peça confirmação para o handoff; ações sensíveis continuam49exigindo autorização específica.5051## Preparar52531. Resolva a raiz do projeto pelo diretório informado pelo usuário ou por54 `Path.cwd()` quando ele não informar outro. Não procure nem promova o destino55 para uma raiz Git.562. Ao criar uma spec, resolva o diretório desta skill e execute antes de57 escrever:5859```bash60node <diretório-da-skill>/scripts/iniciar_spec.mjs \61 --title "<nome da especificação>" [--slug <slug>] [--root <raiz>]62```63641. Use o caminho absoluto impresso pelo script. Ele aloca o próximo ID local,65 prefere `.specsfy/templates/custom/Spec.md`, recorre ao template gerenciado66 `.specsfy/templates/Spec.md` e cria somente67 `specs/draft/<NNNN>-<slug>/spec.md`; nunca renomeie o arquivo para incluir o68 ID.69 Ao desenvolver este repositório, o script usa `skills/templates/Spec.md` como70 fallback; no projeto consumidor, template ausente exige `specsfy install`.712. Ao atualizar, use o caminho da spec existente fornecido ou descoberto sob a72 raiz atual; não execute o inicializador novamente.733. Leia a captura de origem em `specs/inbox/`, o item de backlog, o brief da74 refinamento do backlog, o pedido atual, a spec nesse caminho, seu `research/`75 e arquivos76 do repositório que revelem restrições reais.774. Se não houver informação suficiente para identificar problema, ator e78 resultado, anuncie a pendência e carregue `$specsfy-02-backlog` para executar79 o ciclo.80 Retome esta skill ao final do ciclo e use o brief completo81 ou parcial produzido.825. Leia `references/mcr-10.md` ao receber relato, história, transcrição ou83 especificação a refinar.846. Leia `.specsfy/DATABASE.md` quando existir. Se a jornada depender de85 informações guardadas e o arquivo não explicar o que o produto precisa86 lembrar, quem usa essas informações ou quando elas deixam de ser87 necessárias, carregue `$specsfy-data-discovery` e retome esta skill depois88 do registro confirmado.8990## Aplicar o MCR-1091921. Preserve a formulação original e identifique finalidade, ator e resultado.932. Analise termos ambíguos, equivalências terminológicas e derivações.943. Use substância, quantidade, qualidade, relação, lugar, tempo, posição, posse,95 ação e afecção como lentes adaptativas, não como questionário.964. Distinga cada declaração da pessoa de inferência, hipótese, decisão, conflito97 ou questão aberta produzida durante a análise.985. Se existir lacuna aplicável, carregue `$specsfy-02-backlog` para executar o99 ciclo limitado a oito perguntas por área e retome esta skill ao final do100 ciclo. Se a pessoa101 escolher `avançar`, aplique a confirmação e o registro definidos no contrato102 central. Mantenha `Status: Draft` e `Definition Gate: Pending` quando103 restarem pontos aplicáveis; não promova a spec a `Defined` e não reabra o104 mesmo ciclo nesta retomada.1056. Recombine decisões em afirmações com sujeito, condição, ação e efeito106 observável; derive regras, histórias, Gherkin, limites e falhas.1077. Registre o resultado nas seções existentes de `spec.md`; não gere relatório108 MCR separado nem copie a referência para o pacote da fatia.109110## Escrever111112- Grave sempre em `<raiz>/specs/draft/<NNNN>-<slug>/spec.md`; o ID pertence ao113 diretório e o arquivo permanece exatamente `spec.md`.114- Use `<raiz>/specs/draft/<NNNN>-<slug>/research/` somente para cópias,115 snapshots, contratos, schemas, exemplos e notas de proveniência realmente116 consultados. Não coloque código de produção, testes ou documentos normativos117 nesse diretório.118- Ao pesquisar uma API ou documentação externa, armazene a evidência permitida119 em `research/` e indexe caminho, origem, versão/data, licença e impacto em120 `Artefatos de pesquisa armazenados`. Se licença ou termos impedirem a cópia,121 armazene metadados, URL, data de acesso, checksum/versão quando disponível e122 notas próprias, sem reproduzir conteúdo protegido.123- Fora de `spec.md` e `research/`, não crie outra entrada no pacote da feature.124- Ao promover `specs/backlog/<NNNN>-<slug>.md`, registre esse caminho na spec e125 atualize o item para `Status: Promoted` com o caminho da spec criada. O126 backlog127 preserva proveniência, mas deixa de governar o comportamento.128- Ao derivar diretamente de `specs/inbox/<data-hora>-<slug>.md`, registre o129 caminho na spec e preserve a captura sem alteração. A análise inicial é130 contexto, não requisito confirmado. A captura continua em `specs/inbox/`131 enquanto a spec estiver em Draft; ela só passa para `specs/inbox/processed/`132 quando `$specsfy-04-validate` aprovar o Definition Gate e confirmar que as133 specs cobrem o pedido inteiro.134- Preserve o cabeçalho como uma tabela Markdown de duas colunas, `Campo` e135 `Valor`; não converta seus metadados em linhas `**Campo**: valor`.136- Na tabela, declare `ID` como `SPEC-NNNN` e `Slug` como137 `<NNNN>-<slug>` e mantenha o slug igual ao diretório pai.138- Preserve exatamente os três atos e as 18 seções do template resolvido:139 `.specsfy/templates/custom/Spec.md` quando existir ou140 `.specsfy/templates/Spec.md` caso contrário.141- Substitua o conteúdo editorial restante do modelo durante o refinamento; não142 deixe seus exemplos ou placeholders na spec promovida para `Defined`.143- Ao atualizar, edite o arquivo existente e preserve IDs e decisões ainda144 válidas.145- Numere novos itens sem reutilizar ou renumerar IDs removidos:146 - histórias: `US-001`;147 - requisitos funcionais: `FR-001`;148 - requisitos não funcionais: `NFR-001`;149 - cenários de aceite: `AC-001`;150 - decisões: `DEC-001`.151- Escreva cada requisito como comportamento verificável.152- Escreva cada cenário com Given/When/Then e associe-o a pelo menos um153 requisito.154- Defina no mínimo três `AC` distintos para a feature inteira e para cada155 `US`, `FR` e `NFR`. Conte cobertura somente quando o `AC` declarar o ID em156 `**Cobre**`; use caminho feliz, variação/regra crítica e falha ou limite157 material para ampliar contexto sem duplicar cenários equivalentes.158- Inclua fora de escopo, erros, limites, segurança e acessibilidade quando159 relevantes.160- Quando o cabeçalho declarar `Interface para pessoas: Sim`, preencha na seção161 10 as nove partes do template com stack e convenções locais, telas, fluxo de162 informação, menus e navegação principal, formulários e ações, composição,163 blocos React e componentes shadcn/ui/ReUI, estados e acessibilidade. Use164 `INTERFACE.md`, `.specsfy/STACK.md`, manifests, telas e código existente165 como fonte da stack166 e do sistema atual; registre o que será preservado e alterado. Não proponha167 biblioteca incompatível nem reestruture uma tela existente sem esse exame.168 Carregue169 `$specsfy-specialist-ux-design`, `$specsfy-specialist-ui-design` e o170 especialista da stack de interface. Não aceite uma descrição de CRUD que171 tenha somente API, banco ou serviço.172 Em Laravel com React, registre explicitamente shadcn/ui e ReUI, todos os173 blocos React previstos, suas responsabilidades, arquivos, componentes de174 origem e regra de reuso. A página apenas compõe esses blocos.175- Quando não houver interface, declare `Interface para pessoas: Não` e explique176 por que a entrega não será usada por uma pessoa em uma tela.177- Mantenha a seção técnica concreta o bastante para permitir tarefas com178 caminhos de arquivo, sem confundir escolha interna com resultado do usuário.179- Registre defaults reversíveis em `Suposições`; peça esclarecimento apenas180 quando opções plausíveis mudarem materialmente escopo, dados, segurança, UX ou181 testes.182- Não deixe placeholders, exemplos do template, `TBD`, `TODO` ou marcadores de183 clarificação em um arquivo marcado como `Defined`.184- Mantenha tarefas futuras na seção `14. Tarefas`; skills posteriores atualizam185 a mesma seção, nunca outro arquivo.186- Use os metadados `Definition Gate`, `Plan Gate` e `Delivery Gate` para187 expressar prontidão sem criar relatórios separados.188189## Respeitar specs já aprovadas190191Se a spec já obteve `Definition Gate: Passed` e a pessoa pedir para adicionar,192remover, corrigir ou mudar algo, anuncie a pendência e carregue automaticamente193`$specsfy-update-spec`. Essa skill classifica o impacto, atualiza a fonte194normativa e invalida somente os gates afetados. Retome esta skill apenas se a195mudança retornar a spec ao estado de definição inicial.196197## Preservar rastreabilidade198199Para cada `FR` e `NFR`, aponte no mínimo três cenários `AC` e mantenha o método200de verificação explícito dos NFRs. Para cada história, identifique os requisitos201que entregam seu valor e ao menos três `AC`. Use os mesmos IDs mais tarde nos202casos TDD e na seção 14.203204## Controlar research205206- Antes do planejamento, carregue somente as evidências indexadas e valide207 claims com:208209```bash210node .agents/skills/specsfy-03-specify/scripts/load_research.mjs \211 specs/<estado>/<NNNN>-<slug>/spec.md212```213214- Para pesquisa material, registre `R-ID`, criticalidade, claim, veredito,215 confiança, evidência local e orçamento na seção 2. Claim `critical` ainda não216 verificado bloqueia o handoff; claim refutado permanece registrado. IDs devem217 ser únicos, gasto não pode superar o limite e a âncora Markdown citada precisa218 existir no arquivo local.219220## Autovalidar221222Enquanto o arquivo estiver em Draft, execute a validação estrutural223intermediária:224225```bash226node .agents/skills/specsfy-04-validate/scripts/validate_spec.mjs \227 specs/<estado>/<NNNN>-<slug>/spec.md --allow-draft228```229230Corrija falhas estruturais em no máximo três ciclos. A skill231`specsfy-04-validate` faz a revisão semântica, registra o resultado na seção 13232e promove `Definition Gate: Passed` e `Status: Defined`. Até lá, mantenha233`Status: Draft`, `Definition Gate: Pending` e relate decisões bloqueantes.234235## Relatar236237Informe:238239- caminho `specs/<estado>/<NNNN>-<slug>/spec.md`;240- caminhos de research armazenados ou a declaração de que não houve fonte241 externa;242- status;243- contagem de `US`, `FR`, `NFR` e `AC`;244- suposições relevantes;245- transição automática para `$specsfy-04-validate`, com motivo e resultado246 esperado.247248## Especialistas sob demanda249250Leia [references/specialists.md](references/specialists.md) quando requisitos,251NFRs, dados ou decisões técnicas exigirem conhecimento especializado. Registre252o requisito na spec e proponha carregar o especialista. Se ele não estiver253instalado, peça autorização específica antes de instalar.