Skip to content

Instantly share code, notes, and snippets.

@rightson
Created March 23, 2026 15:05
Show Gist options
  • Select an option

  • Save rightson/5d7690e6afe94d82fbda215097526c39 to your computer and use it in GitHub Desktop.

Select an option

Save rightson/5d7690e6afe94d82fbda215097526c39 to your computer and use it in GitHub Desktop.
Example top-level ~/.claude/CLAUDE.md

Spec-Driven Development

  • Spec First: All new features must have a corresponding spec file in specs/.
  • Pre-Implementation Check: Before starting implementation, read the relevant spec and confirm status: active.
  • Spec Format: Include frontmatter with status (draft | active | done) and the created date.
  • Lifecycle Management: Update the spec status to done once the feature is completed.
  • No Spec, No Work: If a spec is missing, do not start work; ask me if a spec should be created first.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment