spec-first:analyze

Analyzes specification documents for consistency issues and generates a severity-graded report.

72|9|Updated Mar 1, 2026
One-click install
npx skills add https://github.com/sunrain520/spec-first --skill spec-first-analyze
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: spec-first:analyze
Source: https://github.com/sunrain520/spec-first/tree/main/skills/spec-first/21-analyze
Command: npx skills add https://github.com/sunrain520/spec-first --skill spec-first-analyze

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill automates the analysis of consistency across various specification documents (spec.md, design.md, task_plan.md, traceability-matrix.md) and background quality, providing a structured report with severity-graded findings.

Core Features & Use Cases

  • Cross-Product Consistency Analysis: Detects issues like missing artifacts, traceability gaps, content inconsistencies, and coverage shortfalls between different stages of a feature's lifecycle.
  • Background Quality Assessment: Evaluates the quality and synchronization of background information (background_input_status, runtime source, docs projection view).
  • Severity-Graded Reporting: Classifies issues into CRITICAL, HIGH, MEDIUM, and LOW severity levels, with actionable recommendations.
  • Use Case: Before proceeding to the implementation phase (04_implement), run this Skill to ensure all design specifications are complete, traceable, and consistent with the initial requirements, preventing costly rework later.

Quick Start

Run the analyze skill to perform a consistency check on the current feature.

Frequently Asked Questions about spec-first:analyze

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

FAQPage Schema
How do I check specification consistency across design documents before implementation?

To check specification consistency, analyze cross-document artifacts like spec.md, design.md, and task_plan.md to detect coverage gaps, missing artifacts, and content conflicts. This generates a severity-graded report with actionable recommendations.

What is traceability matrix analysis in software specification workflows?

Traceability matrix analysis verifies that requirements map correctly to design and task plans. It identifies traceability gaps and coverage shortfalls across specification documents, ensuring complete alignment throughout the feature lifecycle.

How do I generate a severity-graded report for specification quality issues?

Generate a severity-graded report by performing read-only consistency analysis on specification documents and background quality. It classifies identified ambiguities, conflicts, and drift into CRITICAL, HIGH, MEDIUM, and LOW severity levels with actionable recommendations.

When should I run a consistency analysis on my feature specifications?

Run consistency analysis before proceeding to the implementation phase. This ensures all design specifications are complete, traceable, and consistent with initial requirements, preventing costly rework later in development.

Does specification consistency analysis evaluate background quality synchronization?

Yes, specification consistency analysis evaluates background quality by assessing background_input_status, runtime sources, and docs projection views. It detects quality drift and synchronization issues across the specification artifacts.

Can I use this analysis tool to find missing artifacts in my task plan?

Yes, you can use cross-product consistency analysis to find missing artifacts in your task plan. It detects missing artifacts, traceability gaps, and coverage shortfalls between different stages of a feature's lifecycle.