{"id":50253606,"url":"https://github.com/nuttaruj/rolepod","last_synced_at":"2026-05-27T03:14:30.335Z","repository":{"id":356858312,"uuid":"1234356095","full_name":"nuttaruj/rolepod","owner":"nuttaruj","description":"Universal AI dev team workflow system for Claude Code — 18 specialist agents, lazy-load rules, parallel-safe by path/concern ownership","archived":false,"fork":false,"pushed_at":"2026-05-24T12:28:56.000Z","size":1540,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2026-05-24T14:22:45.293Z","etag":null,"topics":["agent-orchestration","ai-agents","automation","claude-code","prompt-engineering","workflow"],"latest_commit_sha":null,"homepage":null,"language":"Shell","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/nuttaruj.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":"AGENTS.md","dco":null,"cla":null}},"created_at":"2026-05-10T04:31:48.000Z","updated_at":"2026-05-24T12:29:00.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/nuttaruj/rolepod","commit_stats":null,"previous_names":["nuttaruj/rolepod"],"tags_count":3,"template":false,"template_full_name":null,"purl":"pkg:github/nuttaruj/rolepod","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nuttaruj%2Frolepod","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nuttaruj%2Frolepod/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nuttaruj%2Frolepod/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nuttaruj%2Frolepod/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/nuttaruj","download_url":"https://codeload.github.com/nuttaruj/rolepod/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nuttaruj%2Frolepod/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":33548842,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-05-27T02:00:06.184Z","response_time":53,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["agent-orchestration","ai-agents","automation","claude-code","prompt-engineering","workflow"],"created_at":"2026-05-27T03:14:29.354Z","updated_at":"2026-05-27T03:14:30.321Z","avatar_url":"https://github.com/nuttaruj.png","language":"Shell","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Rolepod\n\n**Rolepod turns Claude Code, Codex CLI, Gemini CLI, and Cursor IDE into a disciplined software-house team — a workflow router, 16 specialist agents, and gates that catch bugs before they reach a commit.**\n\nIt 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.\n\n## What it helps with\n\n- **Vague ideas → sharp specs.** A half-stated feature request becomes an agreed spec before any code is written.\n- **Multi-file work → a real plan.** Tasks, agent ownership, and a cohesion contract so parallel work doesn't collide.\n- **Test-first builds.** RED → GREEN discipline instead of tests bolted on afterward.\n- **Bugs caught at commit time.** Scope creep, single-use abstractions, weak assertions, and missing tests are flagged before they land — not in review.\n- **The right specialist on the job.** Frontend, security, performance, billing, docs — domain work routes to a specialist agent instead of one generalist guessing.\n\n## How it works\n\nRolepod 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.\n\nEvery real change then moves through six phases:\n\n```\nDefine → Plan → Build → Verify → Review → Ship\n```\n\nEach 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.\n\nYou invoke nothing for this; it just happens. For a deliberate run through every phase with no skips, invoke **`/rolepod-full`**.\n\n## The workflow\n\n1. **Define — `write-spec`.** Turns a fuzzy request into a spec, shown back in chunks short enough to actually read and approve.\n2. **Plan — `write-plan`.** Breaks the spec into tasks, assigns agent ownership, writes a cohesion contract before any parallel work.\n3. **Build — `implement-plan`.** Executes the plan test-first with bounded delegation. Bug fixes take the `debug-issue` path: reproduce → failing test → minimal fix.\n4. **Verify — `check-work`.** Proves the change with evidence — tests, build, curl, a screenshot — never just a \"done\".\n5. **Review — `review-code`.** Multi-axis review, with adversarial pressure on high-risk diffs.\n6. **Ship — `finish-work`.** Pre-merge gate, CI lanes, and a 4-option finish menu.\n\nTwo skills run across phases: **`simplify-code`** (behavior-preserving cleanup) and **`manage-context`** (recovery when a session is long, stuck, or in an unfamiliar repo).\n\n## Install\n\nPick your CLI. Rolepod installs **only itself** — agents, skills, hooks, manifests. No third-party tools are installed for you.\n\n### Claude Code\n\n```bash\n# Install\nclaude plugin marketplace add nuttaruj/rolepod\nclaude plugin install rolepod@rolepod\n\n# Update\nclaude plugin marketplace update rolepod\nclaude plugin update rolepod@rolepod\n\n# Uninstall\ncurl -fsSL https://raw.githubusercontent.com/nuttaruj/rolepod/main/bootstrap.sh | bash -s -- --uninstall --target=claude\n```\n\n### Codex CLI\n\n```bash\n# Install — the plugin carries skills + hooks; the 18 agents need the installer\ncodex plugin marketplace add nuttaruj/rolepod\ncodex plugin install rolepod@rolepod\ncurl -fsSL https://raw.githubusercontent.com/nuttaruj/rolepod/main/bootstrap.sh | bash -s -- --target=codex\n\n# Update\ncodex plugin marketplace upgrade rolepod\ncodex plugin remove rolepod@rolepod \u0026\u0026 codex plugin add rolepod@rolepod\n\n# Uninstall\ncurl -fsSL https://raw.githubusercontent.com/nuttaruj/rolepod/main/bootstrap.sh | bash -s -- --uninstall --target=codex\n```\n\nCodex 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.\n\n### Gemini CLI\n\n```bash\n# Install\ncurl -fsSL https://raw.githubusercontent.com/nuttaruj/rolepod/main/bootstrap.sh | bash -s -- --target=gemini\n\n# Update — re-run with --force\ncurl -fsSL https://raw.githubusercontent.com/nuttaruj/rolepod/main/bootstrap.sh | bash -s -- --target=gemini --force\n\n# Uninstall\ncurl -fsSL https://raw.githubusercontent.com/nuttaruj/rolepod/main/bootstrap.sh | bash -s -- --uninstall --target=gemini\n```\n\n### Cursor IDE\n\n**Install via `bootstrap.sh`** — copies the plugin tree to `~/.cursor/plugins/local/rolepod/`:\n\n```bash\n# Install\ncurl -fsSL https://raw.githubusercontent.com/nuttaruj/rolepod/main/bootstrap.sh | bash -s -- --target=cursor\n\n# Update — re-run with --force\ncurl -fsSL https://raw.githubusercontent.com/nuttaruj/rolepod/main/bootstrap.sh | bash -s -- --target=cursor --force\n\n# Uninstall\ncurl -fsSL https://raw.githubusercontent.com/nuttaruj/rolepod/main/bootstrap.sh | bash -s -- --uninstall --target=cursor\n```\n\nRestart Cursor (or reload the window) so the plugin registers. Verify under **Cursor → Settings → Plugins**.\n\nThe always-on judgment core ships as an `alwaysApply: true` rule (`rules/always-on-core.mdc`) — loaded automatically on every Cursor session. Disabling **Settings → Features → Rules** suppresses it.\n\n\u003e **Teams / Enterprise plans** can alternatively add `https://github.com/nuttaruj/rolepod` as a team marketplace under Settings → Plugins for one-click install. Team Marketplaces are not available on Free / Pro plans.\n\n**Install all four at once** with `--target=all`. **One repo only, no global config:** add `--scope=project`. Restart the CLI after installing. Full per-CLI matrix and install scopes: [docs/cli-support.md](docs/cli-support.md).\n\n## What's inside\n\n- **16 specialist agents** — strategy, architecture, engineering, quality, ops, design, content, and review. Each owns a path or concern and runs on a cost-tiered model (~50-60% cheaper than all-strong). → [docs/agents.md](docs/agents.md), [docs/model-tier-policy.md](docs/model-tier-policy.md)\n- **Core 10 skills** — one router plus nine phase skills, the workflow spine. → [docs/skills.md](docs/skills.md)\n- **Per-CLI hooks** — deterministic enforcement: gate reminders, a pre-commit test gate, a sub-agent commit block, session safety. Counts vary by CLI capability (Claude 7 / Codex 3 / Gemini 4 / Cursor 3). → [docs/hooks.md](docs/hooks.md)\n- **Active gates** — Q1-Q4 delegation, S1-S5 simplicity, T1-T6 tests, F1-F5 failure-mode — checked before every commit.\n\nThe source lives in `core/`; per-CLI adapters render it into a native plugin for each CLI.\n\n## Recommended add-ons\n\nRolepod ships pure framework. These optional tools pair well — install any of them yourself and rolepod auto-integrates; nothing breaks and nothing nags if they are absent.\n\n| Add-on | What it adds | Fallback without it |\n|--------|--------------|---------------------|\n| [CodeGraph](https://www.npmjs.com/package/codegraph) · [GitNexus](https://github.com/abhigyanpatwari/GitNexus) | Sub-millisecond symbol / caller / impact queries | `rg` + `find` text search |\n| [MemPalace](https://github.com/mempalace/mempalace) | Cross-session knowledge graph of past decisions | Built-in per-project memory |\n| [rtk](https://github.com/rtk-ai/rtk) · [caveman](https://github.com/JuliusBrussee/caveman) | Token cuts on routine commands and replies | Normal output |\n| [ui-ux-pro-max](https://github.com/nextlevelbuilder/ui-ux-pro-max-skill) | Design recipes for the `ui-ux-designer` agent | Bundled design skills |\n| [rolepod-uiproof](https://github.com/nuttaruj/rolepod-uiproof) — sibling plugin | Multi-platform UI / mobile MCP — adds `/verify-ui`, `/audit-a11y`, `/visual-diff`, `/scaffold-e2e` (web + iOS + Android). `check-work` and `debug-issue` use it automatically when present. | [Playwright MCP](https://github.com/microsoft/playwright-mcp) / [Chrome DevTools MCP](https://github.com/ChromeDevTools/chrome-devtools-mcp) (web only), or manual verification |\n\n## Docs\n\n- [CHEATSHEET.md](CHEATSHEET.md) — one-page quick reference\n- [docs/cli-support.md](docs/cli-support.md) — per-CLI capabilities, install scopes, runtime status\n- [docs/skills.md](docs/skills.md) · [docs/agents.md](docs/agents.md) · [docs/hooks.md](docs/hooks.md) — workflow reference\n- [docs/model-tier-policy.md](docs/model-tier-policy.md) — per-agent model assignments\n\n---\n\nMIT licensed — see [LICENSE](LICENSE). Personal workflow system — fork freely; runtime reports for Codex and Gemini are especially welcome via [issues](https://github.com/nuttaruj/rolepod/issues).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnuttaruj%2Frolepod","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fnuttaruj%2Frolepod","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnuttaruj%2Frolepod/lists"}