Skip to content

fix: add mode: subagent to agent frontmatter#13

Merged
jflowers merged 1 commit into
unbound-force:mainfrom
marcusburghardt:fix/agent-mode-subagent
Apr 23, 2026
Merged

fix: add mode: subagent to agent frontmatter#13
jflowers merged 1 commit into
unbound-force:mainfrom
marcusburghardt:fix/agent-mode-subagent

Conversation

@marcusburghardt

Copy link
Copy Markdown
Contributor

Summary

  • Added mode: subagent to coordinator.md, worker.md, and background-worker.md YAML frontmatter
  • Added hidden: true to worker.md and background-worker.md (internal agents, never user-invoked)

Problem

All three agent files lacked a mode: field. OpenCode defaults agents without mode to all, making them appear as Tab-cyclable primary modes alongside Build and Plan. Users see unexpected modes after replicator init -- coordinator, worker, and background-worker -- with no explanation of what they are.

Fix

  • coordinator.md: mode: subagent -- invokable via /forge or programmatically, not via Tab
  • worker.md: mode: subagent + hidden: true -- internal forge agent, hidden from @ autocomplete
  • background-worker.md: mode: subagent + hidden: true -- internal forge agent, hidden from @ autocomplete

All agentkit and init tests pass.

Closes #12

coordinator.md, worker.md, and background-worker.md lacked a mode
field in their YAML frontmatter. OpenCode defaults agents without
mode to 'all', making them appear as Tab-cyclable primary modes
alongside Build and Plan. Users see unexpected modes with no
documentation explaining their purpose.

Add mode: subagent to all three agents. Additionally add
hidden: true to worker.md and background-worker.md since users
should never invoke these directly -- they are internal to the
forge coordination system.

Closes unbound-force#12

Assisted-by: OpenCode (claude-opus-4-6)
Signed-off-by: Marcus Burghardt <[email protected]>

@jflowers jflowers left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

lgtm

@jflowers jflowers merged commit f813e44 into unbound-force:main Apr 23, 2026
1 check passed
@marcusburghardt marcusburghardt deleted the fix/agent-mode-subagent branch April 24, 2026 08:19
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

Status: No status

Development

Successfully merging this pull request may close these issues.

fix: add mode: subagent to agent frontmatter

3 participants