Skip to content

docs: add GameHours engineering constitution - #11

Merged
Ayerdi merged 3 commits into
mainfrom
docs/sdd-governance
Sep 1, 2026
Merged

docs: add GameHours engineering constitution#11
Ayerdi merged 3 commits into
mainfrom
docs/sdd-governance

Conversation

@Ayerdi

@Ayerdi Ayerdi commented Sep 1, 2026

Copy link
Copy Markdown
Owner

Summary

Introduce the lightweight SDD governance structure discussed for GameHours:

  • add docs/CONSTITUTION.md with the durable, non-negotiable engineering principles;
  • simplify root AGENTS.md so it remains a small operational context file rather than duplicating roadmap, findings and project philosophy.

Why

The previous AGENTS.md mixed permanent engineering principles, time-sensitive findings, Codex-specific subagent policy and operational guidance. That increases context cost and makes the file age quickly.

The new split follows a lightweight Spec-Driven approach:

  • AGENTS.md: project summary, architecture map, commands, essential boundaries and finish checks;
  • docs/CONSTITUTION.md: durable principles that every spec/plan/implementation/review must respect;
  • roadmap/spec/plan documents keep feature-specific direction and decisions.

Constitution principles

  1. research before deciding;
  2. simplicity and reuse first;
  3. evidence and root cause over assumptions;
  4. preserve data truth and provenance;
  5. local-first and optional integrations;
  6. measure performance before optimizing;
  7. product quality includes UX;
  8. validate before claiming completion.

It also records the intended lightweight SDD loop for substantial work without requiring heavyweight specs for obvious small fixes.

Scope

Documentation/governance only. No production code, dependencies, CI configuration or runtime behavior changed.

Validation

PR CI/CodeQL will validate the repository after this documentation-only change.

@Ayerdi
Ayerdi merged commit 1a37362 into main Sep 1, 2026
4 checks passed
@Ayerdi
Ayerdi deleted the docs/sdd-governance branch September 1, 2026 19:34
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant