Multi-Agent

One system, three repos: a six-phase AI development pipeline, the MCP server that drives real devices for it, and the stack skill plugins it dispatches to.

Drives a Jira issue or GitHub URL to a merged PR in one command. It ships as three repos because they release on different clocks: the pipeline changes weekly, the MCP server only when a device capability lands, and each stack plugin only when its own skills move. Installing the pipeline is enough - it pulls the other two. Model routing is off until you arm it: /multi-agent:route-on picks which rung of the fable → opus → sonnet → haiku ladder a call lands on, route-off keeps the rules so re-arming asks nothing, and route-status prints the honest limit rather than hiding it - scope cannot be the whole host session, which is a schema gate rather than a convention, and a rung on another provider is refused at dispatch because no call site sends a model request itself.

ArchitecturePrivate RepositoryThis is a private repository. You need collaborator access to view the source code on GitHub.
6
Phases
65
Commands
229
Skills
10
Sub-agents
197
MCP tools
Stable
Status

Tech Stack

Node.jsClaude CodeCodex CLICopilot CLI229 Skills10 Sub-AgentsJSON Schemas

How It Works

Setup
🔑
Keychain
11 services · servicePatMap per identity
👤
Git Identity
identities[] · servicePatMap ownership
🔍
Repo Discovery
Local + Bitbucket + GitHub 90-day
🗺
Identity Routing
URL glob → identity auto-pick
📋
Stack Detect
iOS · Android · Backend · Frontend
🔒
Pre-commit
Secret scanning
Inputs (5 types)
GitHub Issue#316
GitHub URLgithub.com/.../issues/N
Jira IDPROJ-1234
Jira URLjira.../browse/...
Free Text"Fix dark mode bug"
Launch Modes (8 dispatch variants)
Claude/multi-agent "#316"Copilotmulti-agent "#316"
Normal0→1→2→3→4→5
Claude/multi-agent "PROJ-1234"Copilotmulti-agent "PROJ-1234"
Jira0→1→2→3→4→5
Claude/multi-agent:autopilot "#316"Copilotmulti-agent-autopilot "#316"
autopilot0→1→2→3→4→5
Claude/multi-agent:resumeCopilotmulti-agent resume
resume0→3→4→5
Claude/multi-agent:analysis "PROJ-2001"Copilotmulti-agent-analysis "PROJ-2001"
analysis0→1→3→4→5
ClaudeStep 1b → CorporateCopilotStep 1b → Corporate
analysis · corporate0→1→3→4→5
Helper Commands
setup
Keychain token + Git identity onboarding
jira
Browse your open Jira issues → pick → launch
issue
Browse unassigned GitHub issues → pick → launch
status
List tasks across all projects
log #N
Show task log
resume #N
Pick up a stopped run, or a branch with no run behind it
kill #N
Delete worktree, logs preserved
review
Review only the current diff
refactor
Autonomous refactoring with TDD safety net
channels
Multi-channel reporter — PR · Jira · Confluence · Wiki (multi-select, humanizer, v5.7+ replaces enrich)
test
UI Bug Hunter (simulator/emulator auto-detect)
stack [platform]
Swap platform skills on-the-fly
language [en|tr]
Toggle outputLanguage (assistant explanations). Picker prompts stay English.
scan
Skill security (4-tier · warn-only · CI strict)
search
Log full-text search (smart ranking · ripgrep)
sync
6-target sync (incl. plan-driven figma source pull)
update
Upgrade: git pull + install + migrate
clear-logs
Clean global log directory
purge
Full reset (double confirmation)
help
Usage guide and examples
UI Testing (Standalone)
🧪
test
Full simulator test - screenshot all screens
🌙
test "dark mode"
Dark mode bug test
♿
test "accessibility"
Accessibility audit - labels, tap targets, contrast
🔤
test "dynamic type"
Large text size test
📦
test "store-ready"
Full audit: visual + accessibility + archive compliance
🔐
test "biometric"
Face ID / Touch ID flow test
⚡
test "performance"
Launch time + scroll performance test
Stack Swap
Swap platform skills on-the-fly
stack iosstack androidstack backendstack mobilestack all
Skills (60+)
Pluggable knowledge modules injected into agents
🍎iOS · SwiftUI · UIKit · CoreData
🤖Android · Compose · Hilt · Room
⚙FastAPI · NestJS · Docker · CI/CD
🌐React · Next.js · Tailwind · Vue
✓Clean Code · TDD · Architecture · Security
🔧Git Actions · Figma · ASO · Audit Scripts
Pipeline Phases
0
Init
Multi-select picker
Identity routing
Fetch-fail 4-opt
N worktrees (serial)
Branch collision auto -v2
Step 0 language (en/tr)
1
Analysis
Parallel Explore
Fable model
Codebase scan
2
Planning
Task breakdown
Architecture
User approval
Todo repo tagging
3
Dev
TDD: Red→Green→Refactor
Per-repo worktree switch
Build verify
Max 3 retry
component → figma-to-component skill delegate
4
Review
Deterministic gates BEFORE AI review
Combined diff (repo headers)
crossRepo findings
Claude: Fable + Opus + Sonnet · Copilot: Opus + GPT-5.4 + Sonnet → triage
5
Test
UI Bug Hunter
Dark/Light test
A11y audit
Simulator boot
6
Commit
Per-repo commit + push
Push-must-succeed (5 retries)
Cross-linked sibling PRs
Never auto-closes issues (4 approvals)
7
Report
Step 1: Channels dispatch — PR · Jira · Confluence · Wiki (multi-select, humanizer)
Autopilot ALWAYS pauses — 30-min timeout → session ends (resumable)
Step 2: agent-log · Quality & Metrics · telemetry
Step 3: Knowledge base + memory
Phase 0 - Interactive Init (8 Steps)
PARSE
Parse input, fetch from Jira/GitHub
→
PROJECT
Multi-select picker · recentGroups
→
BRANCH
TTL filter · collision auto -v2/-v3 · fetch-fail 4-opt
→
DESIGN?
Figma URL / screenshot (optional)
→
BRANCH NAME
Shared name · kebab rules · 50-char
→
IDENTITY
platformIdentityRouting · per-repo lookup
→
INSTRUCTION
Auto-detect .instructions/ directory
→
WORKSPACE
Multi-repo: N worktrees · serial · rollback
Sub-Agents (6)
🔍
Code Reviewer
Security, architecture, quality
🗺
Explorer
Codebase scan, patterns, impact areas
🍎
iOS Architect
Design decisions, patterns, modules
🤖
Android Architect
Design decisions, patterns, modules
⚙
Backend Architect
API design, data modeling, architecture
🛡
Security Auditor
Vulnerabilities and compliance
Component Pipeline (Figma → SwiftUI)
Figma URL detect→
Token extraction→
Config + View→
Modifiers→
Code Connect→
3-layer tests→
14-item review
Key Features
⚙ Phase 5 Report (Jira → Wiki+Figma → Confluence → Log → Knowledge)⚙ Skill Security Scanner (tiered · warn-only · CI strict · /multi-agent:scan)⚙ Log Search (smart ranking · filters · ripgrep · /multi-agent:search)⚙ Generic Figma-to-Component (iOS + Android)⚙ 4-Adapter Wiki (submodule / in-repo / github-wiki / separate-repo)⚙ Issue → Jira → Wiki Triad (autopilot-aware)⚙ Corporate Hosts in Setup (Jira / Confluence / Bitbucket inline prompt)⚙ Live Progress-Line Contract (quiet/normal/verbose)⚙ Plan-Driven Upstream Sync (--plan → review → apply)⚙ Overlay Protection (local-overlay: true frontmatter)⚙ Cross-CLI Parity (65 cmds identical across three hosts)⚙ Build queue serialized with lock file⚙ Auto-detects iOS/Python/Node/Docker/Go⚙ Deterministic gates BEFORE AI review⚙ Multi-Repo Orchestration⚙ Platform Identity Routing⚙ Push-Must-Succeed (5 retries)⚙ Fetch-Fail 4-Option Flow⚙ Never auto-closes issues (4 approvals)⚙ PAT Audit Logging (SHA-256)⚙ 49 Smoke Suites (~870 assertions)⚙ Lazy file loading for token efficiency⚙ Pre-commit secret detection hook⚙ Autopilot Phase 2 Safety Classifier (v7.0.G · default-on · score≥50 → pause)⚙ Dynamic Trigger-Based Skill Loading (v7.0.I · 193-entry index · install.js --index-only)⚙ Per-Persona Model Routing (v6.1.D · preferredModel frontmatter · explorer → sonnet)⚙ OpenTelemetry Span Emission (v6.1.C · MULTI_AGENT_OTEL_SPANS=1 · JSONL)⚙ Phase 4 Disagreement Round (v6.1.B · opt-in · mixed-verdict rebuttal pass)⚙ Cost Summary in PR Body (v6.1.J · per-phase tokens + est. USD)⚙ Per-Repo File-System Memory Layer (v6.2.E · .multi-agent/memory/ · opt-in)⚙ Golden-Task Eval Harness (v6.2.F · 2 seed fixtures · wired to npm test)⚙ Skill Manifest Signing + Verify (v6.2.H · 193 SHA-256 · install-time warn-only)
Output
✓
Reviewed PR
Per-repo PRs · cross-linked siblings
📊
Report
Quality & Metrics · token rollup
🧠
Knowledge
Cross-session memory
📦
Components
Config + View + Tests
📁
Logs
~/.claude/logs/multi-agent/{project}/{task-id}/

