Skip to content

Commit 22ba320

Browse files
fix(backlog): disable cross-branch task scanning to prevent ghost tasks
With worktrees, check_active_branches and remote_operations scan other branches and pull in tasks that were already completed/archived on main but still exist in backlog/tasks/ on older branches. This bloats the kanban with ghost tasks (e.g. task-313 through task-327). Set both to false in backlog/config.yml and document the rationale in AGENTS.md.
1 parent 9dbdd13 commit 22ba320

2 files changed

Lines changed: 6 additions & 2 deletions

File tree

β€ŽAGENTS.mdβ€Ž

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -226,6 +226,10 @@ This project uses Backlog.md MCP for all task and project management.
226226

227227
**IMPORTANT**: Use `task_edit(status: "Done")` to mark tasks as done. Do NOT use `task_complete` unless the user explicitly asks to archive/clean up β€” it removes the task from the kanban.
228228

229+
### Cross-Branch Task Scanning (disabled)
230+
231+
`check_active_branches` and `remote_operations` are both **disabled** in `backlog/config.yml`. With worktrees, these features scan other branches and pull in tasks that were already completed/archived on `main` but still exist in `backlog/tasks/` on older branches β€” bloating the kanban with ghost tasks. Do not re-enable without accounting for worktree branch divergence.
232+
229233
### Multiline Field Gotcha
230234

231235
The `finalSummary`, `description`, `implementationNotes`, and `planSet` MCP parameters are single-line JSON strings. Literal `\n` sequences are NOT interpreted as newlines β€” they render as the two characters `\` `n` in the markdown file. To write multiline content:

β€Žbacklog/config.ymlβ€Ž

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -5,9 +5,9 @@ date_format: yyyy-mm-dd
55
max_column_width: 80
66
auto_open_browser: true
77
default_port: 6420
8-
remote_operations: true
8+
remote_operations: false
99
auto_commit: false
1010
bypass_git_hooks: false
11-
check_active_branches: true
11+
check_active_branches: false
1212
active_branch_days: 30
1313
task_prefix: "task"

0 commit comments

Comments
Β (0)