~ / rigs / mcp-tool-shop-org / role-os

mcp-tool-shop-org/role-os

Role OS — a repo-native operating layer that staffs coding-agent work through 61 role contracts, packs, missions, recipe cards, and a critic jury. Claude Code adapter ships; the contracts are markdown any harness can consume.

↗ GitHub ★ 0 MIT updated 1d ago project Claude Code
share on X
ARCHETYPE
Orchestrator
A bench of specialised subagents. The main agent mostly delegates.
CONTEXT TAX · EVERY TURN
~364 tokens
Featherweight · median rig: 2.3k · breakdown
GUARDRAILS
2/5
Pre-tool screening hook · No YOLO mode · details

Copy this rig

# review before running: this installs third-party code
$ npx degit mcp-tool-shop-org/role-os/.claude ./rig-role-os  # inspect, then merge into .claude/

MCP servers are added to Claude Code at local scope; env vars are shown as YOUR_… placeholders — we never store values. Files are fetched with degit into a separate folder so you can review before merging.

$ curl -fsSL --create-dirs -o .claude/agents/critic-reviewer.md https://raw.githubusercontent.com/mcp-tool-shop-org/role-os/main/.claude/agents/core/critic-reviewer.md
$ curl -fsSL --create-dirs -o .claude/agents/orchestrator.md https://raw.githubusercontent.com/mcp-tool-shop-org/role-os/main/.claude/agents/core/orchestrator.md
$ curl -fsSL --create-dirs -o .claude/agents/product-strategist.md https://raw.githubusercontent.com/mcp-tool-shop-org/role-os/main/.claude/agents/core/product-strategist.md
$ curl -fsSL --create-dirs -o .claude/agents/brand-guardian.md https://raw.githubusercontent.com/mcp-tool-shop-org/role-os/main/.claude/agents/design/brand-guardian.md
$ curl -fsSL --create-dirs -o .claude/agents/ui-designer.md https://raw.githubusercontent.com/mcp-tool-shop-org/role-os/main/.claude/agents/design/ui-designer.md
$ curl -fsSL --create-dirs -o .claude/agents/backend-engineer.md https://raw.githubusercontent.com/mcp-tool-shop-org/role-os/main/.claude/agents/engineering/backend-engineer.md
$ curl -fsSL --create-dirs -o .claude/agents/dependency-auditor.md https://raw.githubusercontent.com/mcp-tool-shop-org/role-os/main/.claude/agents/engineering/dependency-auditor.md
$ curl -fsSL --create-dirs -o .claude/agents/frontend-developer.md https://raw.githubusercontent.com/mcp-tool-shop-org/role-os/main/.claude/agents/engineering/frontend-developer.md
$ curl -fsSL --create-dirs -o .claude/agents/performance-engineer.md https://raw.githubusercontent.com/mcp-tool-shop-org/role-os/main/.claude/agents/engineering/performance-engineer.md
$ curl -fsSL --create-dirs -o .claude/agents/refactor-engineer.md https://raw.githubusercontent.com/mcp-tool-shop-org/role-os/main/.claude/agents/engineering/refactor-engineer.md
$ curl -fsSL --create-dirs -o .claude/agents/security-reviewer.md https://raw.githubusercontent.com/mcp-tool-shop-org/role-os/main/.claude/agents/engineering/security-reviewer.md
$ curl -fsSL --create-dirs -o .claude/agents/test-engineer.md https://raw.githubusercontent.com/mcp-tool-shop-org/role-os/main/.claude/agents/engineering/test-engineer.md
$ curl -fsSL --create-dirs -o .claude/agents/community-manager.md https://raw.githubusercontent.com/mcp-tool-shop-org/role-os/main/.claude/agents/growth/community-manager.md
$ curl -fsSL --create-dirs -o .claude/agents/content-strategist.md https://raw.githubusercontent.com/mcp-tool-shop-org/role-os/main/.claude/agents/growth/content-strategist.md
$ curl -fsSL --create-dirs -o .claude/agents/launch-strategist.md https://raw.githubusercontent.com/mcp-tool-shop-org/role-os/main/.claude/agents/growth/launch-strategist.md
$ curl -fsSL --create-dirs -o .claude/agents/support-triage-lead.md https://raw.githubusercontent.com/mcp-tool-shop-org/role-os/main/.claude/agents/growth/support-triage-lead.md
$ curl -fsSL --create-dirs -o .claude/agents/launch-copywriter.md https://raw.githubusercontent.com/mcp-tool-shop-org/role-os/main/.claude/agents/marketing/launch-copywriter.md
$ curl -fsSL --create-dirs -o .claude/agents/feedback-synthesizer.md https://raw.githubusercontent.com/mcp-tool-shop-org/role-os/main/.claude/agents/product/feedback-synthesizer.md
$ curl -fsSL --create-dirs -o .claude/agents/roadmap-prioritizer.md https://raw.githubusercontent.com/mcp-tool-shop-org/role-os/main/.claude/agents/product/roadmap-prioritizer.md
$ curl -fsSL --create-dirs -o .claude/agents/spec-writer.md https://raw.githubusercontent.com/mcp-tool-shop-org/role-os/main/.claude/agents/product/spec-writer.md
$ curl -fsSL --create-dirs -o .claude/agents/competitive-analyst.md https://raw.githubusercontent.com/mcp-tool-shop-org/role-os/main/.claude/agents/research/competitive-analyst.md
$ curl -fsSL --create-dirs -o .claude/agents/trend-researcher.md https://raw.githubusercontent.com/mcp-tool-shop-org/role-os/main/.claude/agents/research/trend-researcher.md
$ curl -fsSL --create-dirs -o .claude/agents/user-interview-synthesizer.md https://raw.githubusercontent.com/mcp-tool-shop-org/role-os/main/.claude/agents/research/user-interview-synthesizer.md
$ curl -fsSL --create-dirs -o .claude/agents/ux-researcher.md https://raw.githubusercontent.com/mcp-tool-shop-org/role-os/main/.claude/agents/research/ux-researcher.md
$ curl -fsSL --create-dirs -o .claude/agents/coverage-auditor.md https://raw.githubusercontent.com/mcp-tool-shop-org/role-os/main/.claude/agents/treatment/coverage-auditor.md
$ curl -fsSL --create-dirs -o .claude/agents/deployment-verifier.md https://raw.githubusercontent.com/mcp-tool-shop-org/role-os/main/.claude/agents/treatment/deployment-verifier.md
$ curl -fsSL --create-dirs -o .claude/agents/docs-architect.md https://raw.githubusercontent.com/mcp-tool-shop-org/role-os/main/.claude/agents/treatment/docs-architect.md
$ curl -fsSL --create-dirs -o .claude/agents/metadata-curator.md https://raw.githubusercontent.com/mcp-tool-shop-org/role-os/main/.claude/agents/treatment/metadata-curator.md
$ curl -fsSL --create-dirs -o .claude/agents/release-engineer.md https://raw.githubusercontent.com/mcp-tool-shop-org/role-os/main/.claude/agents/treatment/release-engineer.md
$ curl -fsSL --create-dirs -o .claude/agents/repo-researcher.md https://raw.githubusercontent.com/mcp-tool-shop-org/role-os/main/.claude/agents/treatment/repo-researcher.md
$ curl -fsSL --create-dirs -o .claude/agents/repo-translator.md https://raw.githubusercontent.com/mcp-tool-shop-org/role-os/main/.claude/agents/treatment/repo-translator.md

Merge into .claude/settings.json (project) or ~/.claude/settings.json (user). Hook commands reference scripts in the source repo — copy those too.

{
  "hooks": {
    "PreToolUse": [
      {
        "matcher": "*",
        "hooks": [
          {
            "type": "command",
            "command": "node .claude/hooks/pre-tool-use.mjs"
          }
        ]
      }
    ]
  }
}

Subagents (31)

critic-reviewer—
orchestrator—
product-strategist—
brand-guardian—
ui-designer—
backend-engineer—
dependency-auditor—
frontend-developer—
performance-engineer—
refactor-engineer—
security-reviewer—
test-engineer—
community-manager—
content-strategist—
launch-strategist—
support-triage-lead—
launch-copywriter—
feedback-synthesizer—
roadmap-prioritizer—
spec-writer—
competitive-analyst—
trend-researcher—
user-interview-synthesizer—
ux-researcher—
coverage-auditor—
deployment-verifier—
docs-architect—
metadata-curator—
release-engineer—
repo-researcher—
repo-translator—

Hooks (1)

eventmatcherruns
PreToolUse*node .claude/hooks/pre-tool-use.mjs

Similar rigs

copied ✓