github / github/spec-kit

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

Abierto Apto para principiantes
#2,698 1 comentario 0 reacciones 0 asignados Ver en GitHub
stale
Lenguaje dominante
Python
Estrellas
137k
Forks
12.3k
Merge medio
2 d 12 h
PR fusionados (30 d)
159

Descripción

### 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.

Guía de contribución

Abrir la guía de contribución

Línea de trabajo

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.

Escrito por el modelo de indexación a partir del texto del issue.

Evaluación

Área
documentation
Tipo de issue
Documentación
Dificultad
2/5
Tiempo estimado
1-3 horas
Estado de actividad
Activo
Claridad
Bien especificado
Aptitud para principiantes
84/100

Recibe los nuevos issues en tu correo

Un resumen breve de issues de GitHub para principiantes.