# AGENTS.md — AI agent instructions

This file follows the cross-tool `AGENTS.md` convention. It is a
**thin pointer** managed by `mgf-fed catch-up` — do not edit it;
project-specific agent notes belong in this project's `CLAUDE.md`.

**AI agents working in this project — get the canonical briefing:**

> Run **`mgf-fed agents`** and do exactly what it prints.

`mgf-common` is a dependency of this project, so that command is
always installed — it prints the single, federation-wide agent
briefing with no setup and no assumptions. It covers the federation
shape, using the library + its siblings instead of reinventing
them, the standards + the docs layout, keeping this project in sync
with `mgf-fed catch-up`, and filing feedback in the relevant
library's `FEEDBACK.md` when you hit friction so the library itself
can improve.

Then read this project's own `CLAUDE.md` (`docs/claude/CLAUDE.md`,
or `docs/CLAUDE.md` on older layouts) — its auto-managed block
carries the project-specific lookup.

**Fallback if `mgf-fed agents` fails to run** (PAPER-78 — usually
a stale editable install pointing at a renamed source tree): read
the same text from `mgf-common`'s `STARTHERE.md`, section *"For the
AI agent in any Magogi project"*. The CLI's output and that
section are kept identical by `tests/unit/cli/test_agents.py`. Open
either:

- The published source on Codeberg:
  [`mgf-common/STARTHERE.md`](https://codeberg.org/magogi-admin/mgf-common/src/branch/main/STARTHERE.md)
- The same file in your local mgf-common checkout if you have one
  (typically `~/PycharmProjects/mgf-common/STARTHERE.md`).

One message for the whole federation; no per-project variant.
