Skip to content

feat: add canonical AGENTS governance adapter - #25

Merged
MrPointer merged 2 commits into
mainfrom
feature/speckit-preset-agnostic-constitution
Aug 4, 2026
Merged

MrPointer merged 2 commits into
mainfrom
feature/speckit-preset-agnostic-constitution

Conversation

@MrPointer

Copy link
Copy Markdown
Owner

📝 Summary

Add a standalone Spec Kit preset that treats applicable AGENTS.md files as canonical project governance without copying their rules. The preset installs an immutable constitution artifact and keeps optional Spec Kit-only overrides separate. Fixture-driven validation covers precedence, conflicts, missing sources, and mutation safety.

Key Decisions

📜 Fixed Constitution

Replace the stock constitution template with a project-independent artifact that delegates governance to root and nested AGENTS.md files. /speckit.constitution initializes that artifact once, preserves matching content, and blocks writes when drift is detected.

🔀 Local Governance

Reserve .specify/memory/constitution.local.md for explicitly requested Spec Kit additions or overrides. Local conflicts take precedence only within Spec Kit and must remain visible rather than silently replacing ordinary project rules.

✅ Deterministic Validation

Add temporary fixture repositories for nested scope, conflicts, absent sources, initialization, immutability, and plan-equivalent consumption. Extend the chezmoi nono profile with read access to the managed eza and Spec Kit paths required for source-to-target validation.

🔄 Before & After

Area Before After
Project governance Separate editable Spec Kit constitution Applicable AGENTS.md files remain canonical
Constitution command Rewrites project policy Initializes fixed artifact and manages local rules only
Spec Kit overrides Mixed into general governance Isolated in optional local constitution
Conflict handling Constitution-specific behavior Explicit duplicate and contradiction reporting
Validation No adapter fixtures Deterministic lifecycle and precedence coverage

We now manage eza config, as well as specify-cli.
Each must have read access for chezmoi verifications to pass.
Let Spec Kit consume project governance from applicable AGENTS.md files without duplicating those rules into its constitution. Keep the fixed constitution immutable while allowing explicit Spec Kit-local overrides.
@MrPointer
MrPointer merged commit 624163f into main Aug 4, 2026
5 checks passed
@MrPointer
MrPointer deleted the feature/speckit-preset-agnostic-constitution branch September 6, 2026 15:39
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