Two files, one repository
Lolner95/AIGX 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 | 1 | 3 | 4 | 13% |
| Commands | 0 | 0 | 1 | 0% |
| Section tags | 0 | 0 | 1 | 0% |
What each file covers
Sections
1 shared · 3 only in A · 4 only in B- − AGENTS.md
- − The reading protocol — do this for every task
- − Keep the genome current (you are a steward of it)
- + AIGX — AI Genome Exchange
- + Before editing any file — look it up
- + Genome structure
- + Keeping the genome current
- Validate
Commands
0 shared · 0 only in A · 1 only in B- + python tools/aigx-lint/aigx_lint.py --root .
Section tags
0 shared · 0 only in A · 1 only in B- + architecture
Line diff
Lolner95/AIGX · integrations/agents/AGENTS.md
@@ −1 @@
1# AGENTS.md
2
3This repository uses **AIGX (AI Genome Exchange)** — its AI-agent rules live in a `.aigx/` directory with a
4per-file boundary index. You don't need to guess the conventions; they are in the genome. Read this section
5before editing.
6
7## The reading protocol — do this for every task
8
91. **Read `.aigx/protocol.aigx`** first — it is the authoritative reading sequence.
102. **For EACH file you will edit, open `.aigx/files.aigx`** and find its `<file path="...">` entry:
11
12 ```xml
13 <file path="src/features/auth/login.ts" domain="auth">
14 <role>Handle login — validate credentials and issue a session</role>
15 <forbid pri="CRIT">NEVER read from another tenant's session store</forbid>
16 <gotcha>token expiry is checked at read-time, not issue-time</gotcha>
17 <check>ARCH-no-deep-imports ENG-tenant-scope</check>
18 </file>
19 ```
20
21 - **`<role>`** — what this file is for; understand it before writing a line.
22 - **`<forbid pri="CRIT">`** — a hard constraint. Never violate it, no exceptions.
23 - **`<gotcha>`** — the single worst pitfall for this file; read it twice.
24 - **`<check>`** — space-separated rule ids. Look each up in its concern file and **verify they hold
25 before you finish.**
26
273. **Read the concern files your check ids reference** — `.aigx/architecture.aigx` (`ARCH-*`),
28 `.aigx/engineering.aigx` (`ENG-*`), `.aigx/data.aigx` (`DATA-*`), etc. — *before* writing code.
294. **Make the minimal change** with a local blast radius, then **verify every `<check>` id** for each file
30 you touched.
31
32## Keep the genome current (you are a steward of it)
33
34- **Rename/move a file** that has a `files.aigx` entry → update its `path="..."` in the **same change-set**.
35- **Create a new file** other agents will edit → add a `<file>` entry (at least `<role>` + one `<check>`).
36- **Rule ids are permanent** (`ARCH-no-deep-imports`, `ENG-2`, …) — never rename or delete; edit text in place.
37- **A code change that makes a rule wrong** → fix the rule text in the same change-set. The genome describes
38 reality, not history.
39
40## Validate
41
42```bash
43aigx lint # or: python tools/aigx-lint/aigx_lint.py --root .
44```
45
46> Full format: <https://github.com/Lolner95/AIGX/blob/main/standard/AIGX-1.1.md>
47
Lolner95/AIGX · integrations/claude-code/CLAUDE.md
@@ +1 @@
1## AIGX — AI Genome Exchange
2
3This repository stores its AI agent rules in `.aigx/` — a structured genome with a per-file boundary index. You do not need to guess conventions; they are in the genome.
4
5### Before editing any file — look it up
6
7Open `.aigx/files.aigx` and find the `<file path="...">` entry for the file you are about to edit:
8
9```xml
10<file path="src/features/auth/login.ts" domain="auth">
11 <role>Handle login — validate credentials and issue a session</role>
12 <forbid pri="CRIT">NEVER read from another tenant's session store</forbid>
13 <gotcha>token expiry is checked at read-time, not issue-time</gotcha>
14 <check>ARCH-no-deep-imports ENG-tenant-scope</check>
15</file>
16```
17
18- **`<role>`** — understand what this file is for before writing a line
19- **`<forbid pri="CRIT">`** — hard constraint, never violate it, no exceptions
20- **`<gotcha>`** — the single worst pitfall for this file; read it twice
21- **`<check>`** — space-separated rule ids; look each up in its concern file and verify they hold before finishing
22
23The concern files are `.aigx/architecture.aigx` (ARCH-* rules), `.aigx/data.aigx` (DATA-*), `.aigx/engineering.aigx` (ENG-*), etc. Read the ones your check ids reference **before** writing code.
24
25### Genome structure
26
27```
28.aigx/
29 protocol.aigx ← full reading sequence
30 product.aigx ← product context + freshness clause (which old docs are stale)
31 architecture.aigx ← ARCH-* architectural rules
32 engineering.aigx ← ENG-* hard-correctness invariants
33 files.aigx ← ★ per-file boundary index — look files up here
34 agent.aigx ← self-maintenance rules (this section summarises them)
35 [concern].aigx ← any other concern files present (data, auth, testing, …)
36```
37
38### Keeping the genome current
39
40**Rename/move a file** that has a `files.aigx` entry → update `path="..."` in the **same change-set**. A rename without a genome update is an incomplete change.
41
42**Create a new file** agents will edit → add a `<file>` entry in `files.aigx` with at least `<role>` + one `<check>` id. Never leave a new boundary file without an entry.
43
44**Rule ids are permanent** — `ARCH-no-deep-imports`, `ENG-2`, etc. Never rename or delete them. Update the text in-place only.
45
46**Code change makes a rule incorrect** → update the rule text in the same change-set. The genome describes reality, not history.
47
48**After renames, moves, deletes, or adds:** verify every `<file path>` in `files.aigx` still exists and every `<check>` id resolves to a real rule.
49
50**Never add entries speculatively.** One rule per real constraint. One entry per file agents actually edit.
51
52### Validate
53
54```bash
55python tools/aigx-lint/aigx_lint.py --root .
56```
57
@@ −1 +1 @@
1−# AGENTS.md
1+## AIGX — AI Genome Exchange
22
3−This repository uses **AIGX (AI Genome Exchange)** — its AI-agent rules live in a `.aigx/` directory with a
4−per-file boundary index. You don't need to guess the conventions; they are in the genome. Read this section
5−before editing.
3+This repository stores its AI agent rules in `.aigx/` — a structured genome with a per-file boundary index. You do not need to guess conventions; they are in the genome.
64
7−## The reading protocol — do this for every task
5+### Before editing any file — look it up
86
9−1. **Read `.aigx/protocol.aigx`** first — it is the authoritative reading sequence.
10−2. **For EACH file you will edit, open `.aigx/files.aigx`** and find its `<file path="...">` entry:
7+Open `.aigx/files.aigx` and find the `<file path="...">` entry for the file you are about to edit:
118
12− ```xml
13− <file path="src/features/auth/login.ts" domain="auth">
14− <role>Handle login — validate credentials and issue a session</role>
15− <forbid pri="CRIT">NEVER read from another tenant's session store</forbid>
16− <gotcha>token expiry is checked at read-time, not issue-time</gotcha>
17− <check>ARCH-no-deep-imports ENG-tenant-scope</check>
18− </file>
19− ```
9+```xml
10+<file path="src/features/auth/login.ts" domain="auth">
11+ <role>Handle login — validate credentials and issue a session</role>
12+ <forbid pri="CRIT">NEVER read from another tenant's session store</forbid>
13+ <gotcha>token expiry is checked at read-time, not issue-time</gotcha>
14+ <check>ARCH-no-deep-imports ENG-tenant-scope</check>
15+</file>
16+```
2017
21− - **`<role>`** — what this file is for; understand it before writing a line.
22− - **`<forbid pri="CRIT">`** — a hard constraint. Never violate it, no exceptions.
23− - **`<gotcha>`** — the single worst pitfall for this file; read it twice.
24− - **`<check>`** — space-separated rule ids. Look each up in its concern file and **verify they hold
25− before you finish.**
18+- **`<role>`** — understand what this file is for before writing a line
19+- **`<forbid pri="CRIT">`** — hard constraint, never violate it, no exceptions
20+- **`<gotcha>`** — the single worst pitfall for this file; read it twice
21+- **`<check>`** — space-separated rule ids; look each up in its concern file and verify they hold before finishing
2622
27−3. **Read the concern files your check ids reference** — `.aigx/architecture.aigx` (`ARCH-*`),
28− `.aigx/engineering.aigx` (`ENG-*`), `.aigx/data.aigx` (`DATA-*`), etc. — *before* writing code.
29−4. **Make the minimal change** with a local blast radius, then **verify every `<check>` id** for each file
30− you touched.
23+The concern files are `.aigx/architecture.aigx` (ARCH-* rules), `.aigx/data.aigx` (DATA-*), `.aigx/engineering.aigx` (ENG-*), etc. Read the ones your check ids reference **before** writing code.
3124
32−## Keep the genome current (you are a steward of it)
25+### Genome structure
3326
34−- **Rename/move a file** that has a `files.aigx` entry → update its `path="..."` in the **same change-set**.
35−- **Create a new file** other agents will edit → add a `<file>` entry (at least `<role>` + one `<check>`).
36−- **Rule ids are permanent** (`ARCH-no-deep-imports`, `ENG-2`, …) — never rename or delete; edit text in place.
37−- **A code change that makes a rule wrong** → fix the rule text in the same change-set. The genome describes
38− reality, not history.
27+```
28+.aigx/
29+ protocol.aigx ← full reading sequence
30+ product.aigx ← product context + freshness clause (which old docs are stale)
31+ architecture.aigx ← ARCH-* architectural rules
32+ engineering.aigx ← ENG-* hard-correctness invariants
33+ files.aigx ← ★ per-file boundary index — look files up here
34+ agent.aigx ← self-maintenance rules (this section summarises them)
35+ [concern].aigx ← any other concern files present (data, auth, testing, …)
36+```
3937
40−## Validate
38+### Keeping the genome current
4139
40+**Rename/move a file** that has a `files.aigx` entry → update `path="..."` in the **same change-set**. A rename without a genome update is an incomplete change.
41+
42+**Create a new file** agents will edit → add a `<file>` entry in `files.aigx` with at least `<role>` + one `<check>` id. Never leave a new boundary file without an entry.
43+
44+**Rule ids are permanent** — `ARCH-no-deep-imports`, `ENG-2`, etc. Never rename or delete them. Update the text in-place only.
45+
46+**Code change makes a rule incorrect** → update the rule text in the same change-set. The genome describes reality, not history.
47+
48+**After renames, moves, deletes, or adds:** verify every `<file path>` in `files.aigx` still exists and every `<check>` id resolves to a real rule.
49+
50+**Never add entries speculatively.** One rule per real constraint. One entry per file agents actually edit.
51+
52+### Validate
53+
4254 ```bash
43−aigx lint # or: python tools/aigx-lint/aigx_lint.py --root .
55+python tools/aigx-lint/aigx_lint.py --root .
4456 ```
45−
46−> Full format: <https://github.com/Lolner95/AIGX/blob/main/standard/AIGX-1.1.md>
4757
