Open source · Apache 2.0

Architect
draw the system, make the agent follow it

Coding agents add structure faster than anyone reviews it. Architect turns the diagram into a gate: the agent reads it, and every structural change comes back to me as a picture to approve.

ElectronMCP serverTypeScriptLanguage serverCreator and maintainer
Architect approval inbox with proposed components drawn as dashed ghost nodes and a cycle highlighted in red
Blocked calls wait in the inbox, already drawn on the canvas. A change that would close a cycle lights up red.
89
of 98 contributions
4
gated change types
4
MCP tools
1
markdown contract
The problem

Left alone, an agent invents a new service, a new util layer, a new dependency and a new folder. Each one is defensible. Together they make a codebase unreviewable in a week. A prompt that says follow the architecture is advice, not a gate.

How it works

The architecture lives in one architect.md at the repo root. Each box claims part of the repo with a glob, which is what turns a drawing into a contract. It diffs cleanly and gets reviewed in a pull request like any other file.

The agent calls check_change before it writes. A drawn edge is allowed instantly. A forbidden edge comes back with the reason. Anything new goes through propose_change, which blocks until I approve or reject it on the canvas.

What needs approval

A new component, a new edge, a new third party package, and a file outside every glob. Those four cover the usual ways a clean graph quietly turns into a mesh. I never approve a text diff, only a picture of my system with the change in it.

Beyond the gate

Code mode reads the repo as it really is, folder by folder, down to a function call graph with source. A bundled language server gives architect.md diagnostics, completion and rename in any editor, and a worktrees tab finds and safely removes stale git worktrees. Architect ships with its own architect.md, so it is its own demo and test fixture.

Architect contract canvas
The contract as drawn, once the inbox is clear.
Architect call graph
Code mode: a file's functions and the calls between them.
All case studies

Projectionist's cheat sheet

action
Roll the clapper
↑↑↓↓←→←→BA
Thread the leader
klaatu
Wake the robot
ls
List the reels
zap
Fire across the top
hello
Print on the teletype
warp
Push the reel past light
tesla
Throw the big switch
basic
Run a BASIC loop
eureka
Have the idea in the bath
pong
Play a table tennis demo
watson
Ring the telephone
?
The cheat sheet
Resize the window
Check the masking
Change the palette
Load a new film stock
Esc
Back to the picture

Directory of C:\BOOTH