Skip to content

Commit f786d83

Browse files
Patel230claude
andauthored
chore: drop redundant CLAUDE.md, keep AGENTS.md only (#45)
CLAUDE.md contained nothing but the generated <!-- gitnexus --> block, which is already present verbatim in AGENTS.md. Tools that read both prefer CLAUDE.md, so the stub was shadowing this repo's actual conventions. Remove it and gitignore the root path so a future `gitnexus analyze` cannot reintroduce it. Also document the post-analyze cleanup step in the gitnexus-cli skill, since analyze writes both files and has no flag to suppress one. Co-authored-by: Claude Opus 5 (1M context) <noreply@anthropic.com>
1 parent ba5f8a7 commit f786d83

3 files changed

Lines changed: 13 additions & 44 deletions

File tree

.claude/skills/gitnexus/gitnexus-cli/SKILL.md

Lines changed: 8 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -19,6 +19,14 @@ node .gitnexus/run.cjs analyze
1919

2020
Run from the project root. This parses all source files, builds the knowledge graph, writes it to `.gitnexus/`, and generates CLAUDE.md / AGENTS.md context files.
2121

22+
> **These repos are AGENTS.md-only.** `analyze` always writes both context files and has no flag to suppress one. A root `CLAUDE.md` takes precedence over `AGENTS.md` in tools that read both, and the generated `CLAUDE.md` carries only the GitNexus block — so it would shadow the repo's actual conventions. Remove it after every `analyze`:
23+
>
24+
> ```bash
25+
> rm -f CLAUDE.md
26+
> ```
27+
>
28+
> It is gitignored, so it will not slip back into a commit.
29+
2230
| Flag | Effect |
2331
| -------------- | ---------------------------------------------------------------- |
2432
| `--force` | Force full re-index even if up to date |

.gitignore

Lines changed: 5 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -60,3 +60,8 @@ registry.json
6060
.antigravitycli/
6161
.pi/
6262
.coverage
63+
64+
# Agent instructions: this repo is AGENTS.md-only.
65+
# `gitnexus analyze` regenerates a root CLAUDE.md that would shadow AGENTS.md
66+
# for tools that prefer it; keep the regenerated copy out of git.
67+
/CLAUDE.md

CLAUDE.md

Lines changed: 0 additions & 44 deletions
This file was deleted.

0 commit comments

Comments
 (0)