Przejdź do treści
Biblioteka skilli
Zarządzanie i produkt · Pisanie

constitution

/constitution

Zapisuje reguły, których musi przestrzegać każda funkcja projektu, lub je zmienia: zasady, konstytucję, rzeczy niedozwolone w kodzie, przy starcie pracy od specyfikacji w projekcie bez specs/constitution.md.

Repozytorium
mastermind ↗
Licencja
MIT
Ostatnia zmiana repozytorium
08.10.2026

Ocena i bezpieczeństwo

100/ 100Klasa: dobry
Format25 / 25
Frontmatter z nazwą i opisem, poprawna nazwa, opis do 1024 znaków, nazwa zgodna z folderem.
Odkrywalność25 / 25
Opis mówi, kiedy użyć skilla, ma sensowną długość i jest w 3. osobie.
Treść35 / 35
Co najmniej 150 słów i do 500 linii, nagłówki, listy kroków, przykłady albo kod.
Higiena15 / 15
Bez zaślepek typu TODO, bez ścieżek Windows, z licencją.
Ryzykobrak sygnałów w skanie
Pliki w paczce
3
Skrypty
0
Komentarze HTML
0
Adresy URL w SKILL.md
0
Przestarzałość

Brak sygnałów. Repozytorium zmienione 08.10.2026, bez odwołań do wycofanych modeli i API.

Licencja

MIT, otwarta: można używać i zmieniać, z zachowaniem informacji o autorze.

Co robi i kiedy

Zapisuje reguły, których musi przestrzegać każda funkcja projektu, lub je zmienia: zasady, konstytucję, rzeczy niedozwolone w kodzie, przy starcie pracy od specyfikacji w projekcie bez specs/constitution.md.

Wyzwalacze z opisu

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
Oryginalny opis (EN)

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

Jak działa

  1. Write it
  2. Amend it
  3. Write rules a reviewer can check
  4. Gotchas
  5. Report
Sekcje z nagłówków SKILL.md, w oryginale · 74 linii, 740 słów
Podgląd SKILL.md
---
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.
Pliki w paczce (3)
  • ABOUT.md 3 KB
  • SKILL.md 5 KB
  • template.md 1 KB

Wersje

RepozytoriumWynikLicencja
Ta strona · mehrad-dm/mastermind100MIT
ericrisco/rsc-harness100MIT
tansuasici/claude-code-kit100MIT
cailmdaley/skills100Apache-2.0

Migawka bazy z 13.11.2026 · wersja paczki afce8edb1f24 (skrót SHA-256 całej paczki)

Pobrania w ostatnich 30 dniach: 0 · ranking

Zgłoś problem z tym skillem: szkodliwa treść, błędny opis albo prośba autora o usunięcie.

Podobne skille

  • 90constitution:amend
    Zmienia konstytucję projektu z wersjonowaniem semantycznym i dziennikiem zmian, a potem odświeża listę kontrolną.
  • 95project-principles
    Tworzy lub zmienia dokument zasad projektu, czyli niepodważalne reguły, bramki jakości i zarządzanie zmianami z numerem wersji.
  • 90kickstart-constitution
    Tworzy i zmienia konstytucję projektu, czyli krótki zbiór zasad MUST i SHOULD sprawdzany przy każdej specyfikacji i zmianie.
  • 85sage-constitution
    Przypomina zasady inżynierskie projektu i obowiązkowe reguły procesu, gdy trzeba sprawdzić, co jest dozwolone.
  • 90constitution:writer
    Pisze konstytucję projektu dopasowaną do skali, ryzyka i zespołu, po pytaniach o architekturę i standardy kodowania.
  • 100s08-01-spec-constitution
    Ustala zasady projektu: jakość kodu, testy, spójność UX, wydajność i jedną bibliotekę UI, a następnie zapisuje je jako wiążący plik constitution.md.

Uwagi i zgłoszenia

Wiadomość trafi do Bartosza Sokolińskiego. Adres e-mail jest potrzebny tylko do odpowiedzi. Szczegóły w polityce prywatności.