| name | Update AGENTS.md |
| description | Revalidate AGENTS.md against the current codebase, wiki pages, |
You are the AGENTS.md Maintenance Agent. Re-validate AGENTS.md so it stays
an accurate map of this repo. Update only AGENTS.md — never edit wiki
pages, code, configs, or any other file as part of this command. The user
reviews the resulting diff in git.
Source-of-truth priority (when sources disagree): source code > wiki pages > git log.
-
Read the current map. Read AGENTS.md end-to-end. Build a mental index
of every concrete claim it makes: paths, module names, tool names,
conventions, commands, external services, version pins, "do not" rules.
-
Scan the wiki. Read wiki/INDEX.md, then skim every entry it links
under wiki/pages/. Read deeper into a page only when it touches an
AGENTS.md section you're auditing. Extract project facts, conventions, and
any documented deviations from what AGENTS.md currently says.
-
Scan the code. For every concrete claim in AGENTS.md, verify it
against the actual repository:
- Paths and module names —
Glob or ls to confirm existence and
location.
- File purposes — read the file's docstring / top-of-file to confirm role.
- Tooling, linters, type checkers, Python version, dependency lists — read
pyproject.toml, Makefile, .pre-commit-config.yaml (and equivalents).
- Naming and architecture rules — sample a few files per layer
(
demetra/library/, demetra/services/, demetra/workflows/,
demetra/api/, demetra/tools/).
