[Feature]: Dogfood /constitution on spec-kit (add memory/constitution.md)

Aperta Adatta ai principianti
#2,698 1 commento 0 reazioni 0 assegnatari Vedi su GitHub

Nessuno ha ancora preso questa issue.

Valutazione

Difficoltà
2/5
Tempo stimato
1-3 ore
Idoneità per principianti
84/100
Tipo di issue
Documentazione
Chiarezza
Specificata chiaramente
Stato di attività
Attiva
Ambito
documentation

Direzione di ricerca

Inizia dai criteri di accettazione dell’issue e dalla discussione di revisione #2504, in particolare dall’impostazione spec-forward e storica «once-shipped». Usa il workflow /constitution per redigere memory/constitution.md, descrivendo quando si applica SDD e quando non si applica, senza aggiungere quote o impegni downstream. Il lavoro è completato quando l’unico documento esiste in main e soddisfa ciascun criterio elencato.

Scritto dal modello di indicizzazione a partire dal testo della issue.

Descrizione

stale
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
  1. Contributor unsure whether their PR warrants a spec consults the constitution instead of asking per-PR.
  2. Reviewer points to it to flag a fitting candidate ("cross-cutting and security-sensitive — want to spec this?").
Acceptance Criteria
  • memory/constitution.md exists in main
  • Drafted via the /constitution workflow
  • 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.

Lingua principale
Python
Stelle
138k
Fork
12.4k
Merge medio
3g 6h
PR unite (30g)
136

Guida per i contributori

Apri la guida per i contributori

Come iniziare

  1. Leggi tutta la issue e poi la guida ai contributi del progetto.
  2. Commenta sulla issue per dire che te ne occupi tu — evita che due persone facciano lo stesso lavoro.
  3. Fai un fork del repository e lavora su un branch.
  4. Apri una pull request che faccia riferimento al numero della issue.

Altre issue di github/spec-kit

Tutte le issue di github/spec-kit

Issue simili

Altre issue su Python

Ricevi le nuove issue nella tua casella

Un breve riepilogo di issue GitHub adatte ai principianti.