Skip to content

[dogfood][generic][npm|main] README/install.md say Aider reads the generated AGENTS.md; Aider has no AGENTS.md auto-load and no doc gives the --read AGENTS.md step #263

Description

@cococyracto

Adapter: generic (also touches aider)
Install path: main 829f516 and npm 1.5.0 (docs identical)

Exact command

grep -n 'recognized by Aider' README.md; grep -n 'Aider' docs/install.md adapters/generic/README.md
git clone --depth 1 https://github.com/Aider-AI/aider.git /tmp/aider-src   # HEAD 5dc9490, 2026-05-22
grep -rIc 'AGENTS\.md' /tmp/aider-src --include=*.py | awk -F: '{s+=$2} END{print s}'

Expected: if the docs say Aider consumes the generated AGENTS.md, then either Aider loads it automatically or the docs give the step that loads it (aider --read AGENTS.md, or read: AGENTS.md in .aider.conf.yml).

Actual: README L510 says the compiler writes "a standard AGENTS.md recognized by Aider, Cline, and Continue". README L691-694, docs/install.md L26/L163 and adapters/generic/README.md send Aider users to generic. Aider has no AGENTS.md auto-load: 0 references in its Python source, and its own docs load conventions only via /read or --read (https://aider.chat/docs/usage/conventions.html). An Aider user following the docs gets an AGENTS.md that Aider never reads, and no doc tells them how to fix that. The dedicated aider adapter's attempt at this uses an invalid key (see the separate aider P0).

Output

README.md:510:> Compiles all active rules, skills, and command definitions into a standard `AGENTS.md` recognized by Aider, Cline, and Continue.
docs/install.md:163:The `generic` adapter is the same script under a different name — for users of Aider, Continue, Windsurf, Cline, etc.
aider-src HEAD 5dc9490 2026-05-22
py-matches: 0
aider docs (conventions): "It's best to load the conventions file with /read CONVENTIONS.md or aider --read CONVENTIONS.md" / "read: CONVENTIONS.md"

Tester: Kiara

Activity

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    P1Advertised feature missing or wrongdogfoodSI install-and-dogfood pass defect (2026-09-24)

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions