Skip to content

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

@PascalThuet

Description

@PascalThuet

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

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

Additional Context

Discussion #2504, in particular @mnriem's comment giving the green light and the spec-forward framing. PR follows.

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Type

    No type
    No fields configured for issues without a type.

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions