mate-academy/claude-multi-agent-workflow

Project — Ship your workflow as a plugin

Across the course you’ve built scoped subagents, orchestrated them into workflows, written skills, commands, and hooks, and learned how a plugin packages all of it. Now you’ll put it together into one real, shareable thing: a plugin that carries a multi-agent workflow, tested against a live codebase and published so anyone can install it with a single command.

Lean on Claude as you go: ask it to scaffold files, look up current syntax, and review your structure. That’s how you’d really build one.

---

The repository

We’ve provided a repo for your plugin — this is where you’ll assemble and publish it. The same Express API from the earlier projects is included here under course-api/; build and test your plugin against it so your subagents and workflow operate on real code rather than a toy example.

By the end, the provided repo will be two things at once: the plugin itself, and the marketplace that offers it.

---

What you’ll build

A single plugin that bundles:

• Two scoped subagents — purpose-built workers, each limited to the tools and model its job needs.
• A multi-agent workflow command — one command that runs those subagents as a workflow, with at least one parallel step and one dependent step.
• A skill and a hook — to round the plugin into a complete setup, not just agents.
• A manifest, a README, and a marketplace catalog — so the plugin installs by name and you can version it.

---

Before you start

• Have this repo cloned. The course API to test against is included here in course-api/ — cd course-api && npm install once so it’s ready to run.
• Skim back over Unit 8 (creating, scoping, and orchestrating subagents) and Unit 9 (plugin structure, ${CLAUDE_PLUGIN_ROOT}, marketplaces, versioning) — you’ll use all of it.
• Decide on a theme for your plugin so the pieces belong together. A ‘code quality’ plugin (review + tests + a formatting hook) or a ‘release’ plugin (changelog + version bump + checks) both work well.

---

Tasks

Task 1 — Scaffold the plugin.

In the provided repo, create the plugin structure: .claude-plugin/plugin.json with a name and a starting version, the component folders you’ll need at the root, and a README.md. Confirm the layout is right — only plugin.json lives inside .claude-plugin/, everything else sits at the root.

Task 2 — Build two scoped subagents.

Add at least two custom subagents in agents/. For each one:

• a description that names when to use it, in the words a real situation would use;
• a body that says what to do and what to return;
• a tools line limited to what the job actually needs (read-only workers get read-and-search tools only);
• a model matched to the difficulty of the job. Make them genuinely different — for example, a read-only reviewer and an agent that writes or edits.

Task 3 — Orchestrate them into a workflow command.