[Feature]: Dogfood /constitution on spec-kit (add memory/constitution.md)
Nobody has claimed this yet.
Assessment
- Difficulty
- 2/5
- Estimated time
- 1-3 hours
- Newbie friendliness
- 84/100
- Issue type
- Documentation
- Clarity
- Clearly specified
- Activity status
- Active
- Domain
- documentation
Research direction
Start with the issue’s acceptance criteria and review discussion #2504, especially the spec-forward, historical-once-shipped framing. Use the /constitution workflow to draft memory/constitution.md, covering when SDD applies and when it does not without adding quotas or downstream commitments. Done means the single document exists in main and satisfies each listed criterion.
Written by the indexing model from the issue text.
Description
Problem Statement
Spec-kit ships /constitution but the repo itself has no memory/constitution.md in main. There is no upstream artifact showing the workflow runs on the project that ships it — the dogfooding gap raised in discussion #2504. A maintainer (@mnriem) gave a green light to try it there, with the framing that specs in this repo should be spec-forward, historical-once-shipped (no living-doc maintenance burden against a fast-moving codebase).
Proposed Solution
Add memory/constitution.md, drafted via the /constitution workflow. It codifies:
- When SDD applies here: non-trivial scope, ambiguous design, cross-cutting impact, security/correctness stakes.
- When it does not: plumbing, refactors, catalog updates, doc fixes.
- Stance: spec-forward; historical once shipped (frozen snapshot, not maintained).
Single document. No quota, no cadence, no downstream commitment to spec any particular future PR.
Alternatives Considered
- Retroactive specs on shipped PRs (e.g. #2393): parked — does not fit "spec-forward."
- Per-feature triage on every PR: re-litigates the question on every change, more friction.
- Status quo: dogfooding gap remains.
Component
Documentation
AI Agent (if applicable)
Not applicable (repository governance, not agent-specific)
Use Cases
- Contributor unsure whether their PR warrants a spec consults the constitution instead of asking per-PR.
- Reviewer points to it to flag a fitting candidate ("cross-cutting and security-sensitive — want to spec this?").
Acceptance Criteria
-
memory/constitution.mdexists inmain - Drafted via the
/constitutionworkflow - Codifies criteria for when SDD applies to spec-kit work
- Codifies the "spec-forward, historical-once-shipped" stance per #2504
- No downstream commitments added (no quota, no required follow-up specs)
Additional Context
Discussion #2504, in particular @mnriem's comment giving the green light and the spec-forward framing. PR follows.
- Dominant language
- Python
- Stars
- 138k
- Forks
- 12.4k
- Avg merge
- 3d 6h
- Merged PRs (30d)
- 136
Contributor guide
First steps
- Read the whole issue, then the project's contributing guide.
- Comment on the issue to say you are picking it up — it saves two people doing the same work.
- Fork the repository and make your change on a branch.
- Open a pull request that references the issue number.
More from github/spec-kit
-
enhancement needs-triage
Difficulty 2/5 1-3 hours Newbie friendliness 78/100
-
enhancement needs-triage
Difficulty 2/5 1-3 hours Newbie friendliness 72/100
-
enhancement needs-triage
Difficulty 2/5 1-3 hours Newbie friendliness 68/100
-
enhancement needs-triage triage-can-wait
Difficulty 2/5 1-3 hours Newbie friendliness 65/100
-
extension-submission triage-can-wait
Difficulty 2/5 1-3 hours Newbie friendliness 75/100
Similar issues
-
Difficulty 2/5 1-3 hours Newbie friendliness 88/100
-
Difficulty 2/5 1-3 hours Newbie friendliness 82/100
-
Difficulty 2/5 1-3 hours Newbie friendliness 78/100
-
enhancement
Difficulty 2/5 1-3 hours Newbie friendliness 72/100
-
Difficulty 2/5 1-3 hours Newbie friendliness 74/100