speckit-analyze

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

Updated Aug 23, 2025
One-click install
npx skills add https://github.com/engakhattab/DEPI_Angular_project --skill speckit-analyze-engakhattab
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: speckit-analyze
Source: https://github.com/engakhattab/DEPI_Angular_project/tree/main/Backend/HR/.agents/skills/speckit-analyze
Command: npx skills add https://github.com/engakhattab/DEPI_Angular_project --skill speckit-analyze-engakhattab

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

It prevents wasted engineering effort by detecting inconsistencies, ambiguities, duplications, and missing coverage across your spec, plan, and generated tasks before implementation starts.

Core Features & Use Cases

  • Cross-artifact consistency analysis: Compares requirements, success criteria, and task coverage across spec.md, plan.md, and tasks.md.
  • Quality and completeness checks: Flags unclear/vague items, placeholders, unresolved references, and underspecified work.
  • Constitution alignment validation: Ensures work does not violate non-negotiable constitution MUST principles.
  • Structured reporting for iteration: Produces a compact Markdown report with severities and next actions.

Quick Start

Run the Backend/HR/.agents/skills/speckit-analyze skill after speckit-tasks to generate a tasks.md, then review the resulting consistency report.

Frequently Asked Questions about speckit-analyze

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

FAQPage Schema
How do I check task coverage against spec and plan documents before coding?

To check task coverage, run a cross-artifact consistency analysis comparing spec.md, plan.md, and tasks.md to identify missing coverage, ambiguities, and duplications before implementation starts.

What is spec-plan-task consistency analysis and when do I need it?

Spec-plan-task consistency analysis detects mismatches across specification, plan, and task documents. You need it after generating tasks.md to prevent wasted engineering effort from underspecified requirements.

How do I validate constitution MUST principles against generated tasks?

Validating constitution MUST principles requires running a read-only structured analysis across your spec, plan, and tasks to ensure generated work does not violate non-negotiable principles.

Can I use this analysis if my tasks.md has not been generated yet?

No, this analysis requires tasks.md to already be produced by speckit-tasks, as it maps requirements and buildable success criteria to concrete tasks to evaluate coverage.

What is the best way to report ambiguities and underspecified items in project specs?

The best way to report ambiguities is generating a deterministic Markdown report with severity metrics and next actions, highlighting unclear items, placeholders, and unresolved references.

Does this consistency analysis modify my spec, plan, or tasks files?

No, this consistency analysis performs read-only structured analysis on your spec, plan, and tasks documents, outputting a report without modifying the original files.