Skip to content

Research + spike: cross-plugin agent roles - #227

Draft
mxriverlynn wants to merge 9 commits into
v6.0.0-betafrom
research/plugin-config-discovery
Draft

mxriverlynn wants to merge 9 commits into
v6.0.0-betafrom
research/plugin-config-discovery

Conversation

@mxriverlynn

@mxriverlynn mxriverlynn commented Oct 15, 2026 •

Copy link
Copy Markdown
Collaborator

Research report on letting installed Han plugins contribute configuration that other Han plugins discover automatically, plus a spike that applies its recommendation to test-engineer.

Research

Report: docs/research/cross-plugin-config-discovery.md

Recommendation (O5): han-planning's team lists name roles, not agents. The moved agent's own description says which role it fills. A planning skill uses any available agent that claims a role, and skips the role when none does. This needs no hook and no new dependency.

A general startup-hook mechanism (O1) is deferred until a plugin needs to contribute something other than an agent.

Spike

  • test-engineer moves from han-core into han-coding. Its description ends with Fills the han-planning test-planning role. han-coding's own skills now dispatch han-coding:test-engineer.
  • New owned rule han-planning/references/agent-roles.md defines the test-planning role, how an agent claims it, and how a skill fills it or skips it with a one-line note.
  • The four planning team lists (plan-a-feature, plan-implementation, plan-a-change, iterative-plan-review) name the test-planning role instead of han-core:test-engineer.
  • test/agent-roles.bats fails when an agent claims an undefined role, or when no agent claims a defined role.
  • Docs, indexes, the agent-placement rule in CONTRIBUTING, and the routing text in plan-synthesizer, junior-developer, and discussion-facilitator are updated.

Not done yet

  • Live behavior check. No one has run a planning skill with han-coding installed and again without it.
  • Release work. Version bumps and the CHANGELOG entry are not done.
  • Historical docs. Plans and research under docs/ still say han-core:test-engineer, on purpose.

@mxriverlynn mxriverlynn changed the title Research: cross-plugin config discovery Cross-plugin config discovery Oct 15, 2026
@mxriverlynn mxriverlynn changed the title Cross-plugin config discovery Research + spike: cross-plugin agent roles Oct 15, 2026
Reverts 1ea9d0c, 24e3ccd, abdb80a, and 3e276b8 so the change can be
planned in full with plan-a-change against the cross-plugin config
discovery research.
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.

2 participants