speckit-critique-run

Review specification and implementation plan for product fit and engineering risk.

Updated Mar 16, 2026
One-click install
npx skills add https://github.com/B0yZ4kr14/OrthoPlus-Enterprise --skill speckit-critique-run-b0yz4kr14
Or copy as Structured Prompt for Agentβ–Ό
Please help me install this Agent Skill.
Skill: speckit-critique-run
Source: https://github.com/B0yZ4kr14/OrthoPlus-Enterprise/tree/main/.specify-backups/20260518-141826/_agents/skills/speckit-critique-run
Command: npx skills add https://github.com/B0yZ4kr14/OrthoPlus-Enterprise --skill speckit-critique-run-b0yz4kr14

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

It prevents costly implementation pivots by challenging a specification and plan from both product strategy and engineering risk perspectives before any build work starts.

Core Features & Use Cases

  • Dual-Lens Critical Review: Assesses problem validation, user value, alternatives, edge cases, and success measurement using a Product Lens, then evaluates architecture, failure modes, security/privacy, performance, testing, and operational readiness using an Engineering Lens.
  • Extension Hook Integration: Detects and runs configured pre-critique hooks (from .specify/extensions.yml) to enrich context while respecting optional vs mandatory execution rules.
  • Structured, Actionable Output: Generates a critique report in FEATURE_DIR/critiques/critique-{timestamp}.md using the critique-template structure, including severity classification (🎯 Must-Address, πŸ’‘ Recommendation, πŸ€” Question) and a findings summary table.
  • Safe Guardrails for Artifacts: Enforces STRICTLY READ-ONLY behavior for existing spec/plan artifacts and only creates new critique output files, with suggested spec/plan edits provided for optional follow-up.

Quick Start

Run speckit-critique-run from the skill entry command context so it reads spec.md and plan.md, loads constitution guidance if present, and produces a timestamped critique report for review.

Frequently Asked Questions about speckit-critique-run

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

FAQPage Schema
How do I review a technical specification for both product fit and engineering risk?β–Ό

To review a technical specification for product fit and engineering risk, use a dual-lens critique process that evaluates user value, architecture soundness, security posture, and operational readiness before implementation begins.

What is dual-lens specification critique and when do I need it?β–Ό

Dual-lens specification critique is a pre-implementation review process that assesses problem validation and user value through a product lens, while evaluating failure modes, security, and scalability through an engineering lens.

How do I generate a structured critique report with severity classifications for my implementation plan?β–Ό

Generate a structured critique report by running an automated review of your spec.md and plan.md files, which produces a timestamped markdown file containing severity classifications like Must-Address, Recommendation, and Question alongside a findings summary table.

Can I run automated architecture and security risk assessments without modifying my existing spec files?β–Ό

Yes, automated architecture and security risk assessments can run with strictly read-only guardrails on your existing specification and plan artifacts, ensuring original files remain untouched while generating separate critique output files.

Does the specification critique process support custom pre-critique hooks and extension configurations?β–Ό

Yes, the specification critique process detects and runs configured pre-critique hooks from extension configuration files, enriching the review context while respecting optional versus mandatory execution rules defined in your environment.

What are the limitations of automated spec critique for operational readiness evaluation?β–Ό

Automated spec critique limitations include relying solely on provided spec.md and plan.md inputs for context, meaning incomplete documentation or missing architecture details can result in superficial operational readiness and scalability findings.