BOHICA-LABS / BOHICA-LABS/vsdd-factory
bug(orchestrator): task-tracking tools (TaskCreate/Update/List) should be default-loaded, not deferred
- Dominant language
- Rust
- Stars
- 2
- Forks
- 1
- Avg merge
- 6h 43m
- Merged PRs (30d)
- 29
Description
## Summary
When an orchestrator session starts, the `TaskCreate`, `TaskUpdate`, and `TaskList` tools are not in the orchestrator's default tool profile — they appear in the deferred-tools list and must be loaded via `ToolSearch` before first use.
For an agent whose explicit purpose is to coordinate multi-step work across many sub-agents, task-tracking primitives are core, not peripheral. The current setup means:
- Every session, the orchestrator wastes a turn on `ToolSearch query="select:TaskCreate,TaskUpdate,TaskList"` before it can track anything.
- If the orchestrator forgets to load them and is later prompted to track tasks (system-reminder fires), it has to discover the tools mid-execution.
## Reproduction
ftc-blue Phase 1d session (2026-06-23):
1. Session started; tool list did not include task-tracking primitives.
2. After several agent dispatches, the harness emitted: "The task tools haven't been used recently. If you're working on tasks that would benefit from tracking progress, consider using TaskCreate to add new tasks..."
3. Orchestrator had to run `ToolSearch query="select:TaskCreate,TaskUpdate,TaskList"` to load schemas.
4. Then could finally start tracking.
Net cost: one tool-search round-trip + interrupted flow.
## Proposed change
Add `TaskCreate`, `TaskUpdate`, `TaskList`, `TaskGet`, `TaskStop`, `TaskOutput` to the orchestrator agent's default tool profile in `agents/orchestrator/AGENTS.md` frontmatter or wherever tool profile is declared.
These are minimally-side-effecting, small-schema tools — no reason they need to be deferred for the orchestrator specifically. (Other agents with no orchestration mandate can still have them deferred.)
## Applies to
- `agents/orchestrator/AGENTS.md` — tool profile section
- Possibly other coordination-heavy agents: pr-manager, devops-engineer, possibly architect
## Acceptance criteria
- [ ] Task-tracking tools available in orchestrator's default profile (no ToolSearch required)
- [ ] System-reminder about task usage doesn't fire because tools are already loaded
- [ ] Documented in AGENTS.md why these are default-loaded for orchestrator
## Found during
ftc-blue Phase 1d session (2026-06-23, vsdd-factory@1.0.0-rc.21).
## Notes
Small / good-first-issue. Pairs well with Issue #11 (budget visibility) — task tools + budget visibility together let the orchestrator do informed self-pacing.
Contributor guide
Assessment
This issue has not been assessed yet.