Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 1 addition & 1 deletion .claude-plugin/plugin.json
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
{
"name": "stepwise-dev",
"version": "0.0.6",
"version": "0.0.7",
"description": "Research → Plan → Implement → Validate workflow for Claude Code with local thoughts/ management",
"author": {
"name": "Jorge Castro",
Expand Down
53 changes: 0 additions & 53 deletions CLAUDE.md
Original file line number Diff line number Diff line change
Expand Up @@ -171,59 +171,6 @@ thoughts/
4. **Parallel research:** Commands spawn multiple agents concurrently
5. **Local persistence:** All documents saved to `thoughts/` for future reference

## Planning Philosophy

The `create_plan` command emphasizes **vertical slicing** and **small safe steps** based on Eduardo Ferro's lean delivery philosophy.

### Key Principles:

1. **Vertical Slicing** (Hamburger Method):
- Identify technical layers (input → processing → storage → delivery)
- Define quality attributes (simplest → most robust) for each layer
- Compose minimal vertical slices that deliver real user value
- Iterate to enhance quality and scope

2. **Small Safe Steps**:
- Each phase delivers working functionality
- Favor reversible changes (feature flags, parallel writes, gradual rollouts)
- Postpone irreversible decisions until more information is available
- Separate learning (time-boxed research) from earning (value delivery)

3. **Progressive Delivery Patterns**:
- Dummy → Dynamic (hardcoded → real data)
- Backend-only → Full Stack (API → UI)
- Limited Scope → Full Feature (one segment/format → many)
- Manual → Automated (prove value → automate)
- Feature Flagged Rollout (team → beta → all)

4. **Eduardo Ferro's Leadership Philosophy**:
- "Can we avoid doing it?" - Challenge necessity
- "Can we achieve the same impact with fewer resources?" - Maximize impact, minimize effort
- "What if we only had half the time?" - Force prioritization
- "If you had to ship by tomorrow, what would you build?" - Identify minimum viable deliverable
- "What's the worst that could happen?" - Evaluate risk realistically for safe experiments

### Planning Process:

The enhanced planning flow includes:
1. Context gathering (read files, spawn research agents)
2. **Vertical slicing analysis** (new - Hamburger Method, complexity assessment)
3. Plan structure development (based on vertical slices)
4. Detailed plan writing (with Learning/Earning phases, reversibility notes)
5. Review and iteration

### Plan Structure:

Plans now include:
- **Vertical Slicing Analysis**: Layers, quality attributes, slice options, complexity assessment
- **Progressive Delivery Pattern**: Specific pattern chosen and rollout strategy
- **Decisions and Postponements**: What's decided now vs later
- **Phases with Learning/Earning tags**: Each phase classified by type
- **Reversibility notes**: How to undo or compensate for each phase
- **Success criteria**: Still separated into automated vs manual

This approach ensures plans are incremental, testable, and aligned with TDD and lean delivery principles.

## Configuration

**Username**: Set `export THOUGHTS_USER=your_name` (default: `nikey_es`)
Expand Down
11 changes: 0 additions & 11 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -28,17 +28,6 @@ Implements **Research -> Plan -> Implement -> Validate** with frequent `/clear`

## 📦 What's Included

### Enhanced Planning with Vertical Slicing

The `create_plan` command guides you through creating implementation plans that emphasize:
- **Small safe steps** using the Hamburger Method for vertical slicing
- **Progressive delivery** patterns (dummy → dynamic, backend-only → full stack, etc.)
- **Learning vs Earning** phases to separate research from value delivery
- **Complexity assessment** to guide implementation decisions
- **Reversibility** and rollback strategies for each phase

Plans are created interactively, with vertical slicing analysis before committing to detailed phases.

### Slash Commands

| Command | Description |
Expand Down
Loading