~ / rigs / Just-Another-Agent-Factory / jaf

Just-Another-Agent-Factory/jaf

An autonomous, Linear-native, Claude-Code-native agent factory: one instruction in; decomposed, tracked, test-first-coded, gate-verified, serially-merged work out.

↗ GitHub ★ 1 Apache-2.0 updated 2mo ago project Claude Code
share on X
ARCHETYPE
Orchestrator
A bench of specialised subagents. The main agent mostly delegates.
CONTEXT TAX · EVERY TURN
~377 tokens
Featherweight · median rig: 2.3k · breakdown
GUARDRAILS
2/5
No YOLO mode · Sandbox or ask-first rules · details

Copy this rig

# review before running: this installs third-party code
$ npx degit Just-Another-Agent-Factory/jaf/.claude ./rig-jaf  # 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/factory-coder.md https://raw.githubusercontent.com/Just-Another-Agent-Factory/jaf/main/.claude/agents/factory-coder.md
$ curl -fsSL --create-dirs -o .claude/agents/factory-decomposer.md https://raw.githubusercontent.com/Just-Another-Agent-Factory/jaf/main/.claude/agents/factory-decomposer.md
$ curl -fsSL --create-dirs -o .claude/agents/factory-documenter.md https://raw.githubusercontent.com/Just-Another-Agent-Factory/jaf/main/.claude/agents/factory-documenter.md
$ curl -fsSL --create-dirs -o .claude/agents/factory-spec-reviewer.md https://raw.githubusercontent.com/Just-Another-Agent-Factory/jaf/main/.claude/agents/factory-spec-reviewer.md
$ curl -fsSL --create-dirs -o .claude/agents/factory-tester.md https://raw.githubusercontent.com/Just-Another-Agent-Factory/jaf/main/.claude/agents/factory-tester.md
$ curl -fsSL --create-dirs -o .claude/agents/factory-worker.md https://raw.githubusercontent.com/Just-Another-Agent-Factory/jaf/main/.claude/agents/factory-worker.md

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

{
  "sandbox": {
    "enabled": true
  }
}

Subagents (6)

factory-coderAgent Factory role — makes the Tester's failing test GREEN with the minimal, contract-first production change. Never edits the test.
factory-decomposerAgent Factory decomposer — turns an objective ("improve demo assembly until quality ≥ target") into atomic, adversarially-reviewed work units (natural atomic width, up to ~20) and writes them to Linea
factory-documenterAgent Factory role — documents one completed unit (code comment rationale + the Linear handoff proof text). No behavior changes.
factory-spec-reviewerAgent Factory 5th review dimension — verifies a unit's diff actually satisfies its Linear issue's Testable-ACs, independent of architecture correctness. Catches "green tests, wrong feature". Runs on e
factory-testerAgent Factory role — writes the FAILING test FIRST for one unit, confirms it is RED against current code, and commits it. Never implements the fix. Test-first per CLAUDE.md.
factory-workerAgent Factory teammate — owns ONE Linear unit at a time end-to-end in its own worktree with strict test-first discipline (Tester-RED → Coder-GREEN → Documenter), posts proof, marks the unit Merging, t

Slash commands (10)

/factory-add/factory-coordinate/factory-goal/factory-read/factory-release-manual/factory-release/factory-review-signoff-manual/factory-review-signoff/factory-supervisor/factory-tick

Similar rigs

copied ✓