sj-spec

What problem does it solve?

Vague, ambiguous product and feature requirements lead to team misalignment, implementation rework, and missed project goals. This Skill eliminates that friction by forcing clarity through structured, step-by-step questioning and validation, ensuring every spec is actionable before development starts.

Core Features & Use Cases

• 5-Step Structured Spec Generation: Progresses through Why, Scope, Technical, Draft, and File stages to build complete, implementable specifications.
• Forced Clarifying Questions: Uses a standardized set of 6 mandatory questions to eliminate ambiguity without unnecessary back-and-forth, making assumptions only when explicitly allowed.
• Automatic Scope Triage: Identifies overly large scopes and proposes MVP vs full implementation options to keep projects on track.
• Codebase Context Integration: Automatically explores existing project structure and interfaces to ensure specs align with current technical constraints.
• Built-in Quality Validation: Runs a 7-point checklist on all drafts to verify specs are measurable, edge-case ready, and free of scope creep.
• Downstream Dispatch Integration: Auto-registers generated spec paths to the project task file for seamless handoff to implementation agents. Use Case: If a stakeholder submits a vague request like "add a login feature", this Skill will generate a full, implementable spec with success metrics, scope boundaries, technical requirements, and acceptance criteria in minutes, no manual requirement gathering required.

Quick Start

Use the sj-spec skill to generate a full implementation-ready specification for the new user profile editing feature.