~ / rigs / Qadrillion / qadrillion-agent

Qadrillion/qadrillion-agent

Open-source QA agent for agentic software testing in Cursor and Claude Code. Hooks are the boundaries, locators come from the source, and a result is not a Pass without evidence. Free, MIT.

↗ GitHub ★ 3 MIT updated 25d ago project Claude CodeCodex
stack: Python
share on X
ARCHETYPE
Orchestrator
A bench of specialised subagents. The main agent mostly delegates.
CONTEXT TAX · EVERY TURN
~1.7k tokens
Featherweight · median rig: 2.3k · breakdown
GUARDRAILS
3/5
Blocks destructive commands · Pre-tool screening hook · No YOLO mode · details
Quality 24/100 Guardrails v2

Copy this rig

# review before running: this installs third-party code
$ npx degit Qadrillion/qadrillion-agent/.claude ./rig-qadrillion-agent  # 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 Qadrillion/qadrillion-agent/.agent/skills/golden-tasks .claude/skills/golden-tasks
$ npx degit Qadrillion/qadrillion-agent/.agent/skills/qa-api .claude/skills/qa-api
$ npx degit Qadrillion/qadrillion-agent/.agent/skills/qa-mobile .claude/skills/qa-mobile
$ npx degit Qadrillion/qadrillion-agent/.agent/skills/qa-performance .claude/skills/qa-performance
$ npx degit Qadrillion/qadrillion-agent/.agent/skills/qa-security .claude/skills/qa-security
$ npx degit Qadrillion/qadrillion-agent/.agent/skills/qa-web .claude/skills/qa-web
$ npx degit Qadrillion/qadrillion-agent/.agent/skills/qa-workflow .claude/skills/qa-workflow
$ npx degit Qadrillion/qadrillion-agent/.agent/skills/qa .claude/skills/qa
$ curl -fsSL --create-dirs -o .claude/agents/code-explorer.md https://raw.githubusercontent.com/Qadrillion/qadrillion-agent/main/.claude/agents/code-explorer.md
$ curl -fsSL --create-dirs -o .claude/agents/code-reviewer.md https://raw.githubusercontent.com/Qadrillion/qadrillion-agent/main/.claude/agents/code-reviewer.md
$ curl -fsSL --create-dirs -o .claude/agents/test-runner.md https://raw.githubusercontent.com/Qadrillion/qadrillion-agent/main/.claude/agents/test-runner.md
$ curl -fsSL --create-dirs -o .claude/agents/ticket-writer.md https://raw.githubusercontent.com/Qadrillion/qadrillion-agent/main/.claude/agents/ticket-writer.md
$ curl -fsSL --create-dirs -o .claude/agents/tracker-reporter.md https://raw.githubusercontent.com/Qadrillion/qadrillion-agent/main/.claude/agents/tracker-reporter.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|exec_command|Read|Edit|Write|MultiEdit|NotebookEdit|apply_patch|mcp__.*)$",
        "hooks": [
          {
            "type": "command",
            "command": "bash \"$CLAUDE_PROJECT_DIR/.claude/hooks/pretooluse.sh\""
          }
        ]
      }
    ]
  }
}

Skills (8)

Subagents (5)

code-explorer
model: inherit
Locate a bounded behavior or dependency chain in available source. Return a concise navigation map with revision and file references; do not rate risks or edit code.
code-reviewer
model: inherit
Review located product code for concrete testable QA risks and gaps against criteria. Source inspection produces hypotheses, not an execution verdict.
test-runner
model: inherit
Execute selected tests in the configured runner, retain evidence and classify failures. Does not write tests, weaken assertions or turn reruns into a clean Pass.
ticket-writer
model: inherit
Persist one QA ticket at phase boundaries and prepare a precise resume handoff. Use as the sole delegated writer after other workers return evidence.
tracker-reporter
model: inherit
Prepare QA comments and reproducible defect drafts in the team's tracker format; publish only when explicitly authorized and runtime permissions allow.

Hooks (4)

eventmatcherruns
PreToolUse^(Bash|exec_command|Read|Edit|Write|MultiEdit|NotebookEdit|apply_patch|mcp__.*)$bash "$CLAUDE_PROJECT_DIR/.claude/hooks/pretooluse.sh"
SessionEnd*bash "$CLAUDE_PROJECT_DIR/.claude/hooks/pretooluse.sh"
SessionStart*bash "$CLAUDE_PROJECT_DIR/.claude/hooks/pretooluse.sh"
Stop*bash "$CLAUDE_PROJECT_DIR/.claude/hooks/pretooluse.sh"

Similar rigs

copied ✓