Getting started

Your first steps with Linotype.

In 10 minutes

1. Bootstrap — Use the Linotype skeleton: copy linotype-skeleton/ into your repo or run cli/linotype-bootstrap.sh. Ensure docs/ai/_agent-rules.md and root AGENTS.md exist.
2. Create a galley — cli/linotype galley new <name> (e.g. 20260209-first-slice). Add slugs under the galley.
3. Move to doing — cli/linotype galley move <name> doing. Do the work; update slug files; commit with slug:<slug-name> done - <summary> #galley:<galley-name>.
4. Move to review — When all slugs are done, cli/linotype galley move <name> review. Fill galley review.md; commit galley:<name> ready for review - <summary>.

New product

• Create a galley (e.g. bootstrap or index). In the galley README, define: what is the product, who are the users, key journeys, initial modules, constraints.
• Complete one slug that establishes docs/domain/index.md (or docs/context/app-context.md) and optional capability registry.
• Then create a “first vertical slice” galley and execute its slugs.

Existing product

• Create a galley (e.g. index). Document current state: existing modules, capabilities, where things live.
• Add slugs that capture the as-is; then use galleys for all new work.

What’s next?

• How to use — Workflow and CLI
• Quick reference — Commands and structure
• Galleys — Lifecycle, queue, parallel work
• v6 — LinoLoop execution wrapper and release runs
• FAQ — Common questions