speckit-analyze

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

9|4|Updated May 13, 2025
One-click install
npx skills add https://github.com/opsmill/infrahub-mcp --skill speckit-analyze-opsmill
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: speckit-analyze
Source: https://github.com/opsmill/infrahub-mcp/tree/main/.agents/skills/speckit-analyze
Command: npx skills add https://github.com/opsmill/infrahub-mcp --skill speckit-analyze-opsmill

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill helps teams ensure alignment across the three core artifacts—spec.md, plan.md, and tasks.md—by identifying inconsistencies, duplications, ambiguities, and under-specified items after task generation.

Core Features & Use Cases

  • Cross-artifact analysis: compare spec, plan, and tasks to surface conflicts and gaps
  • Constitution-aware validation: detects violations of MUST/SHOULD principles from the project constitution
  • Traceability mapping: relates each requirement and task to its originating narrative and checks coverage
  • Preflight checks: flags undefined references and missing sections before implementation

Quick Start

Run speckit-analyze from the repo root after tasks.md is generated to start the analysis.

Frequently Asked Questions about speckit-analyze

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

FAQPage Schema
How do I check consistency between spec, plan, and tasks files after generation?

To check spec-plan-task consistency, run an analysis from the repository root after generating tasks.md. This surfaces inconsistencies, duplications, ambiguities, and under-specified items across the three core artifacts.

What does traceability mapping do for requirements and tasks?

Traceability mapping relates each requirement and task to its originating narrative, checking coverage to ensure every item is tracked. It maintains links between spec.md, plan.md, and tasks.md artifacts.

How do I validate spec-kit constitution principles against my project artifacts?

To validate spec-kit constitution principles, run an analysis that detects violations of MUST and SHOULD principles. It ensures mandatory sections exist within spec.md, plan.md, and tasks.md artifacts.

When do I need to run a preflight check on spec, plan, and tasks files?

Run a preflight check on spec, plan, and tasks files before implementation to identify undefined references and missing sections. This prevents gaps and redundancies from carrying into development.

Why are vague requirements and duplications flagged across spec, plan, and tasks?

Vague requirements and duplications are flagged across spec, plan, and tasks to surface conflicts and gaps. Identifying under-specified items ensures alignment across the three core artifacts before implementation.