From a7bfb3a6cf170f2f0bb11e78dc484e8d7c16b473 Mon Sep 17 00:00:00 2001 From: Steve Yegge Date: Wed, 17 Dec 2025 18:46:46 -0800 Subject: [PATCH] feat: Add dependency direction guidance to onboard MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Adds "Dependencies: Think Needs, Not Before" section with the WRONG/RIGHT example pair to help agents avoid the temporal language trap that inverts dependency direction. 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude Opus 4.5 --- cmd/bd/onboard.go | 11 +++++++++++ 1 file changed, 11 insertions(+) diff --git a/cmd/bd/onboard.go b/cmd/bd/onboard.go index 7e8b2224..242823df 100644 --- a/cmd/bd/onboard.go +++ b/cmd/bd/onboard.go @@ -182,6 +182,17 @@ Example: fetchUser(id) → fetchUser(id, { timeout: 3000 }) Depends on: bd-abc123 (fetch wrapper refactor) ` + "```" + ` +### Dependencies: Think "Needs", Not "Before" + +` + "`bd dep add X Y`" + ` = "X needs Y" = Y blocks X + +**TRAP**: Temporal words ("Phase 1", "before", "first") invert your thinking! +` + "```" + ` +WRONG: "Phase 1 before Phase 2" → bd dep add phase1 phase2 +RIGHT: "Phase 2 needs Phase 1" → bd dep add phase2 phase1 +` + "```" + ` +**Verify**: ` + "`bd blocked`" + ` - tasks blocked by prerequisites, not dependents. + ### Auto-Sync bd automatically syncs with git: