Skip to content

Latest commit

 

History

History

rules

Folders and files

NameName
Last commit message
Last commit date

parent directory

..
CURSOR_RULES.md
CURSOR_RULES.md
 
 
README.md
README.md
 
 

README.md

Cursor Rules Entry Point

This directory contains the authoritative rules for working in this repository.

Before making any decisions or writing code:

  1. Read CURSOR_RULES.md
  2. Read /docs/ARCHITECTURE.md
  3. Read /docs/core/CORE_PUBLIC_API.md
  4. When working on a specific layer (desktop, web, modules), read the docs for that layer (e.g. docs/desktop/, docs/web/)

For agent role boundaries and execution order (which agent may do what in the dev repo), see .claude/governance/agents.md. Agent definitions and control plane: .claude/.

If a decision is unclear or undocumented:

  • Update the relevant file in /docs first (or add an ADR in adr/ for significant arch/technical decisions, or a record in decisions/ for other decisions). For when to use docs vs adr vs decisions, and where to put diagrams, see docs/meta/DOCUMENTATION.md. Significant arch/technical decisions → adr/. Other product/process/design decisions → decisions/. Diagrams → diagrams/, referenced from the doc or ADR.
  • Then implement the change

Do not introduce new dependencies, structure, or abstractions without updating documentation first.