speckit-critique-run

Analyze spec.md and plan.md to produce a structured critique report.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Helps product and engineering teams quickly surface risks, gaps, and improvement opportunities in specs and implementation plans by applying dual lenses early in the lifecycle.

Core Features & Use Cases

  • Dual-lens critique: Product and Engineering perspectives to identify risks, gaps, and actionable improvements.
  • Structured critique reports: Outputs saved under FEATURE_DIR/critiques with clear findings, severities, and recommendations.
  • Context-aware execution: Reads spec.md, plan.md, and constitution guidelines when available to ensure alignment.

Quick Start

Run speckit-critique-run to generate a structured critique report for the current spec and plan.

Frequently Asked Questions about speckit-critique-run

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

FAQPage Schema
How do I run a risk analysis on a product specification and implementation plan?

To run a specification risk analysis, you can generate a structured critique report by analyzing spec.md and plan.md through both product and engineering lenses to surface risks, gaps, and improvement opportunities.

What is dual-lens critique for engineering reviews?

Dual-lens critique evaluates specifications and plans using both product and engineering perspectives to identify risks, gaps, and actionable improvements, outputting a structured report with categorized findings and recommendations.

How do I identify gaps in a product specification before development?

You can identify specification gaps by running a context-aware critique that reads spec.md, plan.md, and constitution guidelines to generate a report with clear severities and improvement recommendations.

Does the critique process require a constitution file to work?

A constitution file is not strictly required; the critique process reads constitution guidelines if present to ensure alignment, but it primarily analyzes spec.md and plan.md to produce the report.

Where are specification critique reports saved?

Specification critique reports are saved as markdown files at FEATURE_DIR/critiques/critique-{timestamp}.md, containing categorized findings, severities, and actionable recommendations.

Can I review previous critiques to inform current specification analysis?

Yes, the specification analysis process reads previous critiques alongside spec.md, plan.md, and constitution files to provide context-aware findings and improvement recommendations.