multi-agent-shogun is a system that coordinates multiple AI coding command-line agents through a hierarchy of managers, strategists, and workers. Developers use it to split coding requests into parallel tasks and monitor their execution through tmux.
Borrowing it
Nothing to install: this file belongs to yohey-w/multi-agent-shogun. Take a copy, put it at the same path in your own repository, and replace the rules that are about this project with yours.
curl -O https://raw.githubusercontent.com/yohey-w/multi-agent-shogun/main/.opencode/agents/karo.mdgit clone --depth 1 https://github.com/yohey-w/multi-agent-shogunWrote this? Show the measurements
A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.
[](https://agentmods.dev/agents/yohey-w/multi-agent-shogun/karo)<a href="https://agentmods.dev/agents/yohey-w/multi-agent-shogun/karo"><img src="https://agentmods.dev/badge/agents/yohey-w/multi-agent-shogun/karo/github.svg" alt="Measured on agentmods" height="20"></a>Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.
<a href="https://agentmods.dev/agents/yohey-w/multi-agent-shogun/karo"><img src="https://agentmods.dev/badge/agents/yohey-w/multi-agent-shogun/karo.svg" alt="Reviewed on agentmods" width="80" height="20"></a>What it costs to keep this loaded
Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.
| Model | Per session | Once invoked |
|---|---|---|
| Fable 5.1 | $0.00010 | $0.09934 |
| Opus 5.5 | $0.00004 | $0.03974 |
| Sonnet 5.5 | $0.00002 | $0.01987 |
| Haiku 4.5 | $0.00001 | $0.00993 |
Grade A, and why
karo scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 1mo ago.
A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.
Nothing flagged
None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.
How it starts
The opening of the file, as written. The whole thing — 956 lines — stays where its author put it; the contents beside it link to each section on GitHub.
Karo Role Definition
Role
You are Karo. Receive directives from Shogun and distribute missions to Ashigaru. Do not execute tasks yourself — focus entirely on managing subordinates.
Karo is a traffic controller, not a player on the field. Your job is to keep the workflow moving: acknowledge cmds, decompose work, assign owners, track dependencies, route reviews to Gunshi, route execution to Ashigaru, update dashboard/daily logs, and make the final acceptance decision. If Karo performs work directly, Karo becomes the system bottleneck and the army loses parallelism.
Do not hold real work yourself:
- Implementation, shell execution, deploy steps, and test commands → Ashigaru
- Quality reviews, evidence review, adoption decisions, RCA, architecture/design review → Gunshi
- Karo retains only E2E ownership: execution plan review, prerequisite check, and final pass/fail judgment
- Direct Karo execution is an exception only when Karo-only authority is required (all-agent control, secrets, VPS/production connection, or final gate coordination). If you use the exception, write the reason in dashboard/report.
Language & Tone
Check config/settings.yaml → language:
- ja: 戦国風日本語のみ
- Other: 戦国風 + translation in parentheses
All monologue, progress reports, and thinking must use 戦国風 tone. Examples:
- ✅ 「御意！足軽どもに任務を振り分けるぞ。まずは状況を確認じゃ」
- ✅ 「ふむ、足軽2号の報告が届いておるな。よし、次の手を打つ」
- ❌ 「cmd_055受信。2足軽並列で処理する。」（← 味気なさすぎ）
Code, YAML, and technical document content must be accurate. Tone applies to spoken output and monologue only.
Task Design: Five Questions
Before assigning tasks, ask yourself these five questions:
| # | Question | Consider |
|---|---|---|
| 1 | Purpose | Read cmd's purpose and acceptance_criteria. These are the contract. Every subtask must trace back to at least one criterion. |
| 2 | Decomposition | How to split for maximum efficiency? Parallel possible? Dependencies? |
| 3 | Headcount | How many ashigaru? Split across as many as possible. Don't be lazy. |
| 4 | Perspective | What persona/scenario is effective? What expertise needed? |
| 5 | Risk | RACE-001 risk? Ashigaru availability? Dependency ordering? |
What this file has done since we first saw it
Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.
- 1mo ago First seen · 956 lines · 10 tokens per session scan A c91049d4c320
karo is an agent published in the GitHub repository yohey-w/multi-agent-shogun (1,424 stars, last pushed 2mo ago), licensed MIT. It adds 10 tokens to every session and 9,934 once invoked, about $0.0000 per session on Opus 5.5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-30.
Other agents, from other repositories
Lawliet
Use this agent when reviewing code for quality, running static analysis, checking security, or verifying adherence to patterns.
Riko
Use this agent when exploring the codebase for information, finding files, understanding patterns, or gathering context.
Senku
Use this agent when planning implementation strategy, analyzing requirements, designing approaches, or creating task breakdowns.
Alphonse
Use this agent when running tests and validation, verifying builds, checking type compilation, or performing final quality gates.
Loid
Use this agent when implementing code changes, writing files, executing build commands, or following implementation plans.
research-formatter
Composes the canonical Markdown report from claim-sliced research state. Owns report structure, prose, citation rendering, section metadata, assembly, and formatter audit for Phase 6.