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 <maburgha@redhat.com>
Copy link
Copy Markdown
Contributor

@jflowers jflowers left a comment

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

None yet

Development

Successfully merging this pull request may close these issues.

fix: add mode: subagent to agent frontmatter

2 participants