# One instructions file

> Write your project instructions once in AGENTS.md, and every agent reads them.

Source: https://docs.neurosquad.ai/en/agents/instructions

Agent programs read project instructions from different files: Codex and many others read
`AGENTS.md`, Claude Code reads `CLAUDE.md`, Qwen Code reads `QWEN.md`, Gemini reads `GEMINI.md`.
Keeping them all in sync by hand is tedious.

NeuroSquad lets you keep **one** file — `AGENTS.md` — and mirrors it to `CLAUDE.md`, `GEMINI.md` and
`QWEN.md`.

**1. Open the workspace's edit dialog**

The **Instructions file** section lists each file with its state: **Missing**, **In sync** or
**Differs**.

**2. Tick the files to mirror**

Choose **Copy** (a full copy) or **@import** (a short file that points at `AGENTS.md`), then
press **Write**.

If a file already has different content, NeuroSquad never overwrites it silently: **Review…** shows
you exactly what would change, and only **Overwrite** replaces it.

No `AGENTS.md` yet? **Create AGENTS.md from** an existing file, such as your `CLAUDE.md`.