feature-spec-critic

What problem does it solve?

This Skill eliminates the tedious and time-consuming manual process of reviewing engineering specifications by automatically evaluating them against a detailed quality rubric. It ensures high-quality, implementable specs, significantly reducing rework, preventing costly errors, and improving overall development efficiency.

Core Features & Use Cases

• Automated Spec Evaluation: Scores engineering specifications on critical dimensions like clarity, coverage, architecture, and risk.
• Detailed Issue Identification: Pinpoints critical, moderate, and minor issues within the spec, providing actionable descriptions and suggestions for improvement.
• Quality Gate: Acts as a crucial quality gate before development begins, ensuring all requirements are met and potential problems are identified early.
• Use Case: A new feature specification is drafted. This Skill reviews it, identifies a critical security vulnerability (e.g., missing rate limiting for an API endpoint), and suggests a specific fix, preventing a major issue from reaching production.

Quick Start

Review the engineering specification located at 'specs/new-feature/spec-draft.md' against the quality rubric and provide a detailed critique in JSON format.