Skip to content

Commit 1d41516

Browse files
committed
New create plan with small safe steps
1 parent 8c4b614 commit 1d41516

5 files changed

Lines changed: 2195 additions & 25 deletions

File tree

.claude-plugin/plugin.json

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
{
22
"name": "stepwise-dev",
3-
"version": "0.0.5",
3+
"version": "0.0.6",
44
"description": "Research → Plan → Implement → Validate workflow for Claude Code with local thoughts/ management",
55
"author": {
66
"name": "Jorge Castro",

CLAUDE.md

Lines changed: 53 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -171,6 +171,59 @@ thoughts/
171171
4. **Parallel research:** Commands spawn multiple agents concurrently
172172
5. **Local persistence:** All documents saved to `thoughts/` for future reference
173173

174+
## Planning Philosophy
175+
176+
The `create_plan` command emphasizes **vertical slicing** and **small safe steps** based on Eduardo Ferro's lean delivery philosophy.
177+
178+
### Key Principles:
179+
180+
1. **Vertical Slicing** (Hamburger Method):
181+
- Identify technical layers (input → processing → storage → delivery)
182+
- Define quality attributes (simplest → most robust) for each layer
183+
- Compose minimal vertical slices that deliver real user value
184+
- Iterate to enhance quality and scope
185+
186+
2. **Small Safe Steps**:
187+
- Each phase delivers working functionality
188+
- Favor reversible changes (feature flags, parallel writes, gradual rollouts)
189+
- Postpone irreversible decisions until more information is available
190+
- Separate learning (time-boxed research) from earning (value delivery)
191+
192+
3. **Progressive Delivery Patterns**:
193+
- Dummy → Dynamic (hardcoded → real data)
194+
- Backend-only → Full Stack (API → UI)
195+
- Limited Scope → Full Feature (one segment/format → many)
196+
- Manual → Automated (prove value → automate)
197+
- Feature Flagged Rollout (team → beta → all)
198+
199+
4. **Eduardo Ferro's Leadership Philosophy**:
200+
- "Can we avoid doing it?" - Challenge necessity
201+
- "Can we achieve the same impact with fewer resources?" - Maximize impact, minimize effort
202+
- "What if we only had half the time?" - Force prioritization
203+
- "If you had to ship by tomorrow, what would you build?" - Identify minimum viable deliverable
204+
- "What's the worst that could happen?" - Evaluate risk realistically for safe experiments
205+
206+
### Planning Process:
207+
208+
The enhanced planning flow includes:
209+
1. Context gathering (read files, spawn research agents)
210+
2. **Vertical slicing analysis** (new - Hamburger Method, complexity assessment)
211+
3. Plan structure development (based on vertical slices)
212+
4. Detailed plan writing (with Learning/Earning phases, reversibility notes)
213+
5. Review and iteration
214+
215+
### Plan Structure:
216+
217+
Plans now include:
218+
- **Vertical Slicing Analysis**: Layers, quality attributes, slice options, complexity assessment
219+
- **Progressive Delivery Pattern**: Specific pattern chosen and rollout strategy
220+
- **Decisions and Postponements**: What's decided now vs later
221+
- **Phases with Learning/Earning tags**: Each phase classified by type
222+
- **Reversibility notes**: How to undo or compensate for each phase
223+
- **Success criteria**: Still separated into automated vs manual
224+
225+
This approach ensures plans are incremental, testable, and aligned with TDD and lean delivery principles.
226+
174227
## Configuration
175228

176229
**Username**: Set `export THOUGHTS_USER=your_name` (default: `nikey_es`)

README.md

Lines changed: 11 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -28,6 +28,17 @@ Implements **Research -> Plan -> Implement -> Validate** with frequent `/clear`
2828

2929
## 📦 What's Included
3030

31+
### Enhanced Planning with Vertical Slicing
32+
33+
The `create_plan` command guides you through creating implementation plans that emphasize:
34+
- **Small safe steps** using the Hamburger Method for vertical slicing
35+
- **Progressive delivery** patterns (dummy → dynamic, backend-only → full stack, etc.)
36+
- **Learning vs Earning** phases to separate research from value delivery
37+
- **Complexity assessment** to guide implementation decisions
38+
- **Reversibility** and rollback strategies for each phase
39+
40+
Plans are created interactively, with vertical slicing analysis before committing to detailed phases.
41+
3142
### Slash Commands
3243

3344
| Command | Description |

0 commit comments

Comments
 (0)