From e91594d6e4314c9b083d0a73214cbe2e66b7bd60 Mon Sep 17 00:00:00 2001 From: Lakshman Patel Date: Sat, 19 Sep 2026 02:49:27 +0530 Subject: [PATCH] chore: drop redundant CLAUDE.md, keep AGENTS.md only CLAUDE.md contained nothing but the generated 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. Co-Authored-By: Claude Opus 5 (1M context) --- .gitignore | 5 +++++ CLAUDE.md | 44 -------------------------------------------- 2 files changed, 5 insertions(+), 44 deletions(-) delete mode 100644 CLAUDE.md diff --git a/.gitignore b/.gitignore index b3ce8aec..44c3c9b3 100644 --- a/.gitignore +++ b/.gitignore @@ -53,3 +53,8 @@ rho-sec105b.log # Compiled Go test binaries *.test + +# Agent instructions: this repo is AGENTS.md-only. +# `gitnexus analyze` regenerates a root CLAUDE.md that would shadow AGENTS.md +# for tools that prefer it; keep the regenerated copy out of git. +/CLAUDE.md diff --git a/CLAUDE.md b/CLAUDE.md deleted file mode 100644 index bd05494f..00000000 --- a/CLAUDE.md +++ /dev/null @@ -1,44 +0,0 @@ - -# GitNexus — Code Intelligence - -This project is indexed by GitNexus as **rho** (97743 symbols, 322940 relationships, 300 execution flows). Use the GitNexus MCP tools to understand code, assess impact, and navigate safely. - -> Index stale? Run `node .gitnexus/run.cjs analyze` from the project root — it auto-selects an available runner. No `.gitnexus/run.cjs` yet? `npx gitnexus analyze` (npm 11 crash → `npm i -g gitnexus`; #1939). - -## Always Do - -- **MUST run impact analysis before editing any symbol.** Before modifying a function, class, or method, run `impact({target: "symbolName", direction: "upstream"})` and report the blast radius (direct callers, affected processes, risk level) to the user. -- **MUST run `detect_changes()` before committing** to verify your changes only affect expected symbols and execution flows. For regression review, compare against the default branch: `detect_changes({scope: "compare", base_ref: "main"})`. -- **MUST warn the user** if impact analysis returns HIGH or CRITICAL risk before proceeding with edits. -- When exploring unfamiliar code, use `query({search_query: "concept"})` to find execution flows instead of grepping. It returns process-grouped results ranked by relevance. -- When you need full context on a specific symbol — callers, callees, which execution flows it participates in — use `context({name: "symbolName"})`. -- For security review, `explain({target: "fileOrSymbol"})` lists taint findings (source→sink flows; needs `analyze --pdg`). - -## Never Do - -- NEVER edit a function, class, or method without first running `impact` on it. -- NEVER ignore HIGH or CRITICAL risk warnings from impact analysis. -- NEVER rename symbols with find-and-replace — use `rename` which understands the call graph. -- NEVER commit changes without running `detect_changes()` to check affected scope. - -## Resources - -| Resource | Use for | -|----------|---------| -| `gitnexus://repo/rho/context` | Codebase overview, check index freshness | -| `gitnexus://repo/rho/clusters` | All functional areas | -| `gitnexus://repo/rho/processes` | All execution flows | -| `gitnexus://repo/rho/process/{name}` | Step-by-step execution trace | - -## CLI - -| Task | Read this skill file | -|------|---------------------| -| Understand architecture / "How does X work?" | `.claude/skills/gitnexus/gitnexus-exploring/SKILL.md` | -| Blast radius / "What breaks if I change X?" | `.claude/skills/gitnexus/gitnexus-impact-analysis/SKILL.md` | -| Trace bugs / "Why is X failing?" | `.claude/skills/gitnexus/gitnexus-debugging/SKILL.md` | -| Rename / extract / split / refactor | `.claude/skills/gitnexus/gitnexus-refactoring/SKILL.md` | -| Tools, resources, schema reference | `.claude/skills/gitnexus/gitnexus-guide/SKILL.md` | -| Index, status, clean, wiki CLI commands | `.claude/skills/gitnexus/gitnexus-cli/SKILL.md` | - -