claudeers.
// Claude Plugins

subagent-studio

Claude Code plugins for running lean, single-purpose subagents: plan, build, two review passes

// Claude Plugins[ api ][ web ][ claude ]#claude#plugins◷ MIT$open-sourceupdated about 1 month ago
Actively maintained
92/100
last commit about 1 month ago
last release none
releases 0
open issues 1
// star history

Install with your AI

Paste into Claude Code, Cursor, or any agent — it reads the repo and wires the tool into your project.

Install and set up subagent-studio (claude-plugin project) into my current project.
Found on https://claudeers.com/subagent-studio
Repo: https://github.com/priyanshujha/subagent-studio
Homepage/docs: —
Detected install method: claude-plugin → /plugin install subagent-studio@priyanshujha/subagent-studio
Category: plugins. Platforms: api, web.
Read the repo's README for exact setup and env vars, then install it and wire it into my project.

Claudeers Health Verdict:
active; community-verified: false. Confirm the source before running anything.
// or install directly (claude-plugin)
/plugin marketplace add priyanshujha/subagent-studio
/plugin install subagent-studio@priyanshujha/subagent-studio
// or clone
git clone https://github.com/priyanshujha/subagent-studio

// compatibility

Platformsapi, web
Operating systems—
AI compatibilityclaude
LicenseMIT
Pricingopen-source
LanguagePython

Get your FREE $2.50 API credits to access TickAtlas financial data ↗

subagent-studio

A set of Claude Code plugins that turn one session into an orchestrator running lean, single-purpose subagents: plan first, build in a worktree, two review passes, enforced landing. Pulled out of a real project that ran mostly on scheduled Claude Code sessions for about five weeks.

How a change gets made: a coordinator session, a planner, builders, two review passes and a guarded landing, with a Haiku searcher for lookups

When to use it

Use it on medium-sized and larger codebases where changes are complex: several files per change, real users, code you will keep for years, or scheduled runs that change things while nobody watches. That is where an independent review keeps paying. In the original project the fresh final reviewer still found a blocker or major bug in about one change in three, after the first review pass had already run.

How often the final review found a serious bug, by change size: 9% under 50 lines, 33% at 50 to 199, 35% at 200 to 799, 38% at 800 and more

Skip it for small, well-specified work. A single Claude Code session handles a small script or a precisely described feature in a small codebase well, at a fraction of the cost. The kit adds a planner, builders, step checks and two reviewers per change, which is several times the tokens of one session doing the same work. On a tiny change that rarely buys anything (9% in the chart above); on a real-sized one it buys a second pair of eyes that catches what the first missed.

The six ideas

1. One agent type per role. A builder, a reviewer, a planner and a searcher are separate agent files. Each one fixes its model, its effort level and a short tool list in its frontmatter. A reviewer gets no Edit or Write, a searcher gets four read tools. A lean type starts with a fraction of a general-purpose agent's context, and the role cannot drift into another role's job.

2. The orchestrator never touches code. The main session picks the work, writes briefs, reads short reports, decides and runs the git commands for branches and landings. It never edits code, runs a test suite or reads a diff: it reads git diff --stat. Its context is re-read on every request, so keeping it small is the cheapest saving there is.

3. Plan first for big work. A new module, a big feature or anything hard to reverse starts with a read-only planner that returns a plan in a fixed shape. The session saves it to plans/<slug>.md and commits it before any builder starts. Work that is hard to reverse, or both complex and critical, goes to planner-max; every other plan goes to planner. Each plan step then goes to its own fresh builder.

4. Two review passes, then an enforced landing. Every change to a reviewed path lives on a review branch in its own worktree. Pass one is the author's checklist, run by a fresh reviewer-pass-one. Pass two is a fresh reviewer that did not write the change, reading fixed BASE..HEAD commits. Blockers and majors get fixed, each with a test, and the branch lands by a --no-ff merge carrying Reviewed-by: and Fixed-after-review: trailers. A guard script refuses a push to main that carries unreviewed work. An optional hook runs that guard automatically, and an audit walks main's history to find any landing that slipped past.

