speckit-analyze

Analyze spec.md, plan.md, and tasks.md for consistency and quality.

60|12|Updated Aug 1, 2013
One-click install
npx skills add https://github.com/vtex/front.phone --skill speckit-analyze-vtex
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: speckit-analyze
Source: https://github.com/vtex/front.phone/tree/main/.agents/skills/speckit-analyze
Command: npx skills add https://github.com/vtex/front.phone --skill speckit-analyze-vtex

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill detects inconsistencies, duplications, ambiguities, and underspecified items across your generated artifacts so you can fix issues before implementation starts.

Core Features & Use Cases

  • Cross-artifact consistency checks: Compares spec.md, plan.md, and tasks.md after task generation to find mismatches and coverage gaps.
  • Read-only structured reporting: Produces a compact Markdown report without modifying any project files.
  • Constitution alignment enforcement: Validates findings against non-negotiable principles in .specify/memory/constitution.md and escalates critical conflicts.

Quick Start

Run speckit-analyze with no arguments to generate a read-only consistency report after tasks.md has been produced.

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, plan, and tasks for consistency after generation?

Cross-artifact consistency analysis compares spec.md, plan.md, and tasks.md to detect mismatches, coverage gaps, and ambiguities. It produces a structured read-only Markdown report with severity ratings and next-action guidance without modifying any project files.

What is cross-artifact consistency analysis for specification documents?

Cross-artifact consistency analysis validates requirement and task coverage across spec.md, plan.md, and tasks.md. It identifies duplications, ambiguities, and underspecified items, enforcing alignment with project constitution principles before implementation begins.

Does spec consistency analysis modify my project files?

Spec consistency analysis enforces read-only execution and does not modify project files. It loads minimal context from the three artifacts plus the constitution file, runs prerequisite checks, and outputs a compact report capped at a maximum finding count.

How do I validate task coverage against requirements in a spec-kit project?

Task coverage validation loads spec.md, plan.md, and tasks.md from the spec-kit directory structure and checks requirement coverage. It reports structured findings with severity levels and actionable guidance for any underspecified or missing items.

Can I enforce constitution alignment checks across my spec artifacts?

Constitution alignment enforcement validates findings against non-negotiable principles defined in .specify/memory/constitution.md. It escalates critical conflicts where generated artifacts diverge from established project rules, reporting them with severity and next-action guidance.

What are the limitations of read-only artifact consistency checks?

Read-only artifact consistency checks are limited to projects following the spec-kit directory structure and require spec.md, plan.md, and tasks.md to already exist. Output is capped at a maximum finding count and no files are modified during execution.