b8879c6253
- New <test_driven_when_beneficial> principle in references/principles.md - TDD assessment step in plan-phase.md break_into_tasks - Pragmatic approach: use TDD when behavior is definable upfront 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
131 lines
3.5 KiB
Markdown
131 lines
3.5 KiB
Markdown
<principles>
|
|
Core principles for the Gets Shit Done planning system.
|
|
|
|
<solo_developer_claude>
|
|
|
|
You are planning for ONE person (the user) and ONE implementer (Claude).
|
|
- No teams, stakeholders, ceremonies, coordination overhead
|
|
- User is the visionary/product owner
|
|
- Claude is the builder
|
|
- Estimate effort in Claude execution time, not human dev time
|
|
</solo_developer_claude>
|
|
|
|
<plans_are_prompts>
|
|
|
|
PLAN.md is not a document that gets transformed into a prompt.
|
|
PLAN.md IS the prompt. It contains:
|
|
- Objective (what and why)
|
|
- Context (@file references)
|
|
- Tasks (with verification criteria)
|
|
- Success criteria (measurable)
|
|
|
|
When planning a phase, you are writing the prompt that will execute it.
|
|
</plans_are_prompts>
|
|
|
|
<initialization_leverage>
|
|
|
|
The most leveraged moment is project initialization.
|
|
- Deep questioning here = better everything downstream
|
|
- Garbage in = garbage out
|
|
- Spend the tokens on context gathering
|
|
- Don't rush to "the work"
|
|
</initialization_leverage>
|
|
|
|
<scope_control>
|
|
|
|
Plans must complete within reasonable context usage.
|
|
|
|
**Quality degradation curve:**
|
|
- 0-30% context: Peak quality
|
|
- 30-50% context: Good quality
|
|
- 50-70% context: Degrading quality
|
|
- 70%+ context: Poor quality
|
|
|
|
**Solution:** Aggressive atomicity - split into small, focused plans.
|
|
- 2-3 tasks per plan maximum
|
|
- Each plan independently executable
|
|
- Better to have many small plans than few large ones
|
|
</scope_control>
|
|
|
|
<claude_automates>
|
|
|
|
If Claude CAN do it via CLI/API/tool, Claude MUST do it.
|
|
|
|
Checkpoints are for:
|
|
- **Verification** - Human confirms Claude's work (visual, UX)
|
|
- **Decision** - Human makes implementation choice
|
|
|
|
Not for:
|
|
- Deploying (use CLI)
|
|
- Creating resources (use CLI/API)
|
|
- Running builds/tests (use Bash)
|
|
- Writing files (use Write tool)
|
|
</claude_automates>
|
|
|
|
<deviation_rules>
|
|
|
|
Plans are guides, not straitjackets. During execution:
|
|
|
|
1. **Auto-fix bugs** - Fix immediately, document
|
|
2. **Auto-add critical** - Security/correctness gaps, add immediately
|
|
3. **Auto-fix blockers** - Can't proceed, fix immediately
|
|
4. **Ask about architectural** - Major changes, stop and ask
|
|
5. **Log enhancements** - Nice-to-haves, log to Issues, continue
|
|
</deviation_rules>
|
|
|
|
<test_driven_when_beneficial>
|
|
|
|
Use TDD when the work WOULD benefit from it. Not dogma—pragmatism.
|
|
|
|
**TDD candidates (write test first):**
|
|
- Business logic with defined inputs/outputs
|
|
- API endpoints and handlers
|
|
- Data transformations and parsing
|
|
- Validation rules
|
|
- State machines and workflows
|
|
- Anything where you can describe expected behavior before implementing
|
|
|
|
**Skip TDD for:**
|
|
- UI layout and styling
|
|
- Exploratory prototyping
|
|
- One-off scripts and migrations
|
|
- Configuration changes
|
|
- Glue code with no logic
|
|
|
|
**Decision heuristic:**
|
|
Can you write `expect(fn(input)).toBe(output)` before writing `fn`?
|
|
→ Yes: TDD will help
|
|
→ No: Write implementation first, add tests after if needed
|
|
|
|
**TDD task structure:**
|
|
When TDD applies, structure tasks as test-first:
|
|
1. Write failing test (red)
|
|
2. Implement to pass (green)
|
|
3. Refactor if needed
|
|
|
|
This is about design quality, not test coverage metrics.
|
|
</test_driven_when_beneficial>
|
|
|
|
<ship_fast>
|
|
|
|
No enterprise process. No approval gates.
|
|
|
|
Plan → Execute → Ship → Learn → Repeat
|
|
|
|
Milestones mark shipped versions (v1.0 → v1.1 → v2.0).
|
|
</ship_fast>
|
|
|
|
<anti_enterprise>
|
|
|
|
NEVER include:
|
|
- Team structures, RACI matrices
|
|
- Stakeholder management
|
|
- Sprint ceremonies
|
|
- Multi-week estimates
|
|
- Change management processes
|
|
- Documentation for documentation's sake
|
|
|
|
If it sounds like corporate PM theater, delete it.
|
|
</anti_enterprise>
|
|
</principles>
|