5. Cheap models read and never judge. Haiku agents look things up in the repo and read web pages for research. They never build, review, plan or decide a finding, and the figures they bring back are re-checked by a stronger model before a conclusion rests on them.

6. Context is a budget. CLAUDE.md, the state file, the task index, each skill and each agent file have a byte budget. When a file grows past it, text moves out word for word behind a stub. It is never deleted, and a script proves that nothing was lost in the move.

Quickstart (plugins)

/plugin marketplace add priyanshujha/subagent-studio
/plugin install studio-core@subagent-studio
/studio-core:studio-init

studio-init detects your check commands, proposes the reviewed paths, asks about review passes, landing and the push hook, writes .claude/studio.json and adds a short block to CLAUDE.md.

Then give it a first task:

Plan and build X with studio-core:plan-then-build

Add the other plugins the same way (studio-context@subagent-studio, studio-unattended@subagent-studio, studio-research@subagent-studio).

Quickstart (copy-in)

For a Claude Code build without plugin support, or if you would rather keep everything in your repo:

git clone https://github.com/priyanshujha/subagent-studio && cd subagent-studio
./install.sh --modules core --target /path/to/project

install.sh copies agents and skills into .claude/, scripts into scripts/studio/ and hooks into .claude/settings.json (merged, never overwritten). It rewrites the namespaced names (studio-core:builder becomes builder). Options: --modules core[,context,unattended,research], --dry-run, --force, --uninstall. Then run the studio-init skill in the project.

The modules

PluginWhat it addsDepends onConfig section
studio-coreagents builder, builder-sonnet, reviewer, reviewer-pass-one, planner, planner-max, searcher; skills plan-then-build, self-review, orchestrator-rules, studio-init, effort-low/medium/high/xhigh; scripts review_guard.sh, review_path.py, worktree_sweep.sh; an optional push hooknothingcore, roles
studio-contextskill context-budget; scripts context_budget.py, check_moved_text.py, token_usage.py, effort_check.py, my_context.pynothingcontext
studio-unattendedskills wake-up, task-queue, journal, usage-guard, notify; scripts wake_lock.sh, notify.sh; a permission gate and a prompt alarm hookstudio-coreunattended
studio-researchagents research-lead, gatherer, gatherer-browser; skill research-runstudio-coreresearch

Every key is optional and has a default. The schema is config/studio.schema.json, an example is config/studio.example.json, and each module page under docs/modules/ lists its keys.

What a run looks like

Say the task is "add CSV export". The session (with studio-core installed) does this:

1. Agent { subagent_type: "studio-core:planner", description: "Plan T-12",
           prompt: <task, constraints, files to read, the plan shape> }
   -> saves plans/t-12-csv-export.md, commits and pushes it

2. git worktree add -b review/2026-10-13-t-12-csv ../project-review/t-12-csv origin/main

3. Agent { subagent_type: "studio-core:builder", description: "Build T-12 step 1",
           prompt: <step 1 verbatim, goal, worktree path, ci_commands> }
   Agent { subagent_type: "studio-core:reviewer", description: "Check T-12 step 1",
           prompt: <acceptance line, builder report, the five checks> }
   ... one fresh builder and one fresh check per step

4. commit by path, push the branch, write down BASE and HEAD

