CLAUDE.md · git:20260613.b1ea87c · 2026-06-13 · sha256 b12ad2ae83d2333a

CLAUDE.md git:20260613.b1ea87cA

Immutable. This exact content is served forever at /api/v1/blob/b12ad2ae83d2333a.

# CLAUDE.md

This repo's agent instructions live in **[`AGENTS.md`](./AGENTS.md)** — read it first.

It is the single source of truth for: what sparq is, how to USE it (the `skills/` tree),
how to work ON it (build/test/lint gate + merge discipline), the public-API → `SKILL.md`
maintenance rule, and **repository hygiene** — where every kind of output belongs:

- **Tasks / TODOs / future work → a bead** (`bd`), never a markdown `TODO`/`TODO.md`/checklist.
- **Durable knowledge → `AGENTS.md` / `CLAUDE.md` / a `skills/<surface>/SKILL.md` / a crate
  `README.md` / a `research/` design record** — whichever fits.
- **No narrative scratch docs** (`HANDOVER*.md`, `SESSION*.md`, progress logs) in the repo,
  and **no hard-coded performance numbers** in markdown.

(This file is intentionally thin so there is one source of truth. Put new content in
`AGENTS.md`, not here.)