`governance-extras` — guides
Choose the governed workflow for proposing a cross-cutting change, recording a decision, or updating repository conventions.
A written trail for the decisions a long-lived repo accumulates. Three skills, three artifacts: new-rfc proposes a change whose direction is still open, new-adr records a decision once it’s made, and rfc-status surveys what is open, accepted, or rejected. The pack also ships the docs/rfc/ and docs/adr/ shapes those skills write into.
Propose a change to the release approval policy.New here? Propose a change with an RFC when something is still open; record it with an ADR once it’s settled.
Tutorials
Section titled “Tutorials”- Your first governance session — install the pack, record one ADR with the preview-confirm gate, and commit it in about fifteen minutes.
How-to
Section titled “How-to”- Propose a cross-cutting change (RFC) — open a proposal for input before a decision is locked in.
- Record a decision (ADR) — capture what was decided, the context, and the alternatives weighed.
- Set up a governance index — build a domain → ADR manifest so an agent loads 2–3 files instead of the whole ADR tree.
- Define an extension contract — document a plugin or customisation hook so adopters know what is stable.
Installing and upgrading live in ../_shared/.