agentrigs
+ submit rig
~ / rigs / plumpslabs / matcha

plumpslabs/matcha

🍵 Deliberate engineering guidelines & deterministic lifecycle safety hooks to enforce planning, prevent bloat, and block dangerous commands in AI coding agents (Claude Code, Cursor, Windsurf, Cline).

↗ GitHub ★ 2 MIT updated 3d ago project Claude CodeCodexCursorGemini CLICopilot Claude plugin
share on X
ARCHETYPE
Orchestrator
A bench of specialised subagents. The main agent mostly delegates.
CONTEXT TAX · EVERY TURN
~5.2k tokens
Moderate · 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 plumpslabs/matcha/.claude ./rig-matcha  # 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.

$ npx degit plumpslabs/matcha/.agents/skills/audit .claude/skills/audit
$ npx degit plumpslabs/matcha/.agents/skills/matcha .claude/skills/matcha
$ npx degit plumpslabs/matcha/.agents/skills/off .claude/skills/off
$ npx degit plumpslabs/matcha/.agents/skills/on .claude/skills/on
$ npx degit plumpslabs/matcha/.agents/skills/review .claude/skills/review
$ npx degit plumpslabs/matcha/.agents/skills/status .claude/skills/status
$ npx degit plumpslabs/matcha/.agents/skills/toggle .claude/skills/toggle
$ npx degit plumpslabs/matcha/.agents/skills/why .claude/skills/why
$ curl -fsSL --create-dirs -o .claude/agents/matcha-auditor.md https://raw.githubusercontent.com/plumpslabs/matcha/main/.claude/agents/matcha-auditor.md
$ curl -fsSL --create-dirs -o .claude/agents/matcha-cleaner.md https://raw.githubusercontent.com/plumpslabs/matcha/main/.claude/agents/matcha-cleaner.md
$ curl -fsSL --create-dirs -o .claude/agents/matcha-debugger.md https://raw.githubusercontent.com/plumpslabs/matcha/main/.claude/agents/matcha-debugger.md
$ curl -fsSL --create-dirs -o .claude/agents/matcha-finder.md https://raw.githubusercontent.com/plumpslabs/matcha/main/.claude/agents/matcha-finder.md
$ curl -fsSL --create-dirs -o .claude/agents/matcha-planner.md https://raw.githubusercontent.com/plumpslabs/matcha/main/.claude/agents/matcha-planner.md
$ curl -fsSL --create-dirs -o .claude/agents/matcha-reviewer.md https://raw.githubusercontent.com/plumpslabs/matcha/main/.claude/agents/matcha-reviewer.md
$ curl -fsSL --create-dirs -o .claude/agents/matcha-auditor.md https://raw.githubusercontent.com/plumpslabs/matcha/main/agents/matcha-auditor.md
$ curl -fsSL --create-dirs -o .claude/agents/matcha-cleaner.md https://raw.githubusercontent.com/plumpslabs/matcha/main/agents/matcha-cleaner.md
$ curl -fsSL --create-dirs -o .claude/agents/matcha-debugger.md https://raw.githubusercontent.com/plumpslabs/matcha/main/agents/matcha-debugger.md
$ curl -fsSL --create-dirs -o .claude/agents/matcha-finder.md https://raw.githubusercontent.com/plumpslabs/matcha/main/agents/matcha-finder.md
$ curl -fsSL --create-dirs -o .claude/agents/matcha-planner.md https://raw.githubusercontent.com/plumpslabs/matcha/main/agents/matcha-planner.md
$ curl -fsSL --create-dirs -o .claude/agents/matcha-reviewer.md https://raw.githubusercontent.com/plumpslabs/matcha/main/agents/matcha-reviewer.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": "Bash|Edit|Write|MultiEdit",
        "hooks": [
          {
            "type": "command",
            "command": "node hooks/matcha-shield.js"
          }
        ]
      }
    ]
  }
}

Skills (8)

auditmatchaoffonreviewstatustogglewhy

Subagents (12)

matcha-auditorStack audit. Finds overlaps, waste, security risks. Read-only.
matcha-cleanerCleanup. Removes temp, debug, unused code. Confirm before delete. May edit after confirmation.
matcha-debuggerSystematic debugger. One hypothesis at a time. Evidence required. May apply minimal fixes.
matcha-finderReuse decision engine. Finds existing code before writing new — classifies REUSE/EXTEND/COMPOSE/REFERENCE/NEW. Never duplicate. Read-only.
matcha-plannerEngineering planning. Intent Discovery → context → constraints → reuse → alternatives → roadmap. Read-only — never implements, never edits source code.
matcha-reviewerReview gate with risk-based routing. L0=output check, L1=lint, L2=full review, L3=expert+threat model. Blocks merge if critical issues found. Read-only.
matcha-auditorStack audit. Finds overlaps, waste, security risks. Read-only.
matcha-cleanerCleanup. Removes temp, debug, unused code. Confirm before delete. May edit after confirmation.
matcha-debuggerSystematic debugger. One hypothesis at a time. Evidence required. May apply minimal fixes.
matcha-finderReuse decision engine. Finds existing code before writing new — classifies REUSE/EXTEND/COMPOSE/REFERENCE/NEW. Never duplicate. Read-only.
matcha-plannerEngineering planning. Intent Discovery → context → constraints → reuse → alternatives → roadmap. Read-only — never implements, never edits source code.
matcha-reviewerReview gate with risk-based routing. L0=output check, L1=lint, L2=full review, L3=expert+threat model. Blocks merge if critical issues found. Read-only.

Hooks (4)

eventmatcherruns
PreToolUseBash|Edit|Write|MultiEditnode hooks/matcha-shield.js
PostToolUse*node hooks/matcha-post-write.js
Stop*node hooks/matcha-stop.js
SessionStart*node hooks/matcha-session-start.js

Slash commands (20)

/matcha:audit/matcha:debt/matcha:intensity/matcha:markers/matcha:off/matcha:on/matcha:review/matcha:status/matcha:toggle/matcha:why/matcha:audit/matcha:debt/matcha:intensity/matcha:markers/matcha:off/matcha:on/matcha:review/matcha:status/matcha:toggle/matcha:why

Cursor rules (2)

kuma · alwaysmatcha · always

Similar rigs

syntaxixr/goalpost
Your agent says “All tests pass!” The hidden tests say 28/34. goalpost makes Claude Code's /goal prove it: frozen spec, real checks after every edit, read-only tests, fresh-eyes audit. Enforced by hooks, not by asking nicely.
★ 2 project Claude Code 4 skills 2d ago
Minimalist 120 tok ·
songjiao/claude_dotfiles
—
★ 0 setup Claude Code 5 skills 9mo ago
Pragmatist 837 tok ·
sendbird/cc-plugin-codex
An open-source plugin that runs inside Codex and lets you use Claude Code and Claude models for review, rescue, and tracked background workflows.
★ 217 project Claude CodeCodex 7 skills 11d ago
Pragmatist 620 tok ·
ccch1mneyyy/dsh-TUI
DSH's officially recommended TUI plugin — high performance, low overhead, cute pixel whale, smooth mouse interaction. One-command install via npm. / DSH 官方推荐的 TUI 插件, 高性能低占用, 可爱像素鲸鱼, 流畅鼠标交互, npm一键安装
★ 3,939 project Claude CodeCodex 8 skills 7d ago
Pragmatist 1.9k tok ·
copied ✓