# AGENTS.md — {{PROJECT_NAME}}

> Template generated by `harness` on {{TODAY}}.
> For agents OTHER than Claude Code (Codex, Cursor, Aider, etc.), this
> file is the first read. For Claude Code, see `CLAUDE.md` (both files
> are aligned, but `CLAUDE.md` may have Claude-specific runtime details).

## Workspace

Multi-repo orchestrated at the root level. Each subproject is an
independent Git repo. The root is NOT a repo.

## Quick map

| Path | Role |
|------|------|
{{SUBPROJECT_ROWS}}
| `01-TOOLS/` | Operational tooling per external provider. |
| `02-DOCS/` | LLM wiki (`raw/` + `wiki/` + `index.md` + `log.md`). |

## Minimum rules

1. **Before editing a subproject**: `git -C <subproject> status --short`.
2. **Do not commit without asking**.
3. **Do not touch `01-TOOLS/**/.env`**. These are real credentials.
4. **Do not touch generated outputs**: `node_modules/`, `.venv/`,
   `.next/`, `__pycache__/`, `.dart_tool/`, `build/`.
5. **To add a new external tool**, use `01-TOOLS/_TEMPLATE/`.
6. **For reusable documentation**, write to `02-DOCS/raw/<topic>/` and
   compile in `02-DOCS/wiki/<topic>/`. The protocol lives in
   `harness/references/wiki-protocol.md` (embedded in the
   skill).

## Per-subproject commands

{{SUBPROJECT_COMMANDS}}

## Differences from `CLAUDE.md`

If there are any, they're documented here. By default both files cover
the same rules.