Deep dive: architecture across three CLIs · install transforms, the six phases, every gate, and the shared state root

multi-agent-toolkit-mcp

Workflow
Editor sends command → MCP translates → ADB/simctl executes → result returns
AI Editors
CClaude Code
◆Copilot CLI
▲Codex CLI
MCP Protocol
MCP Server
Multi-Agent Toolkit MCP
83 tools · npx
ADB / simctl
Devices
iOS Simulatorxcrun simctl
Android Emulatoradb
Tool Categories
Device Control58
📸Screenshot
👆Tap / Swipe
⌨Type Text
▶Launch App
🌙Dark Mode
🌐Change Locale
🔔Push Notification
🔓Grant Permission
Accessibility2
♿A11y Audit
🌳Element Tree
Store Compliance5
✓Store Check
📏Binary Size
🔐Privacy Manifest
Live Replay - watch commands run end-to-end
Mode
Input
claude-code · /multi-agent "PROJ-4821"
▊
Tracker
worktree · every confirmation asked
○0Init
○1Plan
○2Dev
○3Review
○4Commit
○5Report
running... · line 0/36
Simulated replay - actual pipeline emits the same progress-line shape (`→ verb object target`) at immediate flush.

Features

6-Phase Pipeline

Issue → analysis → plan (approval gate) → TDD dev → parallel review + triage → test → commit/PR → report. Every retry loop is bounded (hard-stop at 3).

