speckit-analyze

Detect inconsistencies across spec.md, plan.md, and tasks.md files.

Updated Nov 23, 2023
One-click install
npx skills add https://github.com/auleewilliams/Skillscape --skill speckit-analyze-auleewilliams
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: speckit-analyze
Source: https://github.com/auleewilliams/Skillscape/tree/main/.claude/skills/speckit-analyze
Command: npx skills add https://github.com/auleewilliams/Skillscape --skill speckit-analyze-auleewilliams

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps teams ensure alignment across specification artifacts by identifying inconsistencies, duplications, ambiguities, and underspecified items across spec.md, plan.md, and tasks.md.

Core Features & Use Cases

  • Cross-artifact inconsistency detection across spec.md, plan.md, and tasks.md
  • Duplication and ambiguity identification with clear remediation suggestions
  • Constitution alignment checks against MUST principles

Quick Start

Review the three artifacts and generate a findings report.

Frequently Asked Questions about speckit-analyze

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

FAQPage Schema
How do I find inconsistencies across spec, plan, and tasks files?

Cross-artifact inconsistency detection compares spec.md, plan.md, and tasks.md to identify duplications, ambiguities, and underspecified items. It checks constitution alignment against MUST principles and outputs a structured analysis report for remediation planning.

What are common cross-artifact inconsistencies in spec-kit project structures?

Common inconsistencies include duplications across spec.md, plan.md, and tasks.md, ambiguities in requirements, underspecified items, and misalignment with MUST constitution principles. The analysis generates a structured findings report for remediation.

How do I check if my plan and tasks align with my spec.md?

To check alignment, analyze spec.md, plan.md, and tasks.md together to detect ambiguities, duplications, and underspecified items. The process verifies constitution alignment against MUST principles and outputs a structured findings report for remediation.

Does spec-kit inconsistency analysis require all three artifacts to run?

Yes, this analysis requires complete spec.md, plan.md, and tasks.md artifacts. The cross-artifact detection applies to projects following the spec-kit project structure with all three files present to identify duplications, ambiguities, and underspecified items.

What is the best way to detect underspecified items in project specifications?

The best way to detect underspecified items is to run a cross-artifact analysis across spec.md, plan.md, and tasks.md. This identifies underspecified requirements, detects duplications and ambiguities, and generates a structured report with clear remediation suggestions.

Why does my tasks.md contain duplications not present in spec.md?

Duplications occur due to cross-artifact inconsistencies between spec.md, plan.md, and tasks.md. Running an inconsistency analysis identifies these duplications alongside ambiguities and underspecified items, providing clear remediation suggestions in a structured findings report.