spec-editor

Objetivo

Transformar um pedido em uma SPEC.md pequena, clara e validavel.

Leia antes de agir

1. AGENTS.md
2. docs/architecture/SPEC_FORMAT.md
3. docs/architecture/TDD.md
4. features/<feature>/SPEC.md, se ja existir

Use esta skill quando

• uma feature nova ainda nao tem SPEC
• a SPEC atual esta ambigua, inchada ou inconsistente
• for preciso ajustar o contrato do formato de SPEC

Nao use esta skill quando

• a tarefa principal for implementar codigo
• a etapa atual ja for RED, GREEN ou REFACTOR
• o trabalho for apenas quality gate, report ou Git

Regras obrigatorias

• uma feature por vez
• reduza escopo em vez de inventar comportamento
• descreva comportamento observavel, nao implementacao
• use criterios verificaveis com prioridade [P1], [P2] ou [P3]
• inclua ## Non-goals, ## Open questions e ## Error cases

Processo

1. Resumir o pedido em 1 ou 2 frases.
2. Escolher o menor recorte util da feature.
3. Identificar se a etapa vai criar uma feature nova ou revisar a feature ativa.
4. Se for feature nova, determinar o proximo prefixo numerico em features/; se for revisao, reutilizar o diretorio existente.
5. Produzir ou revisar features/NNN-<feature>/SPEC.md com frontmatter valido.
6. Classificar criterios por prioridade e explicitar o MVP como todos os P1.
7. Registrar ambiguidades em Open questions ou com NEEDS CLARIFICATION.

Saida final esperada

Entregue:

1. SPEC.md criada ou atualizada
2. resumo curto do escopo e do MVP
3. lista de pontos que exigem spec-clarify, se houver
4. token final SPEC_DRAFT

Se nao houver contexto minimo para produzir uma SPEC valida, pare e escale ao usuario sem avancar para o validator.