Anyone shipping AI TypeScript
Contain. Guide. Order.
Day-to-day: install, run status, do action #1. That is Contener · Guiar · Ordenar.
Day-to-day
Install lives on Start. This page is the loop.
After the four commands, doctor is the product: one light, one next action. Skills later, when you ask.
What you get
While you write. Before you merge.
| When | What happens |
|---|---|
| While the AI writes | The write is rejected, or a warning (depends on host) |
| Before merge |
arkgate-check — make it a
required CI status
|
| Anytime | Doctor: Suggest / Adapt / Enforce (+ leftover design work if the tree is still messy) |
ArkGate is not a web framework, ORM, or app runtime. If the AI writes an illegal import, the write is rejected. The same check fails the pull request.
Layers and extras
Layers always. Extras optional.
| Kind | Plain English | Enforces |
|---|---|---|
| Layers | Who may talk to whom | Import direction, purity, forbidden globals, capabilities, peer isolation |
| ArkRules (optional) | Habits inside a layer + named policies | Structure heuristics; invariant catalog + coverage evidence—not full business proof |
| ArkRun (optional) | How the app talks (arkgate/runtime) |
Experimental runtime. Its local terminal dashboard reads bounded, payload-free inspector facts. In-memory. Not durable. Off unless you turn it on. |
| ArkOrder (optional) | Stops rewriting a billing plan like a seat count (arkgate/order) |
Invoices still flow. Changing plan is a new release. A
generic update does not land. See the
billing gallery ↗
(GitHub, not in the npm tarball). Off unless you turn it on.
|
Green layers are not perfect design. Covered invariants are not “the business always does the right thing”—they mean a named policy is declared and has symbol or test evidence.
Status lights
Not settings you pick.
New or thin
Finish start, re-run doctor.
Not fully protected
Doctor action #1 until clean.
Import rules hold
Keep write path + CI.
Design still messy
Not “done.” Map leftover work, then one small refactor.
Leftover design work
Green check. Messy code.
Suggested leftover work. Never silent magic.
Confirm
Doctor names leftover design work.
Map, if you want
Optional: /ark-explore then
/ark-autopilot with your OK.
One small refactor
Change one thing. Re-run doctor.
More depth: Develop path · How it works · Full use.md on GitHub ↗