Shape Issues
Iterative issue exploration and shaping process that transforms rough ideas into well-defined,
time-boxed GitHub Issues using Shape Up methodology and continuous discovery principles.
Attribution: Based on work by roksechs
Phases
- Problem Exploration: Examine raw ideas, map pain points, assess timebox
- Solution Sketching: Brainstorm approaches, set scope boundaries, identify risks
- Issue Formation: Problem statement, timebox, solution sketch, rabbit holes
- Betting Table: Prioritize by timebox, balance portfolio, set circuit breakers
- Issue Crafting: Create GitHub Issues with size labels, handoff to
/resolve-issues
Sizing
| Label |
Duration |
size:xs |
< 1 day |
size:s |
1-3 days |
size:m |
3-5 days |
size:l |
1-2 weeks |
size:xl |
2+ weeks |
Workflow
- Gather context:
gh issue list, gh pr list
- Explore problem: user complaints, workflow friction, timebox check
- Sketch solutions: 2-3 approaches, scope boundaries, rabbit holes
- Set timebox: spike vs small batch vs big batch
- Create issue:
gh issue create with template, add ready-for-dev label
Issue Template
Key sections: Problem (raw idea, pain, size), Solution Sketch (concept, out of scope),
Rabbit Holes (complexity traps), Done Looks Like (acceptance criteria).
Usage
/shape-issues
Workflow: /shape-issues -> /resolve-issues -> /review-pr -> /resolve-pr-review-thread
Related Skills
- pr-standards (git-standards) — PR authoring and review standards applied after issues are implemented
Converted and distributed by TomeVault — claim your Tome and manage your conversions.
1---2name: shape-issues3description: Shape raw ideas into actionable GitHub Issues using Shape Up methodology Use when this capability is needed.4---56# Shape Issues78Iterative issue exploration and shaping process that transforms rough ideas into well-defined,9time-boxed GitHub Issues using Shape Up methodology and continuous discovery principles.1011> **Attribution**: Based on work by [roksechs](https://gist.github.com/roksechs/3f24797d4b4e7519e18b7835c6d8a2d3)1213## Phases14151. **Problem Exploration**: Examine raw ideas, map pain points, assess timebox162. **Solution Sketching**: Brainstorm approaches, set scope boundaries, identify risks173. **Issue Formation**: Problem statement, timebox, solution sketch, rabbit holes184. **Betting Table**: Prioritize by timebox, balance portfolio, set circuit breakers195. **Issue Crafting**: Create GitHub Issues with size labels, handoff to `/resolve-issues`2021## Sizing2223| Label | Duration |24| --- | --- |25| `size:xs` | < 1 day |26| `size:s` | 1-3 days |27| `size:m` | 3-5 days |28| `size:l` | 1-2 weeks |29| `size:xl` | 2+ weeks |3031## Workflow32331. Gather context: `gh issue list`, `gh pr list`342. Explore problem: user complaints, workflow friction, timebox check353. Sketch solutions: 2-3 approaches, scope boundaries, rabbit holes364. Set timebox: spike vs small batch vs big batch375. Create issue: `gh issue create` with template, add `ready-for-dev` label3839## Issue Template4041Key sections: Problem (raw idea, pain, size), Solution Sketch (concept, out of scope),42Rabbit Holes (complexity traps), Done Looks Like (acceptance criteria).4344## Usage4546```text47/shape-issues48```4950**Workflow**: `/shape-issues` -> `/resolve-issues` -> `/review-pr` -> `/resolve-pr-review-thread`5152## Related Skills5354- pr-standards (git-standards) — PR authoring and review standards applied after issues are implemented5556---57> Converted and distributed by [TomeVault](https://tomevault.io/claim/jacobpevans) — claim your Tome and manage your conversions.58<!-- tomevault:4.0:skill_md:2026-04-13 -->
