Home

TRON

A deterministic orchestrator that builds software from specs — one agent you talk to; it runs the fleet.

You hand TRON a pipeline of spec'd work (blocks). TRON dispatches and orchestrates a fleet of worker agents — an architect, engineers, reviewers — and drives the work to done. You talk to TRON. TRON talks to everyone else.

The core is a deterministic engine, not a chatbot improvising. The process is data: one table (engine/workflow.toml) composes how a block advances, another (workflow.ESCALATION) where a stuck seat's signal goes. The engine executes both by lookup, never by guesswork; the diagrams are generated from the same tables, so they can't drift. The language model builds and makes a few narrow, typed judgments — it never chooses a step.

Start here

• Getting Started — requirements, run TRON, validate the engine.
• Concepts — the model: the pipeline, the architect, the gate, the two spines, walls.
• Commands — how you run it and what you type in the console.
• Configuration — workflow.toml, the limits, Telegram, what a project brings.
• Architecture — how the engine works under the hood.
• Operations — the heartbeat, walls, recovery, troubleshooting.
• FAQ

In one breath

• Work is a pipeline of blocks, each tied to a spec, each with a status.
• A persistent architect (forward-only) authors the next block; a ready block is dispatchable.
• Engineers build blocks; a reviewer checks each delivery. Review is a milestone, not a verdict — the architect turns findings into new work ahead.
• The truth gate never trusts a claim: a >>DONE is challenged for per-criterion evidence, then verified against commits, an untouched trunk, and the engine's own test run.
• Anything no worker can clear routes architect-first; only a true impasse walls to you.
• Every engine decision is one typed line in events.jsonl — the single source of truth for what happened.

What TRON isn't

A production runtime for app traffic · a customer-facing surface or SaaS · a multi-machine fleet manager. TRON is yours; it runs on your machine.

---

_{Current version: 0.4.2 — see the Releases. New pages: Authoring a Project · Validation and Research · Glossary and Events.}