ub-governance

Automate deterministic repository governance with unified gates, tests, evidence, and ADR workflows.

6|2|Updated Mar 12, 2026
One-click install
npx skills add https://github.com/robert-hoffmann/uncle-bob --skill ub-governance
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: ub-governance
Source: https://github.com/robert-hoffmann/uncle-bob/tree/main/.agents/skills/ub-governance
Command: npx skills add https://github.com/robert-hoffmann/uncle-bob --skill ub-governance

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

Unified governance of repository gates, testing policies, evidence lifecycles, and ADR workflows to ensure deterministic decisions and traceability.

Core Features & Use Cases

  • Modes cover repository hygiene, testing governance, evidence lifecycle, core-contract governance, and full governance audits for end-to-end coverage.
  • Load and reference canonical contracts, vocabulary, and playbooks from the included references directory to guide gate outcomes and ADR alignment.
  • Self-contained workflow with scripts, references, and tests to validate integrity, traceability, and reproducibility of governance decisions.

Quick Start

Start by selecting lean or advanced mode and load the references to enable deterministic gate decisions.

Frequently Asked Questions about ub-governance

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

FAQPage Schema
How do I automate repository governance and ADR tracking for release readiness?

This skill automates repository governance and ADR tracking by unifying gates, tests, and evidence workflows to ensure deterministic release readiness. It applies risk-aware gating and traceable decision memory across multiple operational modes.

What is ADR governance and how does it integrate with testing policies?

ADR governance is the enforcement of traceable decision memory alongside testing policies and evidence lifecycles. It integrates by loading canonical contracts to guide gate outcomes and align architectural decisions with release readiness.

How do I enforce deterministic governance gates across my codebase?

You enforce deterministic governance gates by loading canonical contracts and vocabulary references to guide decisions. This workflow uses scripts and test assets to validate the integrity, traceability, and reproducibility of codebase governance outcomes.

Can I use lean mode for codebase governance or do I need the advanced mode?

You can select either lean or advanced mode for codebase governance depending on required coverage. Lean handles basic repository hygiene, while advanced covers end-to-end core-contract governance, evidence lifecycle, and full governance audits.

What's the best way to maintain traceable decision memory for risk-aware gating?

The best way to maintain traceable decision memory for risk-aware gating is to automate ADR workflows alongside evidence lifecycles and testing policies. This ensures decisions remain reproducible and aligned with canonical contracts throughout the release process.