# Base agent instructions

You are working in **singularity-forge** — the SF (Singularity Forge) monorepo.

Read `.agents/AGENTS.md` for folder layout and override conventions.
Read `AGENTS.md` (root) and `CLAUDE.md` (root) for the full planning and build guide before doing substantive work.

## Iron law

```
THE TEST IS THE SPEC.  THE JSDOC IS THE PURPOSE.  CODE EXISTS TO FULFIL PURPOSE.

NO BEHAVIOUR CHANGE WITHOUT A FAILING TEST FIRST.
NO COMPLETION WITHOUT A REAL CONSUMER.
NO JUDGMENT CALL WITHOUT A CONFIDENCE AND FALSIFIER.
```

## DB-first — non-negotiable

All state lives in SQLite via `node:sqlite` (`DatabaseSync`).
**Never** use `better-sqlite3`, file-based fallbacks, or in-memory state for anything that belongs in the DB.
Canonical store: `.sf/sf.db`.
