coding-agent

coding-agent

A Claude Code plugin for shipping real software, not just writing code that compiles.

Drop-in multi-agent pipeline that turns "build me a notifications system" into shipped, tested, reviewed code — with human checkpoints at the decisions that matter and real runtime verification before anything ships.

---

What you get

• A real pipeline, not a one-shot. Intent → Spec → Plan → Implement → Review → Commit. Each stage has an owner, an artifact, and a deterministic check.
• Human gates at the right spots. You approve intent, spec, plan, and push. No agent fakes your signature.
• Runtime testing, not just typechecks. The reviewer launches your app in a real browser (Playwright) or iOS simulator, takes screenshots, runs your committed test suites. "Compiles" isn't evidence.
• Memory across sessions. Decisions, gotchas, and patterns survive. Tomorrow's architect reads yesterday's learnings. No cold starts.
• Research from real docs, not stale training data. Architect queries Context7 / Exa for current library APIs. No more shadcn v2 flags in a v4 project.
• Per-task skill manifest. Architect picks the right specialist skills for each task. Implementor loads them on dispatch. No one-size-fits-all prompt.
• Visual design review. For UI features the architect ships a look-contract (design.html) you review in a browser surface — inline comments + a sha-bound approve, not ASCII mockups in a terminal.
• Product direction when you need it (opt-in). A product-lead agent turns "I don't know what to build" into a concrete problem, a clean core flow, and a world-class bar — and evolves a product.md north-star across features.
• Portable docs any agent can use. Close-out generates a cross-referenced, no-duplication documentation set (README · AGENTS · PRODUCT · DESIGN · docs/architecture · docs/dataflow · deployment) — vendor-neutral, so it keeps working even if you drop this plugin.
• Zero-ceremony touch-ups. Fix a button color? One intent gate, smoke review, commit. Full pipeline only when the work warrants it.

Why this exists

Most AI coding tools happily generate code that compiles and breaks at runtime. They skip the design step, hallucinate library APIs, never actually launch the app, silently swallow errors, and forget everything the moment you close your terminal.

coding-agent is a reaction to those failures — an opinionated pipeline built from real pain:

Failure mode	How the plugin handles it
"It compiles but the button is broken"	Evaluator runs Playwright against the live UI and screenshots it before PASS
"The architect hallucinated an API"	Architect must cite MCP queries (Context7/Exa) for stack and test-infra decisions
"Approvals got forged"	Only the orchestrator can call AskUserQuestion; subagents write drafts with blank signatures
"Same bug twice"	After a fix fails, next round routes to the Debugger (not another Implementor)
"Parallel work broke everything"	Plan declares explicit parallelism; orchestrator fans out only when declared
"The evaluator skipped screenshots"	Orchestrator's ui-evidence.sh check verifies screenshots exist before commit
"Learnings evaporated"	Close-out distills decisions/gotchas/patterns into learnings.md; every new feature reads it first

---

Install

git clone https://github.com/devjarus/coding-agent ~/.claude/plugins/coding-agent
# or point to a working tree during development:
claude --plugin-dir /path/to/coding-agent

Setup (per project, one command)

bash ~/.claude/plugins/coding-agent/scripts/setup.sh

Writes .claude/settings.local.json with recommended permissions (broad allow + narrow ask for dangerous ops), enables all plugin MCPs, auto-detects iOS, updates .gitignore. Restart Claude Code to pick it up.

First run

cd ~/my-project
claude

Then type something concrete:

"Build a notes API with Node + SQLite. Endpoints for POST /notes (text + tags) and GET /notes?tag. Integration tests required."

What happens next:

Orchestrator: classifies (medium feature), proposes path → AskUserQuestion
You: approve

Architect:   reads profile + learnings.md
             bundles stack decisions + discovery questions
             → returns ask_user to orchestrator
Orchestrator: surfaces questions in ONE AskUserQuestion
You: confirm stack

Architect:   researches test infra (Context7/Exa)
             writes spec.md → orchestrator prints it in chat
             → AskUserQuestion to approve
You: approve spec (Gate 2)