> ## Documentation Index
> Fetch the complete documentation index at: https://docs.clear-box.io/llms.txt
> Use this file to discover all available pages before exploring further.

# How we build

> Spec first, then tickets, then pull requests.

**1. Spec**

Features are specified and their decisions recorded first, in the product chat, then committed to docs/specs/.

**2. Tickets**

/to-tickets turns the spec into GitHub issues: one tracer-bullet ticket each, with a done-when line and its blockers.

**3. Build**

Claude Code builds each ticket test-first (/tdd) on its own branch, runs /code-review, and opens a pull request.

**4. Review and ship**

Ian reviews every pull request and publishes. Nothing goes to production unreviewed.

**5. Record**

Each session leaves a design-log entry and updates docs/STATUS.md.

Engineering discipline comes from Matt Pocock's Claude Code skills (/grill-me, /to-spec, /to-tickets, /tdd, /code-review, /handoff).

**Writing rule:** no em dashes or en dashes in code comments, docs or UI copy.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.