speckit-analyze

Analyze spec.md, plan.md, and tasks.md for inconsistencies, gaps, and constitution violations.

Updated Jul 13, 2026
One-click install
npx skills add https://github.com/torikhayes/aeai-dotnet-brownfield --skill speckit-analyze-torikhayes
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: speckit-analyze
Source: https://github.com/torikhayes/aeai-dotnet-brownfield/tree/main/.claude/skills/speckit-analyze
Command: npx skills add https://github.com/torikhayes/aeai-dotnet-brownfield --skill speckit-analyze-torikhayes

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Before implementation begins, specification artifacts often contain duplications, ambiguities, coverage gaps, and contradictions that cause costly rework. This Skill performs a read-only cross-artifact consistency analysis so teams catch specification defects early. ## Core Features & Use Cases - Cross-Artifact Analysis: Detects duplications, ambiguities, underspecification, inconsistencies, and coverage gaps across spec.md, plan.md, and tasks.md. - Constitution Enforcement: Validates artifacts against the project constitution (.specify/memory/constitution.md), flagging MUST-principle violations as CRITICAL. - Structured Report: Produces a severity-ranked findings table, requirement-to-task coverage summary, and metrics (coverage %, ambiguity count, critical issues). - Use Case: After running /speckit-tasks on a new feature, run this analysis to confirm every functional requirement has at least one task and no conflicting technology choices exist before invoking /speckit-implement. ## Quick Start Run the speckit-analyze command to check my current feature's spec, plan, and tasks for inconsistencies and coverage gaps.

Frequently Asked Questions about speckit-analyze

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

FAQPage Schema
How do I check spec.md and tasks.md for inconsistencies?▼

Run the speckit-analyze command after task generation. It loads spec.md, plan.md, and tasks.md, then reports duplications, ambiguities, coverage gaps, and inconsistencies in a severity-ranked Markdown table.

What is spec-kit analyze used for?▼

It performs a non-destructive cross-artifact quality analysis across the three core spec-kit artifacts before implementation. It maps requirements to tasks, validates constitution alignment, and outputs coverage metrics and remediation suggestions.

Does speckit-analyze modify my specification files?▼

No, the analysis is strictly read-only. It outputs a structured report and offers an optional remediation plan, but edits are only applied after explicit user approval through separate commands.

When should I run the analyze command in a spec-kit workflow?▼

Run it after /speckit-tasks has produced a complete tasks.md and before /speckit-implement. It aborts with an error if any required artifact is missing, directing you to the prerequisite command.

What counts as a critical issue in specification analysis?▼

Critical issues include violations of constitution MUST principles, missing core spec artifacts, and requirements with zero task coverage that block baseline functionality. These should be resolved before implementation begins.