rolepod

Rolepod

Rolepod turns Claude Code, Codex CLI, Gemini CLI, and Cursor IDE into a disciplined software-house team — a workflow router, 18 specialist agents, and gates that catch bugs before they reach a commit.

It is one source of truth rendered into a native plugin for each CLI. No CLI is the "default" — all four are first-class. Rolepod carries zero project-specific configuration, so it works in any repository from the first session.

What it helps with

• Vague ideas → sharp specs. A half-stated feature request becomes an agreed spec before any code is written.
• Multi-file work → a real plan. Tasks, agent ownership, and a cohesion contract so parallel work doesn't collide.
• Test-first builds. RED → GREEN discipline instead of tests bolted on afterward.
• Bugs caught at commit time. Scope creep, single-use abstractions, weak assertions, and missing tests are flagged before they land — not in review.
• The right specialist on the job. Frontend, security, performance, billing, docs — domain work routes to a specialist agent instead of one generalist guessing.

How it works

Rolepod starts the moment you give your CLI a task — you don't run a command or pick a mode. A router skill reads the request and places it in the workflow: a one-line typo fix goes straight to the edit; a vague "build me X" gets pulled back into a spec conversation first.

Every real change then moves through six phases:

Define → Plan → Build → Verify → Review → Ship

Each phase has one skill that runs it, and each skill pulls in specialist agents when the work needs depth. Before any commit, gates fire automatically — simplicity, tests, failure-mode — as soft reminders on ordinary code and hard blocks on high-risk paths like auth, billing, and migrations.

You invoke nothing for this; it just happens. For a deliberate run through every phase with no skips, invoke /rolepod-full.

The workflow

1. Define — write-spec. Turns a fuzzy request into a spec, shown back in chunks short enough to actually read and approve.
2. Plan — write-plan. Breaks the spec into tasks, assigns agent ownership, writes a cohesion contract before any parallel work.
3. Build — implement-plan. Executes the plan test-first with bounded delegation. Bug fixes take the debug-issue path: reproduce → failing test → minimal fix.
4. Verify — check-work. Proves the change with evidence — tests, build, curl, a screenshot — never just a "done".
5. Review — review-code. Multi-axis review, with adversarial pressure on high-risk diffs.
6. Ship — finish-work. Pre-merge gate, CI lanes, and a 4-option finish menu.

Two skills run across phases: simplify-code (behavior-preserving cleanup) and manage-context (recovery when a session is long, stuck, or in an unfamiliar repo).

Install

Pick your CLI. Rolepod installs only itself — agents, skills, hooks, manifests. No third-party tools are installed for you.

Claude Code

# Install
claude plugin marketplace add nuttaruj/rolepod
claude plugin install rolepod@rolepod

# Update
claude plugin marketplace update rolepod
claude plugin update rolepod@rolepod

# Uninstall
curl -fsSL https://raw.githubusercontent.com/nuttaruj/rolepod/main/bootstrap.sh | bash -s -- --uninstall --target=claude

Codex CLI

# Install — the plugin carries skills + hooks; the 18 agents need the installer
codex plugin marketplace add nuttaruj/rolepod
codex plugin install rolepod@rolepod
curl -fsSL https://raw.githubusercontent.com/nuttaruj/rolepod/main/bootstrap.sh | bash -s -- --target=codex

# Update
codex plugin marketplace upgrade rolepod
codex plugin remove rolepod@rolepod && codex plugin add rolepod@rolepod

# Uninstall
curl -fsSL https://raw.githubusercontent.com/nuttaruj/rolepod/main/bootstrap.sh | bash -s -- --uninstall --target=codex

Codex hooks are registered but inert until you opt in — run codex features enable plugin_hooks. Agents, skills, and the AGENTS.md gate rules work without it.

Gemini CLI

# Install
curl -fsSL https://raw.githubusercontent.com/nuttaruj/rolepod/main/bootstrap.sh | bash -s -- --target=gemini

# Update — re-run with --force
curl -fsSL https://raw.githubusercontent.com/nuttaruj/rolepod/main/bootstrap.sh | bash -s -- --target=gemini --force

# Uninstall
curl -fsSL https://raw.githubusercontent.com/nuttaruj/rolepod/main/bootstrap.sh | bash -s -- --uninstall --target=gemini

Cursor IDE

Recommended — native team marketplace (no terminal, no ~/.cursor/plugins/local/ clutter). Cursor reads the committed .cursor-plugin/marketplace.json at the repo root and lists rolepod in the IDE plugin panel for one-click install / update / uninstall:

1. Open Cursor → Settings → Plugins → Add team marketplace
2. Paste https://github.com/nuttaruj/rolepod
3. Click Install on the rolepod entry