gov-review

Audits ADRs, RFDs, and design docs against a six-axis quality rubric and writes a ranked review report.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Governance artifacts like ADRs, RFDs, and design docs decay silently — missing alternatives, unstated assumptions, pending sign-offs — and nobody notices until a bad decision resurfaces. This Skill audits existing decision records in bulk and reports exactly where each one falls short. ## Core Features & Use Cases - Six-axis quality rubric: Scores each artifact on alternatives, assumptions, reversibility, blast radius, options depth, and status/provenance hygiene. - Parallel fan-out review: Dispatches one read-only reviewer agent per artifact in waves of up to six, collecting PASS/FAIL verdicts into a single aggregate report. - Ranked report output: Writes a per-artifact verdict table plus detailed Critical findings to .mz/reviews/, without ever editing the artifacts themselves. - Use Case: Run it over docs/decisions/ before a quarterly architecture review to find which ADRs lack human sign-off or never recorded rejected alternatives. ## Quick Start Ask the AI to review the ADRs in docs/decisions and report which ones fail the governance quality audit.

Frequently Asked Questions about gov-review

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

FAQPage Schema
How do I audit ADRs for quality issues?

Point the skill at a directory or glob of ADR files and it dispatches one reviewer agent per artifact, scoring each against six axes including alternatives, assumptions, and sign-off provenance. Results are collected into a single report with per-artifact PASS/FAIL verdicts.

What makes an architecture decision record fail a quality review?

An artifact fails when it has any Critical finding, such as zero alternatives on an ambiguous decision, an unstated load-bearing assumption, an unclassified irreversible choice, a missing blast radius, or a pending human sign-off on a decided record.

Does the governance review modify my ADR files?

No, the review is strictly read-only. It scores artifacts and writes a separate report under .mz/reviews/, never editing the source ADRs, RFDs, or design docs.

When should I use govern instead of gov-review?

Use govern when making or recording a new decision, and gov-review only when auditing artifacts that already exist. For fixing a failing record, re-decide it with govern or edit the artifact by hand.

What happens if a reviewer agent fails on one artifact?

The failed dispatch is retried once, and if it still returns no verdict the artifact is marked unscored with the reason in the report. An unscored artifact is never counted as a pass, and the rest of the wave continues normally.