CLI-Aware Parallel Review + Fable Triage

Three reviewers on every host - only slot 2 differs, Opus on Claude Code and GPT-5.4 elsewhere; triage (Fable on Claude Code, Opus on Copilot CLI) filters false positives. Findings cite stable rule IDs, so a review says SEC-01 instead of a preference. Blocking findings can be confirmed by an auto-written repro test.

Deterministic Safety Gates

Build, lint, test and secret gates run before AI review, and a 'passed' claim needs a log behind it. The applicable rule IDs are written to disk first, so "was this applied completely" has a fixed denominator.

Two Analysis Standards

The analysis command asks which standard the document follows: a development handoff, or a requirements document with an IG → UC → FG spine and three traceability matrices. Both read the same evidence, so they cannot drift apart.

Device Control Over MCP

The toolkit server gives the pipeline eyes and hands on a running app: tap, swipe and type on iOS Simulator and Android Emulator, read the accessibility tree, diff screenshots, pull crash logs, audit an archive before submission.

Stack Skills as Versioned Plugins

Engineering knowledge ships as marketplace plugins rather than inside the pipeline, enabled per repo. Their knowledge layer is generated from one authoring source and version-bumped only when a skill set changes.

Multi-Repo Orchestration

Per-repo worktrees, platform identity routing, and file-based state so tasks resume across sessions. A task worktree removes itself once its PR is open, keeping the branch without checking it out, so your own working copy is never disturbed.

Cost, Telemetry and Memory

Per-phase token ledger, a cost breakdown naming the top driver, budget ceilings, and a model fallback contract. A learnings ledger keeps rejected review preferences from being re-flagged.

Available Tools

ToolDescription
ios (42)

iOS Simulator control: boot, install, tap, swipe, type, screenshot, accessibility audit, crash logs, leaks, xcodebuild and xcresult, App Store and TestFlight validation.

web (35)

A real browser page: navigate, click, type, read, evaluate, screenshot, an accessibility snapshot whose refs the other tools accept, console and network capture with request detail, plus one-shot scraping with a shared cache and change tracking, sitemap-aware crawling with llms.txt, request mocking, offline mode, the clock and ARIA snapshot assertions.

android (33)

Android emulator and device control over adb: install, launch, input, UI tree, logcat, meminfo, locale and font scale, APK audit, screen recording.

store (30)

App Store Connect and Google Play Console from one family: apps, builds, reviews and replies, subscription prices per country, vitals, purchase checks and a bundle dry run, plus search, schema and call over every other store operation. Writes return a preview until confirmed, and keys stay in the Keychain.

vphone (10)

Virtual iPhones through the vphone-launchpad CLI you install: host readiness, machine list, start and stop of existing machines, screenshot, tap, swipe, key, accessibility tree and an allowlist of read-only guest calls. Destructive methods are refused.

code (8)

Language-server intelligence over a checkout: definitions, references, hover, diagnostics, workspace and document symbols, without loading files into context.

design (7)

Mock-mode versus Figma: launch the app in mock state, enumerate the variants, compare pixels, spacing, typography and colour, and report what differs.

repo (6)

Read-only access to the product's other repositories at their latest integration branch: resolve to a pinned sha, grep, read, list, log, and look up join keys across up to twenty repos at once, with file text fenced as untrusted and tokens sent only to the hosts setup bound them to.

