refining-requirements

What problem does it solve?

This Skill eliminates the ambiguity and incompleteness often found in product requirements documents (PRDs). It prevents costly rework and delays by transforming rough, prose-heavy requirements into structured, implementation-ready specifications, ensuring clarity before a single line of code is written.

Core Features & Use Cases

• Auto-Detect Project Context: Automatically identifies the tech stack (e.g., Node.js, Go, Python, Java) and reads project conventions from CLAUDE.md to tailor the refinement process.
• Validate File Paths: Verifies if referenced files exist (✓ EXISTS), need creation (✗ CREATE), or require confirmation (? VERIFY) against the actual codebase, providing a clear action plan for file modifications.
• Structure & Refine: Converts narrative requirements into detailed sections, including data models, API contracts, business logic, test scenarios, and security checklists, optimized for AI code execution.
• Multi-Stack & Greenfield Support: Handles complex scenarios like monorepos with multiple languages or entirely new projects built from scratch, generating stack-specific guidance.
• Use Case: A developer receives a PRD that is vague, scatters file paths, and says "similar to X" without explanation. This skill refines it into a detailed, structured specification with clear file mappings, API definitions, and a security checklist, ready for immediate coding.

Quick Start

Refine the attached Product Requirements Document (PRD) into an implementation-ready specification.