Two files, one repository
JohnCrickett/ai-assisted-engineering ships 2 formats across 2 indexed files. The question worth asking is whether the second one says anything the first does not.
CompareAGENTS.md ↔ CLAUDE.md
| Dimension | Shared | Only in A | Only in B | Overlap |
|---|---|---|---|---|
| Sections | 0 | 2 | 3 | 0% |
| Commands | 0 | 0 | 0 | — |
| Section tags | 0 | 0 | 2 | 0% |
What each file covers
Sections
0 shared · 2 only in A · 3 only in B- − Agents.md
- − Useful Resources
- + CLAUDE.md
- + Recommended Practice
- + Documentation
Commands
neither file has anySection tags
0 shared · 0 only in A · 2 only in B- + agent-behaviour
- + docs
Line diff
JohnCrickett/ai-assisted-engineering · Guides/AGENTS.md
@@ −1 @@
1# Agents.md
2The AGENTS.md is a simple, open format for guiding coding agents.
3
4You can think of AGENTS.md as a README for coding agents: a specific, predictable place to provide context and instructions to help AI coding agents work on your project.
5
6The AGENTS.md file is often overused, many engineers and teams place too much into it and polute the context window.
7
8
9## Useful Resources
10
11[The official Agents.md website](https://agents.md/)
12
JohnCrickett/ai-assisted-engineering · Guides/CLAUDE.md
@@ +1 @@
1# CLAUDE.md
2
3The CLAUDE.md file is Anthropics way of giving Claude Code knowledge about your repository that it can carry across sessions.
4
5## Recommended Practice
6
7If you or your team uses multiple coding agents eithe symlink the CLAUDE.md to the AGENTS.md file and configure that or create a CLAUDE.md that is simply:
8
9```
10@AGENTS.md
11```
12
13## Documentation
14
15Anthropic's official documentation can be found in the [instructions and memory](https://code.claude.com/docs/en/memory) section of the Claude Code documentation.
16
@@ −1 +1 @@
1−# Agents.md
2−The AGENTS.md is a simple, open format for guiding coding agents.
1+# CLAUDE.md
32
4−You can think of AGENTS.md as a README for coding agents: a specific, predictable place to provide context and instructions to help AI coding agents work on your project.
3+The CLAUDE.md file is Anthropics way of giving Claude Code knowledge about your repository that it can carry across sessions.
54
6−The AGENTS.md file is often overused, many engineers and teams place too much into it and polute the context window.
5+## Recommended Practice
76
7+If you or your team uses multiple coding agents eithe symlink the CLAUDE.md to the AGENTS.md file and configure that or create a CLAUDE.md that is simply:
88
9−## Useful Resources
9+```
10+@AGENTS.md
11+```
1012
11−[The official Agents.md website](https://agents.md/)
13+## Documentation
14+
15+Anthropic's official documentation can be found in the [instructions and memory](https://code.claude.com/docs/en/memory) section of the Claude Code documentation.
1216
