| name | paw-work-shaping |
| description | Interactive pre-spec ideation utility skill. Agent-led Q&A to progressively clarify vague ideas, research codebase context, and produce structured WorkShaping.md artifact. |
Work Shaping
Execution Context: This skill runs directly in the PAW session (not a subagent)—interactive Q&A by design.
Interactive ideation session to transform vague ideas into structured, spec-ready work items.
When to Use
- User explicitly asks to explore, shape, or flesh out an idea
- Request has exploratory language ("what if", "maybe we could", "I'm thinking about")
- User expresses uncertainty ("I'm not sure if...", "not sure how to approach")
- Idea is too vague for direct specification
Session Flow
1. Opening
Acknowledge the idea and set expectations:
- This is an exploratory conversation to clarify the work
- You'll ask questions to understand intent, constraints, and scope
- User can end anytime; you'll signal when "complete enough"
2. Progressive Clarification
Agent-led Q&A to build understanding:
Question strategy:
- One question at a time
- Start broad (intent, value proposition), then narrow (boundaries, constraints)
- Offer recommendations when you have informed opinions
- Prefer multiple choice when options are enumerable
Topics to explore (adapt based on idea):
- Core value: What problem does this solve? Who benefits?
- Scope boundaries: What's definitely in? What's explicitly out?
- User interactions: How will users engage with this?
- Edge cases: What happens when X fails/is empty/conflicts?
- Success definition: How will we know it works?