mad-analyze

What problem does it solve?

Implementing features based on misaligned spec, plan, and task artifacts leads to rework, scope creep, and wasted engineering effort. This Skill eliminates that risk by validating cross-artifact consistency before any code is written.

Core Features & Use Cases

• 6 Cross-Artifact Consistency Checks: Validates requirement coverage, scope drift, terminology alignment, assumption consistency, dependency ordering, and integration surface alignment between spec.md, plan.md, and tasks.md.
• Strict Mode & Severity Tiers: Blocks implementation on high-severity gaps, flags medium/low issues for review, and generates a detailed analysis report with actionable fix suggestions.
• Parallel Execution Optimization: Stages a context bundle to enable fast parallel subagent fan-out for large artifact sets, reducing analysis time from ~40 minutes to under 7 minutes for complex features.
• Use Case: Engineering and product teams using MAD (Model-Agile-Development) workflows can run this Skill between task breakdown and implementation to catch planning gaps early, ensuring all requirements are accounted for before development begins.

Quick Start

Use the mad-analyze skill to validate alignment between your current feature's spec.md, plan.md, and tasks.md files before starting implementation work.