Tevrin documentation

Tevrin coordinates specialised AI agents through a governed software lifecycle: Refinement, Specification, Planning, Execution, Review and Release. It turns an idea into released software with versioned artifacts, approval gates, rollback and an audit trail. It is for engineers and project owners who want AI-driven delivery with deterministic state and human oversight. The code is source available on GitHub under the PolyForm Shield License 1.0.0.

Tevrin was called AIDE before v6. Some internal identifiers keep the aide name. See Architecture.

Where to start

If you want to	Go to
Run it on your machine	Getting started
Connect GitHub, an LLM or a tracker	Guides
Run it on Kubernetes or Railway	Operations
Look up a setting, API or error code	Reference
See what changed in each version	History
Use the logo and colours	Brand

The lifecycle

flowchart LR
  R[Refinement] --> S[Specification] --> P[Planning] --> E[Execution] --> V[Review] --> L[Release]

Agents write artifacts. People approve them at gates. Every state change is logged and can be rolled back. A repository with code can start in an Analysis phase that infers its stack.

Source of truth

The spec is the source of truth for behaviour. The current spec and build log are SPEC.md and PROGRESS.md. Earlier versions are under History.