harness-builder-codex

🇰🇷 한국어: README.ko.md

agent-skill

Agent-first workflows that run themselves. One /agent-init per project; one /agent-all "..." per feature; the agent brainstorms → plans → writes → tests → opens the PR — and keeps iterating until the tests pass — without you babysitting every turn.

Works on Claude Code today, with cross-platform ports for Cursor, GitHub Copilot CLI, VS Code Copilot, Codex CLI, and Gemini CLI. 17 plugins, 5 slash commands, one marketplace.

/agent-init                            # bootstrap any git repo (Phase A — once per project)
/agent-all "Add Google OAuth" --loop   # brainstorm → plan → code → test → PR (Phase C — per feature)
/visual-qa                             # screenshot every page, LLM design review
/thrift                                # keep long sessions affordable (auto-summarize, audit)
/explore                               # codebase map; /explore where Foo → O(1) lookup
/debug "tests flaky 30% of runs"       # reproduce → bisect → hypothesize → verify

Three things that make it click:

1. Project-first scaffolding. /agent-init works on any git repo — Next.js, FastAPI, Rust CLI, monorepo. It detects your stack, picks the right test command, and creates CLAUDE.md + agents + hooks + config in one commit. Same command, every project.

2. Agent-first execution that preserves your main thread. /agent-all "..." isn't a chat. It runs brainstorm → plan → implement → review → PR as one pipeline, and the implementation/review heavy lifting happens in isolated subagents — their turn-by-turn output never enters your main conversation. A built-in two-layer safety net mandates superpowers:verification-before-completion per implementer + cross-checks at Phase 4 review, so broken code can't sneak into a PR. Your main session stays small (planning + judgment) so the same Claude Code session can keep going for hours without context bloat.

3. Composable for unattended runs. Three pieces — /agent-all --loop (drives the work), /thrift (compresses what does accumulate in main), /goal (keeps the session alive across iterations) — combine into overnight runs that exit cleanly when CI is green or your cost cap hits. See Self-sustaining workflows.

That's it. The rest of this README is reference material — skim the parts you need.

---

Prerequisites

• Node.js ≥ 20 — required for all install renderers (bin/init.mjs, bin/install.mjs, scripts/install-all.sh, scripts/install-platform.sh)
• git — required by /agent-init, /agent-all, and /explore (HEAD-keyed cache)
• gh CLI (optional) — for /agent-all Phase 5 PR creation; without it, /agent-all falls back to --no-pr mode
• For Claude Code: marketplace plugin support (any recent build)
• For per-platform install: target CLI installed (Cursor, gh copilot, codex, gemini) AND its config dir writable

Strongly recommended (the harness composes on top of these — degrades gracefully if missing):

• superpowers@claude-plugins-official — foundational skills (brainstorming, writing-plans, subagent-driven-development, verification-before-completion, etc.)
• context-mode@context-mode — keeps raw tool output out of main conversation

See How this fits with the rest of the Claude ecosystem for details on how they integrate.

---

Install in 60 seconds

First, register the marketplace (once per machine):

/plugin marketplace add https://github.com/kim-song-jun/agent-skill

Option A: one-liner (recommended)

# Outside Claude Code, in a terminal:
git clone https://github.com/kim-song-jun/agent-skill /tmp/agent-skill
bash /tmp/agent-skill/scripts/install-all.sh

Installs all 5 Claude Code essentials at once via the claude CLI. Run --all for all 17 plugins (CLI-platform siblings too), or --cli=codex|copilot|gemini|cursor for a single platform set.

Option B: paste into Claude Code

/plugin install harness-builder@agent-skill
/plugin install harness-floor@agent-skill
/plugin install harness-thrift@agent-skill
/plugin install harness-explore@agent-skill
/plugin install harness-debug@agent-skill
/reload-plugins

(Claude Code's /plugin install accepts only one plugin at a time, so the script in Option A is faster.)

Then in your project

cd my-project
/agent-init

You're done. Try /agent-all "small feature" to see it work.

---

Keep plugins up to date

/plugin update --marketplace agent-skill