governance-extras — guides¶

A written trail for the decisions a long-lived repo accumulates. Three skills, three artifacts: new-rfc proposes a cross-cutting change before it's decided, new-adr records a decision after it's made, and update-conventions changes the rules of the repo through review rather than a silent edit. The pack also ships the docs/rfc/ and docs/adr/ shapes those skills write into.

New here? Propose a change with an RFC when something is still open; record it with an ADR once it's settled.

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¶

• 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/.