CASE STUDY · PUBLIC
project-genome
Repository governance as a skill: owned document roles, mutability classes, and a stdlib CLI, self-checking with 35 of 35 cases.
Status ruling active development
Problem
Repository conventions live in prose that drifts: documents lose their owners, decisions lose their records, and agents editing a repo cannot tell governed from free space.
Build
- Document roles declared rather than remembered: every file class carries an owner, a mutability class and a status, so an editor (human or agent) reads the rule from the repository itself.
- A stdlib-only CLI (wake, ask, close, and the registers) so the governance layer has no dependencies to break.
Outcome
- 35 of 35 self-check cases pass at commit 3a2873a in the standalone public repository, up from 32 of 32 at the original measurement: the suite grew by three cases.
- The install surface is verifier-checked: install.sh and the curl one-liner, both live. The skill governs the repositories this portfolio is built from, which is the register's own discipline turned into a tool.
Provenance
| Self-check, executed | 35 / 35 cases ok | test_genome.py at 3a2873a, 2026-10-25 |
|---|
Reproduce
Clone the repository and run the self-check: the case list is the suite, and the runner output re-derives the figure. The README publishes the install one-liner.
https://github.com/ishan-parihar/project-genome
Published documents
From the documentation
Documentation fails in four predictable ways (two owners for one question, no declared mutability, no routing, silent staleness), and the skill is organised against exactly those four, which is why its contract reads as a diagnosis before it reads as a tool.
SKILL.md at 3a2873a (2026-10-25)
Roles carry mutability classes, so state, ledgers and frozen evidence cannot be edited casually, and the CLI checks the classes rather than the documentation hoping they hold.
SKILL.md at 3a2873a (2026-10-25)
The three commands that matter are wake, ask and close: orientation, retrieval, iteration close, which makes the token-efficient path the default rather than the optional one.
SKILL.md at 3a2873a (2026-10-25)
The self-check is a published gate (35 of 35) at its own commit, so the governance tool is held to the same evidence standard it imposes on other projects.
register row, 3a2873a