ai-ad-spec-governor

Orchestrates specification governance across documentation corpora to enforce SoT alignment and freeze compliance.

Updated Nov 8, 2025
One-click install
npx skills add https://github.com/wade56754/AI_ad_spend02 --skill ai-ad-spec-governor
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: ai-ad-spec-governor
Source: https://github.com/wade56754/AI_ad_spend02/tree/main/.claude/skills/ai-ad-spec-governor
Command: npx skills add https://github.com/wade56754/AI_ad_spend02 --skill ai-ad-spec-governor

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solves?

Maintaining consistency and compliance across a large documentation system, especially with evolving Sources of Truth (SoT), is a constant challenge. This Skill automates the entire governance lifecycle, from auditing to verification, ensuring all documents adhere to project specifications and freeze rules.

Core Features & Use Cases

  • Full Governance Lifecycle: Orchestrates auditing, fixing, verification, and deployment decisions for documents.
  • SoT Alignment Enforcement: Ensures all documentation strictly conforms to the defined Sources of Truth.
  • Freeze Compliance Checks: Verifies that document changes respect version freeze rules, preventing unauthorized modifications.
  • Use Case: After a critical SoT document like STATE_MACHINE.md is updated, use this Skill to automatically check all dependent documents for alignment and compliance before any code changes are merged, saving significant manual effort and preventing errors.

Quick Start

Use ai-ad-spec-governor in "single-doc" mode to check if 'docs/3.dev-guides/API_DEVELOPMENT_FLOW.md' is ready for production.

Frequently Asked Questions about ai-ad-spec-governor

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

FAQPage Schema
How do I enforce documentation compliance across multiple documents?

Documentation compliance is enforced by orchestrating audits, fixes, and verification cycles across your document corpus. This Skill automates the governance lifecycle to ensure all documents adhere to project specifications and freeze rules, checking alignment before deployment.

What is SoT alignment and why does it matter for documentation?

SoT alignment ensures documentation strictly conforms to defined Sources of Truth. When critical SoT documents update, dependent documents risk drift. This Skill automatically checks all dependent docs for alignment, preventing specification inconsistencies and errors in merged code.

How do I check if a document is ready for production?

Use single-doc mode to audit a document against specifications and freeze compliance rules. The Skill produces a clear publish decision after running the governance cycle, confirming whether the document meets production readiness standards.

Can I scan an entire documentation ecosystem for compliance issues?

Yes. Full-scan mode audits your entire doc ecosystem for SoT alignment and freeze compliance violations. The Skill reports governance gaps across all documents, enabling bulk remediation before changes propagate.

What happens when a freeze rule is violated in my documentation?

Freeze compliance checks detect unauthorized modifications blocked by version freeze rules. The Skill flags violations during the audit phase and can coordinate fixes to restore compliance before verification and deployment.

Do I need to manually fix every compliance issue the Skill finds?

No. The Skill orchestrates the full governance cycle including automated fixes through coordinated sub-skills, then verifies corrections. Manual intervention is only needed for issues requiring domain-specific decisions.