git:20260712.247ff33 to git:20260826.464e2e3

2 added, 0 removed. Audit A to A.

---

name: agents

description: Always-loaded project anchor. Read this first. Contains project identity, non-negotiables, commands, and pointer to ROUTER.md for full context.

last_updated: "2026-07-12"

---

# mex

## What This Is

<!-- One sentence. What does this project do?

Length: 1 sentence maximum.

Not a tagline — a factual description of what the software does.

Example: "A REST API for managing inventory across multiple warehouse locations." -->

## Non-Negotiables

<!-- Hard rules the agent must never violate. Not preferences — rules.

These are the things that, if broken, cause real damage to the codebase.

Length: 3-5 items. More than 5 means the list has not been prioritised.

Example:

- Never write database queries outside of the repository layer

- Never commit secrets or API keys

- Always handle errors explicitly — no silent failures -->

## Commands

- Dev: `npm run dev`

- Test: `npm test`

- Typecheck: `npm run typecheck`

- Build: `npm run build`

+ Before using MEX commands, run `mex capabilities --json` and prefer the structured reads it reports. Preview mutations first, then wait for explicit human approval before running an apply command.

## Scaffold Growth

After every task: if no pattern exists for the task type you just completed, create one. If a pattern or context file is now out of date, update it. The scaffold grows from real work, not just setup. See the GROW step in `ROUTER.md` for details.

## Navigation

At the start of every session, read `ROUTER.md` before doing anything else.

For full project context, patterns, and task guidance — everything is there.