writing-specs

What problem does it solve?

This Skill eliminates the common pitfalls of overly detailed, hard-to-maintain specifications that mix requirements with implementation details. It ensures your feature specifications are concise, focused on "WHAT" and "WHY," and easily digestible, preventing spec drift and inefficiency.

Core Features & Use Cases

• Lean Spec Generation: Creates concise feature specifications that focus on requirements and architecture, avoiding implementation plans, code examples, or success metrics.
• Constitution Integration: Automatically references project constitutions for architectural rules and mandatory patterns, avoiding duplication and ensuring consistency.
• External Documentation Linking: Encourages linking to external documentation (e.g., Zod docs) instead of embedding code examples, keeping specs clean and up-to-date.
• Use Case: After a brainstorming session for a new feature, use this Skill to quickly draft a comprehensive yet lean spec.md document, ensuring all requirements are captured without getting bogged down in implementation details, which are handled by other Skills.

Quick Start

Generate a feature specification

/spectacular:spec "admin dashboard with real-time analytics"

Review the generated spec

cat specs/a1b2c3-refactor-components/spec.md