# Agent Instructions

**The canonical agent instructions for this repository live in [`.claude/CLAUDE.md`](.claude/CLAUDE.md).**
Read that file — it is the single source of truth for how to work in wicked-garden:
conventions, v11/v12 architecture, evidence-re-derivation, delegation, code search,
memory, storage, and security.

> **Why (identity):** see [`ETHOS.md`](ETHOS.md) for what wicked-garden believes / refuses /
> optimizes for. `CLAUDE.md` is *how to act*; `ETHOS.md` is *why*.

This file is intentionally a thin pointer so there is exactly one source of truth.
Other AI coding tools (Codex, Cursor, Aider, OpenCode, Zed/ACP, …) that read `AGENTS.md`:
follow the link above to `.claude/CLAUDE.md`.