voice (6)

A local voice host over a Unix socket: speak, ask and hear the answer, stop, act and answer permission prompts by voice. The socket must be the user's own, and speech text is never logged.

context (4)

The same offloaded file, also indexed: SQLite FTS5 ranks passages with bm25 and answers in about 50-100 tokens which part is about what, instead of grepping for which lines contain a string. Long text can also be paged into images, with the measured token trade-off.

pass (4)

Apple Wallet passes: build, sign, inspect and validate, with the signing passphrase resolved from the credential store rather than an argument.

agent (2)

Offloaded output: a large tool result is written to a file and queried, so the transcript never carries it.

document (2)

Synthetic passport, residence permit and visa fixtures for MRZ scan tests: ICAO 9303 lines with correct check digits, rendered on a plain canvas with a permanent TEST SPECIMEN label and nothing that imitates a real document.

llm (2)

Simple text work handed to free-tier models instead of Claude: summaries, extraction against a JSON Schema, labels, translation and drafts, over Groq, Mistral, Gemini, OpenRouter free models, Z.AI and a local Ollama. Every answer is checked against its source before it is returned, and when none passes the caller does the task itself.

research (2)

Provider-backed search (Brave, Perplexity, arXiv) and cited answers with quick, pro, reasoning and deep modes, recency and academic filters and follow-up threads. Keys are read from the environment at call time and go into a header; a literal key is not an accepted argument.

security (2)

Offline security arithmetic: a CVSS 3.1 base score and band computed from the vector, and a lockfile parsed into an ecosystem, name and version inventory. Neither tool reaches the network; a CVE lookup is a separate step.

media (1)

Key frames out of a screen recording, near-duplicates dropped, so a video the toolkit just made becomes something a model can look at.

ui (1)

Resolves a locator by id, role, label or text on iOS, Android or the web and says whether it matched exactly one element, none or several, without acting on it.

Available Commands

Claude Code (colon-form)Copilot CLI (dash-form)Description
Development
/multi-agent "task"multi-agent "task"

Full six-phase pipeline with worktree + interactive confirmations.

/multi-agent:autopilot "task"multi-agent-autopilot "task"

Same phases, no confirmations: defaults are resolved and logged, it works in a separate checkout, and the claim gates run. Review blockers and the build cap still stop it.

/multi-agent:scaffold <stack> <name>multi-agent-scaffold <stack> <name>

A new iOS, Android, web or backend project from the enabled toolkit's scaffold skill, proven to build, test and lint before its first commit. No remote is created.

/multi-agent:jiramulti-agent-jira

Browse your open Jira issues in a terminal picker and launch.

/multi-agent:issuemulti-agent-issue

Browse unassigned GitHub issues, auto-assign, and launch.

Analysis
/multi-agent:analysis "feature"multi-agent-analysis "feature"

A document, not code: Init → Analysis → Synthesis → Review → Publish → Report.

/multi-agent:research <id>multi-agent-research <id>

Research an item's open gaps from the tracker, linked docs and the repo before anyone is asked; a script decides which gaps closed.

Continuous
/multi-agent:autopilot-onmulti-agent-autopilot-on

Pick the repos this machine watches; labelled issues then run unattended in a worktree and end at a draft PR a person reviews and merges.

/multi-agent:autopilot-statusmulti-agent-autopilot-status

What runs at which phase, what is queued, what waits for an answer, and the PRs opened today.

/multi-agent:autopilot-off [--now]multi-agent-autopilot-off [--now]

Remove the schedule; running work finishes and the repo selection is kept. --now also stops the current item.

Shared
/multi-agent:reviewmulti-agent-review

Standalone parallel review on a branch diff or PR, with triage.

/multi-agent:complaint-analysis [--file path]multi-agent-complaint-analysis [--file path]

Customer-complaint triage: log evidence per transaction id + read-only repo correlation, then a client/bff root cause with a fix plan and dev prompt, or a routing recommendation to the service owner.

/multi-agent:resume [#id]multi-agent-resume [#id]

Resume a paused/failed task from its last completed phase (file-based state).

/multi-agent:kill [#id]multi-agent-kill [#id]

Delete a task's worktree + branch; logs are preserved.

/multi-agent:prune-logsmulti-agent-prune-logs

Delete per-task logs (audit + metrics kept). Dry-run first.

/multi-agent:garbage-collectmulti-agent-garbage-collect

Sweep leftover /tmp scratch + worktree residue. Dry-run first.

/multi-agent:purgemulti-agent-purge

Full reset - every worktree, branch, state file and log. Double confirmation.

/multi-agent:setupmulti-agent-setup

First-run wizard - tokens, Git identity, per-project routing.

/multi-agent:helpmulti-agent-help

Bilingual usage guide - 65 live commands, the questions Phase 0 asks, preferences.