SDD básico com Claude Code

CLAUDE.md

Desenvolvimento Spec-Driven

Este projeto adota Spec-Driven Development: a especificação é a fonte da verdade. Código deriva da spec, não o inverso.

Workflow:

1. Toda mudança não-trivial começa com uma spec em specs/<feature>/spec.md
2. Spec aprovada → plan.md (decisões técnicas) e tasks.md (passos verificáveis)
3. PR carrega spec + implementação juntos e referencia a spec na descrição
4. Comportamento mudou? Atualize a spec primeiro, depois o código

Estrutura mínima por feature (em specs/<feature>/):

• spec.md — o quê (problema, requisitos, critérios de aceitação)
• plan.md — como (contratos, decisões, riscos)
• tasks.md — passos verificáveis com checkboxes

Bug fixes triviais, refactors menores e bumps de dependência não precisam de spec.

Detalhes da convenção em specs/README.md.

specs - README.md

Specs

Especificações do ticketcreator. Este projeto adota Spec-Driven Development: a spec é a fonte da verdade. Código deriva dela, não o inverso.

Estrutura

Cada feature tem sua pasta em specs/<feature>/:

• spec.md — o quê (problema, requisitos, critérios de aceitação)
• plan.md — como (contratos, decisões técnicas, riscos)
• tasks.md — passos verificáveis com checkboxes

Workflow

1. Toda mudança não-trivial começa com uma spec em specs/<feature>/spec.md
2. Spec aprovada → plan.md e tasks.md (juntos no mesmo PR de spec, ou no PR de implementação)
3. PR de implementação carrega spec + código juntos e referencia a spec na descrição
4. Comportamento mudou? Atualize a spec primeiro, depois o código

Quando não criar spec

• Bug fixes triviais e localizados
• Refactors sem mudança de comportamento
• Bumps de dependência
• Ajustes de docs/comentários

Em dúvida, prefira criar a spec.

Templates

Sem _template/ aspiracional. A primeira spec real do projeto serve de referência viva para as próximas — convenções emergem do uso.