From 4b150b0918fe76aff3c30bf674b6f8172c59919f Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Dennis=20Sch=C3=B6n?= Date: Sun, 26 Oct 2025 21:21:34 +0100 Subject: [PATCH] onboard: add step to commit JSONL with code changes (#154) Add a new step to the onboarding workflow reminding AI agents to commit the `.beads/issues.jsonl` file together with code changes. This ensures issue state stays synchronized with code state, which is critical for maintaining accurate project history and making issues meaningful when reviewing past commits. --- cmd/bd/onboard.go | 1 + 1 file changed, 1 insertion(+) diff --git a/cmd/bd/onboard.go b/cmd/bd/onboard.go index f3846ba5..79ffe91a 100644 --- a/cmd/bd/onboard.go +++ b/cmd/bd/onboard.go @@ -66,6 +66,7 @@ bd close bd-42 --reason "Completed" --json 4. **Discover new work?** Create linked issue: - ` + "`bd create \"Found bug\" -p 1 --deps discovered-from:`" + ` 5. **Complete**: ` + "`bd close --reason \"Done\"`" + ` +6. **Commit together**: Always commit the `.beads/issues.jsonl` file together with the code changes so issue state stays in sync with code state ### Auto-Sync