Agent-Skills.md

Agent Skills: Canon Governance Check Skill

Enforces changelog updates for significant changes to CANON/, TOOLS/, schemas, and ADRs

UncategorizedID: Reneromero08/agent-governance-system/canon-governance-check

Repository

Reneromero08/agent-governance-system
Reneromero08License: NOASSERTION

Install this agent skill to your local

pnpm dlx add-skill https://github.com/Reneromero08/agent-governance-system/tree/HEAD/CAPABILITY/SKILLS/governance/canon-governance-check

Skill Files

Browse the full folder contents for canon-governance-check.

Download Skill

Loading file tree…

CAPABILITY/SKILLS/governance/canon-governance-check/SKILL.md

Skill Metadata

Name
canon-governance-check
Description
Enforces changelog updates for significant changes to CANON/, TOOLS/, schemas, and ADRs
<!-- CONTENT_HASH: 6ccf92d5a58730e071eab8db36222e2c03e3779f43e2056dcceac11528ab4ba1 -->

required_canon_version: >=3.0.0

Canon Governance Check Skill

Version: 0.1.0

Status: Active

Required Canon Version: >=2.6.0 <3.0.0

Purpose

Enforces documentation hygiene by requiring changelog updates when significant system changes are made.

What it checks

Behavior Changes (requires CANON/CHANGELOG.md)

  • TOOLS/ - Runtime behavior
  • CATALYTIC-DPT/PRIMITIVES/ and CATALYTIC-DPT/PIPELINES/ - Core runtime
  • SKILLS/ - Agent capabilities
  • .github/workflows/ - CI enforcement

Rule Changes (requires CANON/CHANGELOG.md)

  • CANON/*.md - Canon specifications
  • CATALYTIC-DPT/SPECTRUM/*.md - Frozen law
  • SCHEMAS/*.json - Contract definitions

Decision Changes (requires CANON/CHANGELOG.md)

  • CONTEXT/decisions/*.md - Architecture Decision Records

Warnings (not errors)

  • CAT-DPT changes without CATALYTIC-DPT/CHANGELOG.md update
  • Canon changes without AGENTS.md sync

Usage

CLI

# Normal check
node TOOLS/check-canon-governance.js

# Verbose mode (show all changed files)
node TOOLS/check-canon-governance.js --verbose

As a Skill

python SKILLS/canon-governance-check/run.py

In CI

Automatically runs in .github/workflows/contracts.yml on every push/PR.

Pre-commit Hook

# Install pre-commit hook
cp SKILLS/canon-governance-check/scripts/pre-commit .git/hooks/pre-commit
chmod +x .git/hooks/pre-commit

Exit Codes

  • 0 - Pass (no significant changes or changelog updated)
  • 1 - Fail (significant changes without changelog)

Cortex Integration

When run with CORTEX_RUN_ID set, logs governance check events to the Cortex provenance ledger.

Implementation

  • Core script: TOOLS/check-canon-governance.js (Node.js)
  • Skill wrapper: SKILLS/canon-governance-check/run.py
  • Pre-commit hook: SKILLS/canon-governance-check/scripts/pre-commit

required_canon_version: >=3.0.0

Canon Governance Check Skill Skill | Agent Skills