constitution
Installation
SKILL.md
The constitution
📁 Source note:
[sage]= upstream Sage repo (github.com/xoai/sage, public) — optional deeper reading; this skill runs fully on the rules inlined here. A step marked MUST READ points at a file in your own project (e.g. an event registry) — if it is missing, stop and ask instead of improvising.
These are the kit's engineering defaults. Read the target project's applicable
AGENTS.md and .jimmy/constitution.md if present. The project controls its own
workflow and enforcement; a missing optional constitution is not a blocker.
Engineering principles
The base set to apply to relevant changes:
| # | Principle | Verification mechanism to use when available |
|---|---|---|
| 1 | Test changed behavior — prefer tests before code for new behavior and regression fixes | Relevant automated tests; editorial changes use inspection/lint |
| 2 | No silent failures — errors handled, logged, or propagated | Tests and review of failure paths |
| 3 | Secrets never in code — env vars or a secret manager | Secret scan and review |
| 4 | Dependencies explicit — declared, pinned by the project's policy | Package manifest/lockfile and dependency checks |
| 5 | Changes reversible — migrations and deployments have a recovery path appropriate to risk | Migration/deployment checks and rollback review |