mexus-team

Why

A Mission is a bounded objective. A Squad Lead decomposes it, names a squad, and publishes tasks to a kanban. Background Agents claim tasks, do the work, and write results back. Every handoff is a Markdown edit you can open, diff, and review.

The kanban file is the coordination protocol. If you can read kanban.md, you know what every agent is doing and why.

This is a standalone plugin for Claude Code and Codex. It does not require a Mexus server, panes, a Mission Inbox, or external A2A messaging — coordination happens entirely through the agent-team/ Markdown files.

How It Works

Coordination lives entirely in one directory of your project:

agent-team/
├── mission-workflow.md          the reusable collaboration rules
├── agents.md                    repository-level reusable agent roster
└── missions/<mission-name>/
    ├── mission.md               goal, lifecycle, constraints
    ├── agents.md                this Mission's squad and prompts
    ├── kanban.md                task source of truth — the protocol
    ├── roundtable.md            shared decisions
    ├── squad-lead.md            Squad Lead coordination log
    └── artifacts/               long-form deliverables (research, decisions, docs)

• Squad Lead is a fixed coordination role — it plans, dispatches, sequences, and accepts. It never writes another agent's results.
• Mission Agents are background workers, named at random from the 72 spirits of the Ars Goetia. Each claims one scoped task, self-tests it, and fills in its own kanban block.
• Publisher acceptance: whoever publishes a task (From) reviews and accepts it. Squad Lead does mission-level acceptance on top.

Starting a new Mission archives the previous active one. Agents communicate only through the kanban file.

Artifacts

Long-form deliverables that are not source code — research reports, market scans, decision rationales, design memos — live as Markdown files under agent-team/missions/<name>/artifacts/. Each file starts with a YAML frontmatter block (title, author, date, optional related and tags) so the board can list and render it.

Three rules keep artifacts from being skipped:

• Research and document tasks must name the artifact path in their Acceptance field. The executor writes the file and lists the path in Files:.
• RoundTable proposals that pass review must produce a decision-record artifact (artifacts/<date>-rt-<topic-slug>.md) before they are considered closed.
• Mission-level acceptance checks both of the above before Squad Lead declares the Mission complete.

The board's Artifacts tab renders each file as HTML and shows author, date, related refs, and tags. See references/artifact-template.md for the file skeleton and agent-team/mission-workflow.md (## Artifacts) for the full rules.

Commands

Plugin skills are namespaced by the plugin. This plugin uses the mexus-team namespace.

Command	When	What it does
/mexus-team:mission "<request>"	Starting a new piece of work	Creates a Mission, archives the old one, plans the squad and kanban, starts the board, and dispatches the first background Agents.
/mexus-team:continue	Resuming a Mission in a later session	Reads the existing kanban and restarts outstanding tasks. No re-planning, no archiving.
/mexus-team:roundtable "<topic>"	A decision affects multiple agents	Opens a RoundTable proposal for a shared decision.
/mexus-team:board	Watching a Mission run	Starts a local read-only Web board over agent-team/.
/mexus-team:status	A quick terminal check	Prints a concise Mission and task summary.

Within one /mexus-team:mission session, Squad Lead dispatches follow-up tasks on its own — you do not run a command for that. /mexus-team:continue exists only to pick a Mission back up after the original session has ended.

Install

In Claude Code, add the marketplace from the GitHub repo and install the bundle:

/plugin marketplace add yofine/mexus-agent-team
/plugin install mexus-team@mexus-team
/reload-plugins

mexus-team@mexus-team is <plugin-name>@<marketplace-name>. Both are defined in .claude-plugin/marketplace.json; the GitHub repo slug (mexus-agent-team) is not the install handle.