5. Agent { subagent_type: "studio-core:reviewer-pass-one", description: "Pass one T-12",
           prompt: <branch, BASE..HEAD, paths, the author's checklist> }
   -> a fresh builder fixes what it found; new HEAD

6. Agent { subagent_type: "studio-core:reviewer", description: "Review T-12 before main",
           prompt: <reviewer-prompt.md, every placeholder filled> }
   -> a fresh builder fixes blockers and majors, each with a test; tip FIX

7. git merge --no-ff from a detached origin/main in the worktree, push HEAD:main,
   remove the worktree, delete the branch on both sides

The landing commit message ends with:

Reviewed-by: fresh reviewer agent, 3f1c2a9..8be04d1, 1 round (0 blocker, 1 major, 2 minor; 2 fixed, 1 queued)
Fixed-after-review: author, 8be04d1..c47e9f0, 2 fixes (major: empty file gave a header-only CSV; minor: column order)

review_guard.sh audit reads those two ranges and checks that the merge brought in exactly what they cover. When roles.<role> in the config sets a model or an effort level, the session passes it on that role's Agent call. examples/ builds a toy repo with one such landing that you can audit offline.

Details

It costs more agent calls per change. A small change takes a builder, a pass-one reviewer and a fresh reviewer; a planned one adds a planner and a check per step. Set core.review.reviewed_paths so that scratch directories and throwaway scripts are not reviewed paths.

Solo landing or pull requests. The default, core.review.land: merge-no-ff, has the session land reviewed work on main itself, which suits one person running Claude Code. Teams that want a human to merge set core.review.land: pr: the session opens a pull request whose body carries the same trailers, and the pull request must be merged with a merge commit that keeps them, so the audit still works.

Claude Code version. The plugin install needs a Claude Code build with plugin and marketplace support; older builds can use install.sh. Passing model and effort per Agent call, which the skills do when roles sets them, needs a recent build (v2.1.292 or later). On older builds leave roles empty and each agent file's frontmatter decides.

Results from the original project

One project, one month of scheduled runs, measured from its own session transcripts and git history. Read docs/evidence.md for the caveats before quoting any of it.

The same plan-build-review loop got about 5x cheaper per finished task once each role ran on the right model and effort, with a lean context:

Cost of one finished task by period, from $30 and $33 down to $6.90, with the model and effort of the lead, the builders and the reviewers in each period

Cost of one run by role, mid-September against now: builders $26.44 to $5.68, lead $16.20 to $5.08, reviewers $7.19 to $3.94, specialists $6.32 to $3.61, planners $2.73 to $0.79Cheaper did not mean sloppier: as cost per task fell from $29 to $7.09, serious problems per change found by the final reviewer fell from 0.64 to 0.27, and clean changes rose from 57% to 77%Skills keep about 10 million tokens out of every run's context, saving at least $503 in a month at the cheapest token price
Every role got cheaper. The whole run fell from $58.90 to $19.10.Quality held. The final reviewer found fewer serious problems as cost fell; 0 merges reverted.Skills load on demand. About 6 of 31 per run, the rest stay out of context.

Documentation

License

MIT. See LICENSE.

// faq

What is subagent-studio?

Claude Code plugins for running lean, single-purpose subagents: plan, build, two review passes. It is open-source on GitHub.

Is subagent-studio free to use?

subagent-studio is open-source under the MIT license, so it is free to use.

What category does subagent-studio belong to?

subagent-studio is listed under plugins in the Claudeers registry of Claude-compatible tools.

22 views
★ 33 stars
unclaimed
updated about 1 month ago

// embed badge

subagent-studio on Claudeers
[![Claudeers](https://claudeers.com/api/badge/subagent-studio.svg)](https://claudeers.com/subagent-studio)

// retro hit counter

subagent-studio hit counter
[![Hits](https://claudeers.com/api/counter/subagent-studio.svg)](https://claudeers.com/subagent-studio)

// reviews

// guestbook

0/500

// related in Claude Plugins

🔓

A single CLAUDE.md file to improve Claude Code behavior, derived from Andrej Karpathy's observations on LLM coding pitfalls.

// pluginsmultica-ai/★ 230,631[ claude ]
🔓

Claude Code is an agentic coding tool that lives in your terminal, understands your codebase, and helps you code faster by executing routine tasks, explainin…

// pluginsanthropics/⟨Python⟩★ 156,472[ claude ]
🔓

"CLI-Anything: Making ALL Software Agent-Native" -- CLI-Hub: https://clianything.cc/

// pluginsHKUDS/⟨Python⟩★ 58,467◷ Apache-2.0[ claude ]
🔓

financial-services — a Claude ecosystem project on GitHub.

// pluginsanthropics/⟨Python⟩★ 41,409◷ Apache-2.0[ claude ]
→ see how subagent-studio connects across the ecosystem