| Dimension | Shared | Only in A | Only in B | Overlap |
|---|---|---|---|---|
| Sections | 1 | 4 | 3 | 13% |
| Commands | 0 | 1 | 0 | 0% |
| Section tags | 0 | 1 | 0 | 0% |
What each file covers
Sections
1 shared · 4 only in A · 3 only in B- − AIGX — AI Genome Exchange
- − Before editing any file — look it up
- − Genome structure
- − Keeping the genome current
- + AGENTS.md
- + The reading protocol — do this for every task
- + Keep the genome current (you are a steward of it)
- Validate
Commands
0 shared · 1 only in A · 0 only in B- − python tools/aigx-lint/aigx_lint.py --root .
Section tags
0 shared · 1 only in A · 0 only in B- − architecture
Line diff
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
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
@@ −1 +1 @@
1−## AIGX — AI Genome Exchange
1+# AGENTS.md
22
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.
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.
46
5−### Before editing any file — look it up
7+## The reading protocol — do this for every task
68
7−Open `.aigx/files.aigx` and find the `<file path="...">` entry for the file you are about to edit:
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:
811
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−```
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+ ```
1720
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
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.**
2226
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.
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.
2431
25−### Genome structure
32+## Keep the genome current (you are a steward of it)
2633
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−```
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.
3739
38−### Keeping the genome current
40+## Validate
3941
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−
5442 ```bash
55−python tools/aigx-lint/aigx_lint.py --root .
43+aigx lint # or: python tools/aigx-lint/aigx_lint.py --root .
5644 ```
45+
46+> Full format: <https://github.com/Lolner95/AIGX/blob/main/standard/AIGX-1.1.md>
5747
