Cleargate


ClearGate

**Bridging the gap between vibe coding and disciplined engineering.**

ClearGate is an open-source planning scaffold that turns AI coding agents into a disciplined engineering team. It installs a five-role agent team (Architect, Developer, QA, DevOps, Reporter), a template-driven work-item protocol (proposals → epics → stories → sprints), and a compiled awareness wiki — so your AI agents stop drifting between disconnected tasks and start shipping coherent software.

ClearGate is not an AI code generator. **It is an AI Engineering Manager.**

---

Quick install

npx cleargate init
npx cleargate doctor

Requires Node ≥ 24 LTS. `init` writes a bounded ClearGate block into `CLAUDE.md`, installs the five-role agent definitions, and scaffolds `.cleargate/`. To pin the version per-project, add it as a dev dependency: `npm i -D cleargate`. Full walkthrough in [Install](#install) and [Getting started in 10 minutes](#getting-started-in-10-minutes) below.

---

Give it to your agent

Already running an AI coding agent? Paste this prompt into Claude Code (or Cursor / Aider / any agent with shell + file-read access on this repo) and let it install and verify ClearGate for you:

Install ClearGate (npm package: cleargate) in this project.

1. Run `npx cleargate init` from the repo root. Report what files it
   created or modified.
2. Run `npx cleargate doctor`. Surface any warnings or errors verbatim.
3. Read the bounded `...`
   block now in CLAUDE.md. In 3 lines, summarize how this changes how
   we'll plan and execute work from now on.
4. List `.claude/agents/` and `.cleargate/templates/` — one line per
   item — so I can see what's available.

Do not write any production code yet. This is install + verification
only. If any step errors, stop and report the exact error.

If `init` lands cle