# Root `AGENTS.md` Template

Use this structure for the `AGENTS.md` at the root of the current Git working tree.

## Recommended Shape

```md
# Root Entry

- State that this file is the root entry for the repository's `agent-docs`.
- Define the default path basis.

# Common Constraints

- Keep repository-wide rules here.
- Do not repeat topic-specific rules that belong in child docs.

# Read Required `agent-docs` Before Editing

- List the required `agent-docs` explicitly.
- Use explicit "Read and follow ..." wording.
```

## Notes

- Keep this file short.
- Treat this file as an instruction document, not a passive index.
- Reference child docs only when they are actually needed.
- When referring to child docs, write repository-relative paths in backticks such as `agent-docs/example.md`, not Markdown links or machine-local absolute filesystem paths.
- Do not turn the root file into a dump of all topic-specific rules.