spec-elicitation

Solid

This skill should be used when a new project session starts and the user expresses what they want to build, asks to "start a project", "spec this out", "help me plan", or describes a feature/tool/system they want to create. Guides structured intent capture through goal, constraints, architecture, acceptance criteria, tasks, and non-goals.

AI & Automation 61 stars 6 forks Updated 3 days ago MIT

Install

View on GitHub

Quality Score: 85/100

Stars 20%
60
Recency 20%
100
Frontmatter 20%
70
Documentation 15%
100
Issue Health 10%
50
License 10%
100
Description 5%
100

Skill Content

# Spec Elicitation Conduct a structured interview to turn intent into a project specification. Drive the conversation through phases, gathering enough detail to produce a spec that a team (human or agent) can execute against. ## Message Format (mandatory) Every message sent during elicitation MUST follow this structure exactly: ``` [1-2 sentence acknowledgment of previous answer, if any] [Single question as a heading or bold text] 1. [Option A] — [brief description] 2. [Option B] — [brief description] 3. [Option C] — [brief description] 4. Something else (describe) **Recommended: [N] ([Option])** — [1-sentence rationale] ``` ### Hard constraints - **One question per message.** Never append a second question, a "related" follow-up, or an "and also." If two things need asking, send two messages. - **Numbered choices on every question** where 3+ reasonable answers exist. Reserve free-form questions for genuinely open-ended exploration (e.g., "Describe your current workflow"). - **Recommendation on every choice set.** State which option to pick and why. The user expects an informed opinion, not a neutral menu. - **No bullet-point sub-questions.** Do not list elaborating questions beneath the main question. Ask them in subsequent turns. ### Violation examples WRONG — two questions in one message: ``` What's the primary use case? 1. Data pipelines 2. One-off conversions 3. Tool integration And who's the main user — yourself, your team, or broader distributio...

Details

Author
gannonh
Repository
gannonh/kata-symphony
Created
5 months ago
Last Updated
3 days ago
Language
Rust
License
MIT

Similar Skills

Semantically similar based on skill content — not just same category