flywheel-plugin-marketplace

Flywheel Plugin for Claude Code

Multi-provider AI orchestration plugin — Let Claude orchestrate specialized agents (Codex, Gemini, Claude teammates) across structured workflows

---

What is Flywheel?

Flywheel transforms Claude into an orchestrator that spawns specialized AI agents for different tasks. Instead of Claude doing everything alone, it delegates specific work to expert agents and synthesizes their outputs.

Think of it as: Claude is the project manager, sub-agents are the specialists.

flowchart LR
    You["👤 You"] -->|"/fw:implement build auth"| Claude["🔵 Claude\nOrchestrator"]

    subgraph TeamMode["🤝 Team Mode (parallel)"]
        Researcher["🔵 researcher\nfw-researcher"]
        Architect["🔵 architect\nfw-architect"]
    end

    subgraph SeqMode["⬇️ Sequential Mode (fallback)"]
        Gemini["🟡 Gemini\nEcosystem Research"]
        Codex["🔴 Codex\nArchitect + Builder"]
    end

    Claude -->|"AGENT_TEAMS=1"| TeamMode
    Claude -->|"AGENT_TEAMS=0"| SeqMode
    TeamMode -->|"findings"| Claude
    SeqMode -->|"findings"| Claude
    Claude -->|"synthesized result"| You

    style Claude fill:#4A90E2,stroke:#2E5C8A,stroke-width:3px,color:#fff
    style Codex fill:#E24A4A,stroke:#8A2E2E,stroke-width:2px,color:#fff
    style Gemini fill:#E2B44A,stroke:#8A6E2E,stroke-width:2px,color:#fff
    style Researcher fill:#4A90E2,stroke:#2E5C8A,stroke-width:2px,color:#fff
    style Architect fill:#4A90E2,stroke:#2E5C8A,stroke-width:2px,color:#fff

---

🚀 Setup

# 1. Add this repository as a plugin marketplace
claude plugin marketplace add gmedali/flywheel-plugin

# 2. Install the plugin
claude plugin install fw

once you run claude, please run:

/fw:setup

/fw:setup will detect your providers, install personas, and optionally configure agent teams for parallel workflows. All /fw: commands are ready to use immediately.

---

🎭 Personas

Flywheel ships 10 native Claude Code sub-agents — persistent specialists that each /fw: command activates. They run in isolated context windows with curated tool access and model routing, replacing ad-hoc prompt strings with real behavioural mandates.

Persona	Model	Used by	Role
fw-architect	opus	/fw:design, /fw:implement	Commits to one approach, produces ADRs, file impact maps, risk registers
fw-researcher	sonnet	Research phases	Filters external knowledge through your existing stack, rates every option
fw-debugger	sonnet	/fw:debug	Forensic root-cause analysis — mandatory causal chain, no guesses
fw-security-auditor	opus	/fw:harden	Offensive OWASP scanner — every finding has attack scenario + patch
fw-code-reviewer	sonnet	/fw:review	Blocking vs advisory classification — every finding has file:line + fix
fw-tdd-specialist	sonnet	/fw:tdd	Red→Green→Refactor enforcer — refuses implementation without failing test
fw-test-generator	sonnet	/fw:test	P0→P3 risk-prioritised coverage — learns your conventions before writing
fw-migration-engineer	sonnet	/fw:migrate	Batched migrations with mandatory rollback plans and validation gates
fw-fe-designer	sonnet	/fw:fe-design	Distinctive, production-grade frontend interfaces — zero generic AI aesthetics
fw-reflector	sonnet	/fw:reflect	Multi-dimensional quality synthesis — balances strengths with concerns, severity-sorted narrative reports

Installation: /fw:setup runs scripts/install-personas.sh to copy all personas to ~/.claude/agents/. Upgrade anytime:

"${CLAUDE_PLUGIN_ROOT}/scripts/install-personas.sh" --force

---

🤝 Agent Teams (v1.1.0)

Flywheel v1.1.0 adds native Claude-to-Claude parallel execution via the CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS feature flag. When enabled, complex commands spawn specialist teammates that work in parallel instead of sequentially.

Commands that gain parallel teammates:

Command	Template	Parallel Phases	Teammates
/fw:implement	research-and-plan	1a+1b, 7+8	researcher, architect, test-writer
/fw:design	research-and-plan	1+2	researcher, architect
/fw:review	parallel-review	All analysis (critical level)	security, quality, test reviewers
/fw:reflect	parallel-analysis	Phase 2 aspects	1 per aspect (up to 4)
/fw:harden	parallel-scan	Phase 1 scans	owasp, dependency, secrets scanners
/fw:migrate	parallel-migration-research	Phase 1b	framework-researcher, codebase-analyzer