beads-deciduous-integration

Beads & Deciduous Integration

Key Principle

Use /workflow-commands:* - they handle tracking automatically.

❌ Don't use directly	✅ Use instead
ed3d-plan-and-execute:start-design-plan	/workflow-commands:design
ed3d-plan-and-execute:start-implementation-plan	/workflow-commands:plan
ed3d-plan-and-execute:execute-implementation-plan	/workflow-commands:execute

Automatic Tracking

Command	Beads	Deciduous
project-init	Initializes .beads/	Initializes .deciduous/
intake	Creates epics	Logs goal/outcome
explore	Creates/closes task	Logs goal/outcome
design	Creates epic	Logs all decisions
plan	Creates phase tasks	Logs planning decisions
execute	Updates status	Logs impl decisions
verify	Closes epic	Logs outcome

Quick Reference

Beads

bd init                          # Initialize
bd create "Task" -t task -p 3    # Create
bd list / bd ready               # View
bd update <id> --status done     # Update
bd close <id> --reason "Done"    # Close
bd dep add <child> <parent>      # Dependency
bd comment <id> "LEARNED: ..."   # Note discoveries

Deciduous

deciduous init
deciduous add goal "..." -c 80          # -c takes integer 0-100, NOT float
deciduous add decision "..." -c 80
deciduous add action "..."
deciduous add outcome "..."
deciduous query

Decision Quality

Good:

deciduous add decision "Chose PostgreSQL over MongoDB because: 1) ACID required, 2) team expertise, 3) JOIN performance" -c 85

Bad:

deciduous add decision "Using PostgreSQL" -c 80

Commit Linking

Link commits to tracking for full traceability:

# After commit, link to beads task
bd comment <task-id> "Committed: $(git rev-parse --short HEAD)"

# Or link in deciduous with commit hash
deciduous add action "Implemented <feature>" --commit HEAD

Entry Points

Start From	When to Use
/workflow-commands:design	New feature needing architecture
/workflow-commands:plan	Have design, need implementation tasks
/workflow-commands:task	Small standalone work (<1 hour)
/workflow-commands:bug	Fix a bug
/workflow-commands:continue	Resume existing work

Full Workflow (Large Features)

/workflow-commands:project-init
    ↓
/workflow-commands:intake @roadmap.md --linear
    ↓
/workflow-commands:explore <topic>
    ↓
/workflow-commands:design
    ↓
/clear
/workflow-commands:plan @design.md .
    ↓
/clear
/workflow-commands:execute <plan> .
    ↓
/workflow-commands:verify --task <id>
    ↓
git commit / PR

Quick Workflow (Small Tasks)

/workflow-commands:task "Add logging to auth"
    ↓
(work directly)
    ↓
git commit
    ↓
bd close <id>

Bug Fix Workflow

/workflow-commands:bug "Users can't login"
    ↓
(investigate → find root cause → fix)
    ↓
git commit
    ↓
bd close <id>

Resuming Work

/workflow-commands:continue <task-id>
    ↓
(continue working)
    ↓
git commit
    ↓
bd close <id>