gov-init

Installs or removes a governance policy block in CLAUDE.md using sentinel markers.

2|Updated Apr 4, 2026
One-click install
npx skills add https://github.com/DoctorMozg/claude-pipelines --skill gov-init-doctormozg
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: gov-init
Source: https://github.com/DoctorMozg/claude-pipelines/tree/main/plugins/mz-gov/skills/gov-init
Command: npx skills add https://github.com/DoctorMozg/claude-pipelines --skill gov-init-doctormozg

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Teams need AI assistants to consistently route substantial, ambiguous design decisions through a governance pipeline, but manually editing CLAUDE.md is error-prone and hard to keep in sync. This Skill injects the governance policy as a single sentinel-wrapped block that is idempotent on re-run and cleanly removable. ## Core Features & Use Cases - Idempotent install and update: Appends the policy block to project or global CLAUDE.md, skips if already present, and replaces in place with --force. - Clean uninstall: Removes exactly the sentinel-wrapped block plus one adjacent blank line without deleting CLAUDE.md itself. - Approval gate with verification: Shows the exact bytes to be written, requires explicit user approval, then greps for exactly one sentinel to confirm the result. - Use Case: A team lead wants every Claude session in a repo to proactively run the govern pipeline on one-way-door decisions, so they run gov init to embed the policy once and re-run with --force after each plugin upgrade. ## Quick Start Ask the assistant to run gov init to install the governance policy into this project's CLAUDE.md.

Frequently Asked Questions about gov-init

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I install a governance policy into CLAUDE.md?

Run gov init with the project scope to append the sentinel-wrapped governance policy block to ./CLAUDE.md, or use the global scope for ~/.claude/CLAUDE.md. The skill shows the exact block and asks for approval before writing.

How do I update or remove the governance policy from CLAUDE.md?

Re-run gov init with --force to replace the existing block in place between its sentinels, or pass --uninstall to remove the block entirely. Uninstall never deletes CLAUDE.md itself, even if only managed content remains.

Does gov init overwrite my existing CLAUDE.md content?

No. The policy lives inside its own mz-gov:governance-policy sentinel pair, and a --force replace touches only the span between those sentinels. Existing headers, user content, and init-rules mz-rule blocks are preserved byte-for-byte.

What happens if I run gov init twice?

The second run detects the existing start sentinel and skips, recording the action as skipped. The install is idempotent, so re-running without --force changes nothing and still verifies exactly one sentinel exists.

Why does gov init stop with a duplicate sentinel error?

Finding two or more mz-gov:governance-policy start sentinels means the file was manually edited or a prior run malfunctioned. The skill reports the conflicting line numbers and asks you to resolve them before re-running rather than guessing which block to keep.