Linotype
An operating model that keeps products coherent over time.
On this page: What it is · Why Linotype? · Learning path · Reference · Quick links · History
What it is
Linotype gives you a lightweight way to keep docs, code, and decisions in sync as work flows between humans and AI agents. Slugs are the smallest delegable units of work; galleys group them into one product change. Everything stays in one place and stays findable.
- Galleys — Temporary groupings of slugs; move through planning → (queue) → doing → review → done
- Slugs — Smallest delegable change: clear outcome, acceptance checks, proof before review
- Agent contract —
docs/ai/_agent-rules.mdand repoAGENTS.md(focus, optimise, roles)
Linotype doesn’t replace your method (e.g. BMAD); it’s the structural layer that keeps outputs coherent over time.
Why Linotype?
AI-assisted development is fast, but coherence is fragile. Without structure, docs fall behind, decisions get lost, and handoffs break down. Linotype keeps integrity across tools (Kiro, Cursor, Claude) and over time.
Learning path
- What is Linotype? — Problem, solution, principles
- Getting started — Bootstrap and first steps
- How to use — Workflow and CLI
- Quick reference — Commands and structure
- Galleys — Coordinating multiple slugs
- Roles — Orchestrator, Executor, PDA, Module Architect
- Slug types — Directional vs build
- v4 — Focus, optimise, parallel workflow
- v5 — Learning layer, signals, snapshots
- v6 — LinoLoop execution wrapper, release runs, and worktree modes
Reference
| Doc | Description |
|---|---|
| What is Linotype? | Overview and when to use it |
| Getting started | Bootstrap and first slugs |
| How to use | Galley workflow and commands |
| Quick reference | Commands, focus/optimise, parallel work |
| Galleys | Grouping slugs, lifecycle, queue, parallel |
| Roles | Agent and human roles |
| Slug types | Directional vs build slugs |
| Structure | Folders and artefacts |
| FAQ | Common questions |
| v3 | v3 changes |
| v4 | v4: focus, optimise, parallel, agent contract |
| v5 | v5: learning layer, signals, snapshots |
| v6 | v6/v6.1: LinoLoop, release execution lists, worktree isolation |
| Templates | Starter slugs and usage |
| Changelog | Version history |
| History | How Linotype emerged; scale-of-contribution, PDA, slugs |
History
How Linotype emerged from real-world challenges with AI-assisted development. Full history →