Skip to content

docs: amend the constitution to v1.1.0 and align CLAUDE.md - #11

Merged
AnaLauraFFerraz merged 1 commit into
mainfrom
docs/constitution-1.1.0
Oct 20, 2026
Merged

AnaLauraFFerraz merged 1 commit into
mainfrom
docs/constitution-1.1.0

Conversation

@AnaLauraFFerraz

Copy link
Copy Markdown
Owner

Emenda da constituição, de 1.0.0 para 1.1.0, preparada desde a spec 002 (CI no GitHub Actions, já mergeada). Só documentação: muda .specify/memory/constitution.md e duas linhas do CLAUDE.md. Nenhum arquivo de src/, tools/ ou do workflow muda.

O que muda

  1. A CI como portão de merge (Development Workflow): o merge na main exige os checks typecheck e test verdes, com a main protegida pelo ruleset descrito no README (PR obrigatório, branch atualizada, histórico linear, bypass vazio, administradores incluídos, só "Rebase and merge"). A única exceção é o procedimento de último recurso do README para o GitHub Actions indisponível (desativar o ruleset, mergear, reativar na hora), sempre registrado no PR. A regra de rodar os testes e o typecheck antes de cada commit continua, como verificação local.
  2. Node mínimo de 22.6 para 22.17 (Technology and Quality Constraints): a guarda da descoberta de testes usa o fs.globSync, estável só a partir da 22.17. A major em uso, local e na CI, continua sendo a fixada no .nvmrc.
  3. Tipo de commit ci: entra na lista, para mudanças no workflow do GitHub Actions.
  4. npm run typecheck no lugar de npx tsc --noEmit na regra de verificação local: é o mesmo script que a CI chama.
  5. Exceção de 2026-10-18 registrada na regra "Published git history is never rewritten": a main foi reescrita com git filter-repo para remover um trailer Co-Authored-By de um commit já publicado. A regra continua valendo e a exceção não é precedente, no mesmo sentido do texto que já estava no CLAUDE.md.

No CLAUDE.md: sai a nota de divergência temporária ("the constitution still says ≥ 22.6 until its amendment PR") e o ci: entra na lista de tipos de commit. Nada mais muda nele.

Por que 1.1.0

A regra de versionamento da constituição é: MAJOR para remover ou redefinir um princípio, MINOR para adicionar um princípio ou uma seção, PATCH para esclarecimentos.

  • Não é MAJOR: os seis princípios ficam iguais.
  • Não é PATCH: o portão de merge é uma obrigação nova, o Node mínimo é uma restrição mais estreita e o ci: amplia uma lista fechada; nada disso é esclarecimento.
  • MINOR: a regra só nomeia MINOR para princípio ou seção nova; uma regra nova dentro de uma seção existente é lida como MINOR, o caso mais próximo.
  • Os itens 4 e 5 são esclarecimentos e não mudam a versão sozinhos.

Sync Impact Report

Está no topo de .specify/memory/constitution.md, como comentário HTML, como o Spec Kit prevê. Fica como o registro da emenda.

Arquivos dependentes conferidos

Arquivo Situação
CLAUDE.md Atualizado neste PR (as duas linhas acima)
README.md Nada a mudar: já diz Node ≥ 22.17 e descreve o ruleset e o último recurso
package.json, .nvmrc, .github/workflows/ci.yml Nada a mudar: >=22.17, 22, e os jobs chamam npm run typecheck e npm test
.specify/templates/plan-template.md Nada a mudar: o gate "Constitution Check" é genérico
.specify/templates/spec-template.md, tasks-template.md, checklist-template.md Nada a mudar: não citam regras específicas
.claude/skills/speckit-* Nada a mudar: leem a constituição em tempo de execução
specs/001-realtime-replay, specs/002-github-actions-ci Citam a v1.0.0; ficam como registro histórico

Verificações locais

npm run typecheck exit 0; npm test com a guarda em 23 arquivos e # tests 95 # pass 95 # fail 0 # skipped 0.

@AnaLauraFFerraz
AnaLauraFFerraz merged commit 6fa1837 into main Oct 20, 2026
2 checks passed
@AnaLauraFFerraz
AnaLauraFFerraz deleted the docs/constitution-1.1.0 branch October 20, 2026 19:51
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant