BOHICA-LABS / BOHICA-LABS/vsdd-factory

bug(orchestrator): task-tracking tools (TaskCreate/Update/List) should be default-loaded, not deferred

Open
#221 1 comment 0 reactions 0 assignees View on GitHub
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

Open the contributing guide

Assessment

This issue has not been assessed yet.

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.