blueprint-audit

What problem does it solve?

Ensures orchestration blueprints are internally consistent and well-documented by detecting cross-file contradictions, stale references, missing rationale, and documentation drift so teams can trust and maintain agent workflows.

Core Features & Use Cases

• Cross-file consistency checks: Compares lead instructions, agent files, workflows, templates, and README/CLAUDE docs for conflicting guidance or mismatched agent lists.
• Static test integration: Runs repository static tests (pytest -m static) to surface mechanical regressions like missing files or broken frontmatter.
• Rationale and gap audits: Identifies directives lacking rationale, ambiguous gating language, and exception clauses that enable undesirable agent choices.
• Use Case: Run against a blueprint_v2 before release to produce a prioritized remediation plan that lists stale paths, role mismatches, and exact file edits to fix.

Quick Start

Ask the skill to audit blueprint_v2 and produce a full structured report with contradictions, stale references, rationale gaps, and suggested fixes.