Skip to content
Skills Library
Management & product · Writing

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`).

Repository
mastermind ↗
Licence
MIT
Last repository change
08.10.2026

Assessment and security

100/ 100Class: good
Format25 / 25
Frontmatter with name and description, valid name, description up to 1,024 characters, name matching the folder.
Discoverability25 / 25
Description explains when to use the skill, has a reasonable length and uses third person.
Content35 / 35
At least 150 words and at most 500 lines, headings, step lists, examples or code.
Hygiene15 / 15
No placeholders such as TODO, no Windows paths, with a licence.
Riskno signals detected in the scan
Files in this package
3
Scripts
0
HTML comments
0
URLs in SKILL.md
0
Deprecation

No signals detected. Repository changed on 08.10.2026, without references to retired models or APIs.

Licence

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

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\s own engineering defaults, and not for one feature
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

  1. Write it
  2. Amend it
  3. Write rules a reviewer can check
  4. Gotchas
  5. Report
Original SKILL.md headings · 74 lines, 740 words
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

RepositoryScoreLicence
This page · mehrad-dm/mastermind100MIT
ericrisco/rsc-harness100MIT
tansuasici/claude-code-kit100MIT
cailmdaley/skills100Apache-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'时使用。

Feedback and reports

Your message goes to Bartosz Sokoliński. An email address is needed only for a reply. See the privacy policy.