constitution
/constitution
Use when a project needs rules every feature must obey, or those rules change: \"set up our principles\", \"write a constitution\", \"these are our non-negotiables\", \"from now on every feature must...\", \"we never allow X in this codebase\", \"amend the rules\", starting spec-first work on a project with no specs/constitution.md. Not for MasterMind's own engineering defaults, and not for one feature's requirements (that's `specify`).
- Author
- mehrad-dm ↗
- Repository
- mastermind ↗
- Licence
- MIT
- Last repository change
- 08.10.2026
Assessment and security
- Files in this package
- 3
- Scripts
- 0
- HTML comments
- 0
- URLs in SKILL.md
- 0
No signals detected. Repository changed on 08.10.2026, without references to retired models or APIs.
MIT, open: use and modify while retaining author attribution.
What it does and when to use it
Use when a project needs rules every feature must obey, or those rules change: \"set up our principles\", \"write a constitution\", \"these are our non-negotiables\", \"from now on every feature must...\", \"we never allow X in this codebase\", \"amend the rules\", starting spec-first work on a project with no specs/constitution.md. Not for MasterMind's own engineering defaults, and not for one feature's requirements (that's `specify`).
Triggers from the description
Original author description
Use when a project needs rules every feature must obey, or those rules change: \"set up our principles\", \"write a constitution\", \"these are our non-negotiables\", \"from now on every feature must...\", \"we never allow X in this codebase\", \"amend the rules\", starting spec-first work on a project with no specs/constitution.md. Not for MasterMind's own engineering defaults, and not for one feature's requirements (that's `specify`).
How it works
- Write it
- Amend it
- Write rules a reviewer can check
- Gotchas
- Report
SKILL.md preview
---
name: constitution
description: "Use when a project needs rules every feature must obey, or those rules change: \"set up our principles\", \"write a constitution\", \"these are our non-negotiables\", \"from now on every feature must...\", \"we never allow X in this codebase\", \"amend the rules\", starting spec-first work on a project with no specs/constitution.md. Not for MasterMind's own engineering defaults, and not for one feature's requirements (that's `specify`)."
---
# MasterMind: Constitution
A constitution is the short list of rules this project refuses to break, written so a reviewer can
check a change against each one. It outranks every spec, plan and task (`~/.mastermind/engineering/core/spec-driven.md`).
Request: **$ARGUMENTS**.
## Write it
1. **Read what the project already says.** README, CI config, lint and type settings, `.mastermind/brief.md`,
existing `specs/`. Rules the repo already enforces are facts to record, not questions to ask.
2. **Start from the template.** Use `specs/.templates/constitution.md` if it exists, else
[`template.md`](template.md) beside this file. Write to `specs/constitution.md`.
3. **Draft at most seven principles.** One is enough when the project has one rule. Each is a name, a few
`MUST` or `MUST NOT` statements, and one line of rationale. More than seven means some are preferences.
4. **Ask only for what the repo cannot tell you.** One question at a time, each with your recommended
answer (`interview`). Privacy stance, compliance, and what the product will never do are the usual ones.
5. **Leave no placeholder behind.** A value nobody knows yet stays as `TODO(<what>): <why it is unknown>`
and is listed in your report.
## Amend it
- **Version every change** in the footer line, semver:
- MAJOR: a principle is removed or redefined so that old work may now violate it.
- MINOR: a principle or section is added, or its guidance materially changes without making old
work non-compliant, which includes narrowing an obligation.
- PATCH: wording, typos, clarifications that change no obligation.
- **Record the amendment** as a comment block at the top of the file: the version change, what changed
and why, the date, and who decided it.
- **Ripple the change.** List every living doc, open spec, plan and template that now conflicts with the
new rule. Update each one, or name it in the comment block as pending, with the reason.
## Write rules a reviewer can check
```text
Weak: Code should be well tested.
Strong: Money arithmetic MUST have a failing test written before the code that makes it pass.
Rationale: rounding bugs in payouts are invisible until a customer finds them.
Ratchet: Test coverage of src/billing MUST NOT fall below 81.4% (measured 2026-10-07 by `npm run cov`).
Rationale: we cannot reach 100% today, and we refuse to get worse.
```
A number you cannot measure today is invented. Record where the project is now, with the command that
measured it, and forbid going backwards. Raise the recorded value when the project improves. For a
product built on a model, one rule is usually worth writing down: a guardrail in a prompt is not a
security boundary, so what the model's output may trigger is limited in code.
A rule nobody can check produces an argument in every review. `SHOULD` is allowed only with the
condition under which it may be skipped, stated in the same line.
## Gotchas
- **Do not copy MasterMind's defaults in.** "Verify before done" and "no lazy placeholders" already hold
everywhere. The constitution carries what is true of *this* project only.
- **Do not let a feature request sneak in.** "We need dark mode" is a spec. "Our surfaces are dark only"
is a rule. Requests that arrive here go to `specify`, named in your report as deferred.
- **Existing code that already breaks a new rule is known debt, not a crisis.** List it in the amendment
block with its location (`~/.mastermind/engineering/core/spec-driven.md`, Code that predates the rules).
- **The constitution never edits code.** Amending a rule that existing code now breaks produces findings
for `converge`, not a silent refactor.
- **A team's rules are the team's decision.** An unconfirmed draft is version 0.1.0. It becomes 1.0.0 on
one real confirmation. A rule the user dictated in their own words is already confirmed; only what you
inferred or proposed needs it. A rule the user never agreed to is a rule they will route around.
- **Record who proposed each rule.** A `MUST` you added beyond what the user said is marked as your
proposal in the amendment block until they confirm it. Never credit the user with your extension.
- **A gate that passes with nothing to check is hollow.** "The test suite MUST be green" holds with zero
tests. Name the behavior that must be proven, or require the suite to cover it.
## Report
The version (old → new), the principles added, changed or removed, the documents rippled or still
pending, and any `TODO` left open.
Files in this package (3)
- ABOUT.md 3 KB
- SKILL.md 5 KB
- template.md 1 KB
Versions
| Repository | Score | Licence |
|---|---|---|
| This page · mehrad-dm/mastermind | 100 | MIT |
| ericrisco/rsc-harness | 100 | MIT |
| tansuasici/claude-code-kit | 100 | MIT |
| cailmdaley/skills | 100 | Apache-2.0 |
Database snapshot: 13.11.2026 · package version afce8edb1f24 (SHA-256 digest of the entire package)
Downloads in the last 30 days: 0 · ranking
Report a problem with this skill: harmful content, incorrect descriptions or an author’s removal request.
Similar skills
- 90constitution:amend
Amend project constitution with semantic versioning and changelog management. Use when user asks to "amend constitution", "update constitution version", "add principle", or "modify governance rules". Automatically regenerates checklist. - 95project-principles
Create or amend the project's principles document (its constitution): the non-negotiable rules, quality gates, and governance that design, planning, and verification check against. Fills the template's placeholder tokens, bumps the semantic version by the MAJOR/MINOR/PATCH… - 90kickstart-constitution
Creates and amends the project constitution, .kickstart/constitution.md, a short versioned set of MUST/SHOULD principles that every spec, plan, task list and change in the project is checked against. Seeds it from the kickstart decisions (stack, scale, enforcement, compliance… - 85sage-constitution
The project's engineering principles and non-negotiable process rules. Use when asking whether something is allowed, what the project's principles or conventions are, why a rule exists, or when a decision seems to conflict with the constitution. - 90constitution:writer
Add a tailored constitution to your project. Use when starting a new project, bootstrapping governance, or when user asks to "create a constitution", "set up project principles", or "define coding standards". Conducts structured discovery through clarifying questions about… - 100s08-01-spec-constitution
建立项目治理章程(constitution),把代码质量、测试、UX 一致性、性能与「单一 UI 组件库 + 全局 tailwind 变量」「开发质量守则(删繁就简 + 改动守恒)」原则固化为强制约束。在 STAGE_3 设计确签后、编码前运行。产出 constitution.md。当用户要求'定章程/立开发规范/写constitution'时使用。