ArkGate
TS 5—7GitHub
01 / Promise

Architecture co-pilot for AI TypeScript

One contract.
One gate.
One co-pilot.

Your AI writes most of the code. ArkGate keeps that code inside an architecture you can trust—and makes sure a green check means something real.

Get startedView on npm
npm install -D arkgate typescript
Contract section / controlled TypeScript systemScale 1:∞ · live rules
ark.config.json
Allowed dependency direction
04Interfaceroutes / controllers
03Applicationuse-cases / services
02Domainentities / policy
01Infrastructureadapters / persistence
Contract active
Every write is checked before it lands.

The only flow

Three moves.
No new curriculum.

01checkpoint
npx arkgate start

Install the shape

Map the real repository, install the gates, and freeze an origin report.

02checkpoint
/ark-autopilot

Let the agent adopt

Match the contract to the codebase, plan repairs, and keep the gates on.

03checkpoint
arkgate-check --doctor

Know where you are

One status screen shows adoption gaps, governed coverage, and the next move.

02 / Enforcement plane

One file.
Two moments that matter.

ArkGate turns your architecture into a machine-readable contract. Agents read it while they work. CI checks it before code merges.

Read the architecture guide
INPUT / 00ark.config.jsonlayers · rules · intent policy
01

While the AI writes

Write gate

arkgate-mcp
pre-write
02

Before merge

CI gate

arkgate-check
exit 0 / 1
Governed path

03 / Honest status

Green should mean governed.

Doctor reports the contract you have—not the architecture you hope you have. Coverage, host wiring, and adoption gaps stay visible.

arkgate / workspace health● contract loaded

$ npx arkgate-check --doctor

STATUSADAPTtighten populated cores
GOVERNED78%up from origin 42%
GATES2/2write + CI active
→ next/ark-autopilot

2 mechanical-safe moves · 1 judgment call

Status, not settings

Suggest

New or thin project. Finish setup and map the real shape.

Adapt

Keep improving coverage until the contract can protect you honestly.

Enforce

Build features. Fix violations only when the gate finds them.

You arrive at Enforce. You never “turn it on.”

Designed for the repo you have

Shape-aware.
Agent-native.

PresetsHexagonal · Layered · Feature-sliced · Monorepo
FrameworksNest · Next · Express · TypeScript libraries
Agent hostsClaude Code · Cursor · Codex · Grok Build
CompilersTypeScript 5 · 6 · 7

Start in one minute

Give your AI
a load-bearing contract.

npx arkgate start

Setup, origin report, and your first architecture plan.

Open the project