Files
website-enchun-mgr/.specify/memory/constitution_update_checklist.md

2.7 KiB

Constitution Update Checklist

When amending the constitution (/memory/constitution.md), ensure all dependent documents are updated to maintain consistency.

Templates to Update

When adding/modifying ANY article:

  • /templates/plan-template.md - Update Constitution Check section
  • /templates/spec-template.md - Update if requirements/scope affected
  • /templates/tasks-template.md - Update if new task types needed
  • /.claude/commands/plan.md - Update if planning process changes
  • /.claude/commands/tasks.md - Update if task generation affected
  • /CLAUDE.md - Update runtime development guidelines

Article-specific updates:

Article I (Library-First):

  • Ensure templates emphasize library creation
  • Update CLI command examples
  • Add llms.txt documentation requirements

Article II (CLI Interface):

  • Update CLI flag requirements in templates
  • Add text I/O protocol reminders

Article III (Test-First):

  • Update test order in all templates
  • Emphasize TDD requirements
  • Add test approval gates

Article IV (Integration Testing):

  • List integration test triggers
  • Update test type priorities
  • Add real dependency requirements

Article V (Observability):

  • Add logging requirements to templates
  • Include multi-tier log streaming
  • Update performance monitoring sections

Article VI (Versioning):

  • Add version increment reminders
  • Include breaking change procedures
  • Update migration requirements

Article VII (Simplicity):

  • Update project count limits
  • Add pattern prohibition examples
  • Include YAGNI reminders

Validation Steps

  1. Before committing constitution changes:

    • All templates reference new requirements
    • Examples updated to match new rules
    • No contradictions between documents
  2. After updating templates:

    • Run through a sample implementation plan
    • Verify all constitution requirements addressed
    • Check that templates are self-contained (readable without constitution)
  3. Version tracking:

    • Update constitution version number
    • Note version in template footers
    • Add amendment to constitution history

Common Misses

Watch for these often-forgotten updates:

  • Command documentation (/commands/*.md)
  • Checklist items in templates
  • Example code/commands
  • Domain-specific variations (web vs mobile vs CLI)
  • Cross-references between documents

Template Sync Status

Last sync check: 2025-07-16

  • Constitution version: 2.1.1
  • Templates aligned: (missing versioning, observability details)

This checklist ensures the constitution's principles are consistently applied across all project documentation.