spec-alignment-audit

Audit design bundles against canonical project specs for contract compliance.

Updated Aug 27, 2026
One-click install
npx skills add https://github.com/blucsigma05/tbm-apps-script --skill spec-alignment-audit
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: spec-alignment-audit
Source: https://github.com/blucsigma05/tbm-apps-script/tree/main/.claude/skills/spec-alignment-audit
Command: npx skills add https://github.com/blucsigma05/tbm-apps-script --skill spec-alignment-audit

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Prevents design bundles from shipping the wrong decisions by auditing bundle-vs-canonical-spec compliance, catching silent contract drift that internal consistency checks can miss.

Core Features & Use Cases

  • Token contract alignment: Verifies every bundle token matches the spec’s allowed meanings and ranges.
  • Surface coverage via inheritance matrix: Confirms every binding surface is referenced and assigned the correct family/root/markers as required by the spec.
  • Primitive coverage using the verification manifest: Ensures each binding contract has a measurable hook (covered, deferred with rationale, or blocked).
  • Out-of-scope leakage detection: Flags contradictions where the bundle redesigns or removes spec-mandated fixed items.
  • Use cases: Before opening a transcription PR, when a spec changes, or when saving bundle direction as durable evidence alongside a compliance verdict.

Quick Start

Run the spec-alignment-audit on your design bundle after it passes design-bundle-audit by providing the bundle root path and the canonical spec file path, then review the GREEN/YELLOW/RED verdict and its evidence-backed findings.

Frequently Asked Questions about spec-alignment-audit

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

FAQPage Schema
How do I audit a design bundle against a canonical project spec?

You can verify design bundle compliance by running four automated checks for token contract alignment, surface inheritance coverage, primitive/verification-manifest coverage, and out-of-scope contradiction detection against your canonical spec file.

What is design bundle spec alignment used for?

Spec alignment auditing prevents design bundles from shipping the wrong decisions by catching silent contract drift that internal consistency checks miss, verifying that chosen directions honor binding contracts before opening transcription PRs.

When should I run a spec alignment audit in my workflow?

Run a spec alignment audit after your design bundle passes design-bundle-audit and before opening a transcription PR, or whenever a spec changes and you need to save the bundle direction as durable evidence alongside a compliance verdict.

How does out-of-scope leakage detection work for design bundles?

Out-of-scope leakage detection flags contradictions where the bundle redesigns or removes spec-mandated fixed items, citing evidence from specific spec sections and bundle file:line references to prove the violation.

Do I need a verification manifest to check primitive coverage?

Yes, you need a verification manifest to check primitive coverage because the audit ensures each binding contract has a measurable hook that is covered, deferred with rationale, or blocked according to the manifest.

What does a GREEN/YELLOW/RED compliance verdict mean in spec alignment?

A GREEN/YELLOW/RED compliance verdict indicates your design bundle's level of spec alignment, accompanied by evidence-backed findings citing spec sections and bundle file:line references to justify the final compliance status.