aider/codex AGENTS.md: embedded rule bodies add top-level ## headings (two "## Commands" sections)
Maintainers usually reply within 1 day
Nobody has claimed this yet.
Assessment
- Difficulty
- 2/5
- Estimated time
- 1-3 hours
- Newbie friendliness
- 76/100
- Issue type
- Bug
- Clarity
- Clearly specified
- Activity status
- Active
- Tech stack
- bash
- Domain
- cli
Research direction
Start with adapters/codex/install.sh, which compiles the embedded rule bodies into AGENTS.md, and inspect the template that adds the second ## Commands section. Reproduce with HOME=$(mktemp -d) bash install.sh --adapter aider in an empty project folder, then check the generated headings. Done means embedded headings no longer appear as duplicate top-level sections for both aider and codex output.
Written by the indexing model from the issue text.
Description
What happens
bash install.sh --adapter aider writes an AGENTS.md whose sections are ambiguous. The file is compiled by adapters/codex/install.sh, which embeds the full body of each rule (and the memory template some rules include) under ## Rules as ### <rule-name> sections. Those bodies keep their own top-level ## headings, for example ## Commit Message Format or ## Standard Project Structure. One embedded template even adds a second ## Commands section with - Dev: / - Build: / - Test: placeholders.
As a result:
- anything that reads
AGENTS.mdby##section (an agent, a script, a person skimming the outline) sees the## Rulessection end after its first rule and finds two## Commandssections; - the installer receipt counts rules by
### namelines, so the receipt is right, but a naive##-section count of commands or rules is not.
Codex users get the same file, so this likely applies to --adapter codex too.
How to see it
HOME=$(mktemp -d) bash install.sh --adapter aider # run from an empty project folder
grep -n '^## Commands' AGENTS.md # prints two lines
Suggested fix
Demote the headings inside embedded bodies by two levels (## becomes ####) when compiling, or fence each embedded body so its headings are not part of the outline. A check in CI that AGENTS.md has each top-level section exactly once would keep it that way.
- Dominant language
- HTML
- Stars
- 347
- Forks
- 12
- Avg merge
- 2d 16h
- Merged PRs (30d)
- 95
Getting set up
First steps
- Read the whole issue, then the project's contributing guide.
- Comment on the issue to say you are picking it up — it saves two people doing the same work.
- Fork the repository and make your change on a branch.
- Open a pull request that references the issue number.
More from coco-research/coco
-
bug P2
Difficulty 2/5 1-3 hours Newbie friendliness 72/100
coco-research/coco#539 ·
Maintainers usually reply within 1 day
-
bug P2
Difficulty 2/5 1-3 hours Newbie friendliness 78/100
coco-research/coco#538 ·
Maintainers usually reply within 1 day
-
bug P2
Difficulty 2/5 1-3 hours Newbie friendliness 80/100
coco-research/coco#537 ·
Maintainers usually reply within 1 day
-
bug
Difficulty 2/5 1-3 hours Newbie friendliness 72/100
coco-research/coco#530 ·
Maintainers usually reply within 1 day
-
check-asset-counts: bare 149 tripwire collides with a real active-assets count of 149Possibly taken @aryankalantri claimed this 1 day ago. Openbug
Difficulty 2/5 1-3 hours Newbie friendliness 78/100
coco-research/coco#473 ·
Maintainers usually reply within 1 day
All issues in coco-research/coco
Similar issues
-
area: cli beginner beginner friendly bug community difficulty: easy dx easy first-timers-only good first issue hacktoberfest help wanted low-hanging fruit mentor available priority: P3 severity: low tech: typescript testing up-for-grabs ux
Difficulty 2/5 1-3 hours Newbie friendliness 82/100
Maintainers usually reply within 1 day
-
Difficulty 2/5 1-3 hours Newbie friendliness 80/100
Maintainers usually reply within 1 day
-
A new VOLTTRON_HOME starts with agent isolation mode on (string comparison of a boolean default)Open
Difficulty 2/5 1-3 hours Newbie friendliness 68/100
-
Difficulty 2/5 1-3 hours Newbie friendliness 62/100
janitor-team/janitor#2590 ·
Maintainers usually reply within 1 day
-
Difficulty 2/5 1-3 hours Newbie friendliness 72/100
karmada-io/karmada#8110 ·
Maintainers usually reply within 1 day