Skip to content

Design documents

One design per step: goal, model, API, UI, risks, size and status. Status is Proposed, Accepted or Implemented in vX. When a step ships, its final behaviour moves into SPEC.md and the design is frozen. Versions and order: ROADMAP.md.

# Design Status Version
0001 Hooks and machine setup Implemented in v0.1.0 0.1.0
0002 Working rules 1.5a Implemented in v0.1.0; 1.5b–c Accepted 0.1.0 / 0.4.0
0003 Packaging and release Implemented in v0.1.0 (GIF, repository settings pending) 0.1.0
0004 Navigation: sidebar, Inbox, Map, Usage, Ctrl+K Accepted 0.2.0 / 0.4.0
0005 Comments to agents Implemented (unreleased) 0.2.0
0006 Environments, access and agent permissions Implemented (unreleased) 0.2.0
0007 Review: checklist with screenshots Implemented 0.3.0
0008 Memory and context Accepted 0.3.0
0009 Screenshot annotations Accepted 0.4.0
0010 Map and Usage Accepted 0.4.0
0011 Project documents in the database Accepted (scope) 0.4.0
0012 Runner and embedded terminal Accepted (direction) 0.6+
0013 Policy as data Implemented (unreleased) 0.2.0
0014 Task plan and checkpoints Implemented (unreleased) 0.3.0

Single decisions with context and consequences are ADRs: ADR-0001 HTMX + SSE.