[Feature]: Dogfood /constitution on spec-kit (add memory/constitution.md)
Chưa có ai nhận issue này.
Đánh giá
- Độ khó
- 2/5
- Thời gian dự kiến
- 1-3 giờ
- Mức phù hợp với người mới
- 84/100
- Loại issue
- Tài liệu
- Độ rõ ràng
- Đặc tả rõ ràng
- Mức độ hoạt động
- Sôi nổi
- Lĩnh vực
- documentation
Hướng nghiên cứu
Bắt đầu với các tiêu chí chấp nhận của issue và cuộc thảo luận review #2504, đặc biệt là cách định khung spec-forward và mang tính lịch sử «once-shipped». Sử dụng workflow /constitution để soạn memory/constitution.md, bao quát khi nào SDD được áp dụng và khi nào không, không thêm hạn ngạch hoặc các cam kết downstream. Được xem là hoàn tất khi tài liệu duy nhất tồn tại trong main và đáp ứng từng tiêu chí được liệt kê.
Do mô hình lập chỉ mục viết ra từ nội dung của issue.
Mô tả
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.
- Ngôn ngữ chính
- Python
- Star
- 138k
- Fork
- 12.4k
- Merge trung bình
- 3 ngày 6 giờ
- Pull request đã merge (30 ngày)
- 136
Hướng dẫn đóng góp
Bắt đầu từ đâu
- Đọc hết issue, rồi đọc hướng dẫn đóng góp của dự án.
- Bình luận trên issue rằng bạn sẽ nhận — tránh hai người làm cùng một việc.
- Fork repository và làm thay đổi trên một nhánh.
- Mở pull request có tham chiếu số hiệu của issue.
Issue khác của github/spec-kit
-
enhancement needs-triage
Độ khó 2/5 1-3 giờ Mức phù hợp với người mới 78/100
-
enhancement needs-triage
Độ khó 2/5 1-3 giờ Mức phù hợp với người mới 72/100
-
enhancement needs-triage
Độ khó 2/5 1-3 giờ Mức phù hợp với người mới 68/100
-
[Feature]: 给 slug 添加默认值 Đang mởenhancement needs-triage triage-can-wait
Độ khó 2/5 1-3 giờ Mức phù hợp với người mới 65/100
-
extension-submission triage-can-wait
Độ khó 2/5 1-3 giờ Mức phù hợp với người mới 75/100
Tất cả issue của github/spec-kit
Issue tương tự
-
documentation help wanted
Độ khó 2/5 1-3 giờ Mức phù hợp với người mới 90/100
-
Độ khó 2/5 1-3 giờ Mức phù hợp với người mới 90/100
simonw/sqlite-utils#872 ·
-
Độ khó 2/5 1-3 giờ Mức phù hợp với người mới 88/100
-
Độ khó 2/5 1-3 giờ Mức phù hợp với người mới 82/100
-
Độ khó 2/5 1-3 giờ Mức phù hợp với người mới 78/100