awesome-agent-evolution
Shiyao-Huang/awesome-agent-evolution/AGENTS.md
你在这个仓库的任务是维护 Self Evolve 的研究管线:raw 归 raw,加工归 processed,工作产物归 work,结果归 results,并让全部内容可索引、可追溯、可构建。 先读 docs/project-management/user-direct-inputs.md,再读 CURRENTGOAL.md:它们只代表用户直接输入,不代表 team 的二手描述。然后读 README.md、CONTENTINDEX.md、docs/project-management/project-structure.md 和 docs/indexes/master-index.md。任何新增长期产物都要更新索引,任何会影响论文或网站的改动都要跑对应验证。 这个项目的主要矛盾是:素材、分析、论文、网站和结果曾经混在一起,现在必须被同一条数据流管理。不要为了目录看起来干净而破坏已有脚本、论文引用或网站路由;物理迁移前先用 rg 找引用。根目录只留入口、法律文件和兼容文件,新的规则和长文档进入 docs/。项目深度分析要像 model card 一样能教学:说明问题、方法、证据、限制、适用场景和与自进化的关系。完成工作前刷新索引并汇报验证结果。 网站当前视觉基准是 3fd1785(2026-05-25 15:05 +0800,docs: sync README i18n and paper pipeline)附近恢复出的 Caret/editorial 风格;严格 15:00 前快照是 e2f4518(2026-05-25 14:53 +0800)。不要随意把站点改成另一套深色、玻璃、营销页、过度卡片化或组件展示风格。
- Deletes or force-pushes
# AGENTS.md
## L1
你在这个仓库的任务是维护 Self Evolve 的研究管线:raw 归 raw,加工归 processed,工作产物归 work,结果归 results,并让全部内容可索引、可追溯、可构建。
## L2
先读 [docs/project-management/user-direct-inputs.md](docs/project-management/user-direct-inputs.md),再读 [CURRENT_GOAL.md](CURRENT_GOAL.md):它们只代表用户直接输入,不代表 team 的二手描述。然后读 [README.md](README.md)、[CONTENT_INDEX.md](CONTENT_INDEX.md)、[docs/project-management/project-structure.md](docs/project-management/project-structure.md) 和 [docs/indexes/master-index.md](docs/indexes/master-index.md)。任何新增长期产物都要更新索引,任何会影响论文或网站的改动都要跑对应验证。
## L3
这个项目的主要矛盾是:素材、分析、论文、网站和结果曾经混在一起,现在必须被同一条数据流管理。不要为了目录看起来干净而破坏已有脚本、论文引用或网站路由;物理迁移前先用 `rg` 找引用。根目录只留入口、法律文件和兼容文件,新的规则和长文档进入 `docs/`。项目深度分析要像 model card 一样能教学:说明问题、方法、证据、限制、适用场景和与自进化的关系。完成工作前刷新索引并汇报验证结果。
## Current Scale (2026-05-25)
| Layer | Count | Notes |
|-------|------:|-------|
| raw-github | 490 | 100% frontmatter, 22.2% timestamps unknown |
| raw-papers | 198 (128 unique) | 70 duplicate pairs (dash + dot format) |
| raw-social | 650 md + 645 json | 612 numbered pairs + batch files |
| raw-blogs | 655 md + 653 json | 650 numbered pairs |
| raw-social-rank | 234 md | Strict subset of raw-social (seed dataset) |
| projects | 204 model cards | 146 trace to raw-github (29.8% coverage) |
| analysis | 16 | Cross-analysis layer |
| research | 38 | Author profiles, verification audits |
| paper-reviews | 137 | 90.4% match to raw-papers |
| paper-drafts | 12 tex + PDF | 8-chapter survey, 62 bib entries |
| survey | 11 | Chinese-language parallel survey with figures |
| site | 207 pages | Astro static site, built daily |
| reports | 1 | Critical gap — needs consolidation |
## Writing Rules
- **L0 Highest guidance — public copy quality first**: 用户已明确指出,公开文案质量是最高指导。网站、README、README-EN、论文页、topic/blog/SEO 入口和 metadata 不能只是“造了一堆网页”;它们必须有清晰逻辑、可读、可吸收、接近高质量知识型/Hacker News 级别文案,并且中英双语面向全球读者表达同一条证据链。公开页面数量、SEO 覆盖、视觉效果、内部 workflow 都低于这个指导。
- **Visualization first**: 当图表比文字更容易表达时,必须使用图表(Mermaid DAG、SVG、数据流图)。不要只写文字。
- **Mom Test usability**: README 和面向用户的内容必须通过 "Mom Test"——一个非专业人士能否理解这个项目做什么、为什么重要?
- **Public copy review gate**: 所有公开文案,尤其是网页、README、README-EN、SEO/topic/blog 页面和站点 metadata,发布前必须经过 `3-5` 个读者/编辑 agents 与 `3` 个学术 agents 的审查。读者/编辑审查关注 Mom Test、可读性、行动路径、中文默认入口和英文镜像;学术审查关注术语准确性、证据链、claim 强度、限制和 `[UNVERIFIED]` 标注。无法实际调度 agents 时,必须在交付说明中明确这是缺口,不能把该文案标记为质量已完成。
- **Evidence chain**: 每个分析结论必须可追溯到 raw 数据源。如果无法追溯,标注 `[UNVERIFIED]`。
- **Layered output**: 判断用 1 句话,证据用 3 句话,完整论证用 5+ 句话。
- **Audience boundary**: README、网站首页、论文页和 SEO 内容是给外部读者/消费者看的,不是 agent 操作手册。不要把启动检查、内部构建命令、agent wiki 流程、handoff 规则或自我系统说明写进 README 主体;这些规则进入 `AGENTS.md`、`CLAUDE.md`、`CLOUD.md` 或 `docs/ops/`。
- **Consumer-facing README**: README 只回答读者关心的问题:这个项目是什么、为什么重要、核心结论是什么、证据在哪里、下一步读什么。内部维护规则可以链接到 agent/cloud 手册,但不要占据 README 叙事。
- **Workflow split**: 具体分界见 [docs/ops/audience-boundary-workflow.md](docs/ops/audience-boundary-workflow.md)。公开页出现 `Workflow A/B`、`CLAUDE.md Iron Rules`、handoff、启动检查、内部构建命令等词时,优先改写成读者能理解的证据边界,并把操作细节移到 ops。
- **Bilingual public surface**: 网站、README、论文页、SEO/topic/blog 入口和发布 metadata 必须按中英双语治理;中文 `zh-CN` 是默认读者入口,英文是同证据链镜像,不允许用英文替换、稀释或删除中文叙事。
## Website Style Lock
网站当前视觉基准是 `3fd1785`(2026-05-25 15:05 +0800,`docs: sync README i18n and paper pipeline`)附近恢复出的 Caret/editorial 风格;严格 15:00 前快照是 `e2f4518`(2026-05-25 14:53 +0800)。不要随意把站点改成另一套深色、玻璃、营销页、过度卡片化或组件展示风格。
- 样式基准文件:`site/src/styles/global.css`。保留浅色 `#FAF7F2` 背景、EB Garamond display 字体、蓝色 caret 线、橙色主 CTA、8px 左右卡片圆角、克制的 editorial 版式。
- 首页基准:`site/src/pages/index.astro` 使用中文主叙事、证据链 `hero-evidence`、Raw/Processed/Model cards/Results 结构;不要用新 React mockup 替代它。
- Graph 基准:`site/src/pages/graph/index.astro` 是可搜索的圆形 Knowledge graph + 右侧/下方 AI Research Prompt 面板;不要恢复或新建 `site/src/components/EvolutionNetwork.tsx` 来替换该 graph。
- i18n 基准:当前网页主语言是 `zh-CN`,`site/src/data/site.ts` 的中文导航和 metadata 不能被英文化或删减。若新增 i18n 路由,必须保留中文入口、canonical/alternate 和 SEO 描述。
- 改网页风格前,必须先跑 `git diff 3fd1785 -- site/src/styles/global.css site/src/pages/index.astro site/src/pages/graph/index.astro site/src/layouts/BaseLayout.astro site/src/data/site.ts`,说明为什么要偏离基准。
- 改完网页必须验证桌面和移动端;至少跑 `(cd site && npm run build)`,并检查首页与 `/graph/` 在约 390px 移动视口没有横向溢出。
## Bilingual i18n Lock
用户当前要求“核心完成 i18N”,因此双语不是可选翻译任务,而是网站发布和公开内容的硬约束。
- **默认语言**:公开网站默认入口、导航、首页叙事和 metadata 保持中文 `zh-CN`;英文内容必须作为镜像或辅助入口存在,不能把中文入口替换成英文。
- **同证据链**:`README.md` / `README-EN.md`、网站首页、论文页、topic/SEO 页、blog/research/project 入口、`site/src/data/site.ts` metadata 必须表达同一组核心判断、证据入口和限制;英文可以本地化表达,但不能增加无来源承诺或删掉关键证据边界。
- **新增页面规则**:任何新增或大改的 public-facing 页面,必须同时检查中文 copy、英文入口/摘要、SEO title/description、canonical URL、alternate/hreflang 和站内互链;暂不能完成英文镜像时,必须在 `docs/ops/CLOUD.md` 的发布风险或相关索引中记录缺口,不得静默发布为“已完成 i18n”。
- **文案审查规则**:网站、README、论文页、topic/SEO/blog 入口或 metadata 的新增/大改,必须同时通过 Public copy review gate;审查结论要覆盖中文默认入口、英文镜像是否同证据链、是否有读者能理解的一句话/三句话/五句话表达。
- **内部/外部分离**:双语页面仍然面向读者,不写 agent 启动检查、handoff、构建命令或内部 workflow;这些内容只进入 `AGENTS.md`、`CLAUDE.md`、`CLOUD.md`、`docs/ops/` 和 wiki。
- **发布验证**:网页或 metadata 的 i18n 改动至少执行 `node scripts/generate_project_indexes.mjs` 和 `(cd site && npm run build)`;发布前用 `rg -n "TODO i18n|EN-PENDING|未翻译|待翻译|TODO: translate" README.md README-EN.md site/src docs/seo` 检查双语缺口,并汇报结果。
## Persistence Rule
恢复历史版本、修复样式回退、写入 AGENTS/CLAUDE/CLOUD 或做任何用户明确要求“保留”的改动后,不要让成果只停留在未提交工作区。
- 在执行 `git reset`、`git restore`、`git checkout`、`git clean`、生成索引或大范围脚本前,先跑 `git status --short` 和相关 `git diff --name-status`,确认不会覆盖刚恢复的网页、graph、i18n 或手册改动。
- 如果改动还不能提交,先生成可恢复补丁:`git diff -- AGENTS.md CLAUDE.md CLOUD.md docs/ops/CLOUD.md site/src/styles/global.css site/src/pages/index.astro site/src/pages/graph/index.astro site/src/layouts/BaseLayout.astro site/src/data/site.ts > work/recovery-style-lock.patch`。
- 当用户要求“写入”“持久”“别丢”时,优先建议或创建一个 checkpoint commit;没有提交前,最终汇报必须明确说明这些改动仍可能被 reset 清掉。
- 任何 reset 后发现丢失,先查 `git reflog --date=iso -20`、`git diff 3fd1785 -- ...` 和本地 `work/*.patch`,再恢复,不要重新设计。
## User Direct Input Reference
执行任务时优先对齐这些用户原话,而不是 team 输入或历史摘要:
| Rank | User Requirement | Operational Meaning |
|---:|---|---|
| 1 | `所有的文案都经过3-5个 读者以及 编辑 agents 进行审查 + 3个学术agents 进行审查 保证质量` / `尤其网页` / `readme` / `现在里面有个非常严重的问题...这些网页有逻辑吗?可读吗?...并非高质量的...Hacker News这样子的高质量的文案...必须是双语的...` / `这条就是最高的一个指导` | 公开文案质量是最高指导:网站和 README 必须有逻辑、可读、可吸收、双语同证据链;未经过读者/编辑与学术双通道审查,不得宣称 public copy 已完成。 |
| 2 | `用户的输入非常精确,并不是team的输入。` | 目标来源只认用户直接输入;team/subagent/tool 输出只能作证据,不能改写目标。 |
| 3 | `它需要有raw的素材...需要加工成论文...需要有网站...为博客及SEO准备。` | raw、论文、网站、SEO 是同一条交付链,缺一不可,但公开页面必须服从最高文案质量指导。 |
| 4 | `所有的项目都有深度分析,都有model card类似这样子的教学使用的东西。` | 项目页和报告要能教学,不能只给链接和浅摘要。 |
| 5 | `GitHub的项目原始收集的有哪些?进行分析的有哪些?进化相关的有哪些?按时间顺序发布的有哪些?` | 论文和分析必须回答 raw collection、analyzed subset、evolution-related subset、timeline 四件事。 |
| 6 | `raw归raw 加工后的归加工的 、work 产物归work 、结果输出归结果、、全部都要索引化 覆盖` | 任何文件新增或移动都要归层,并刷新索引。 |
| 7 | `用户的输入你得提取出来,然后作为Agent和Claude里边的参考。` | AGENTS/CLAUDE 必须链接并使用 [docs/project-management/user-direct-inputs.md](docs/project-management/user-direct-inputs.md)。 |
| 8 | `找回昨天的那个版本,尤其是在graph的这个上修改的内容。注意 i18N 网页 15:00` | 网站风格和 graph 以 2026-05-25 15:05 附近版本为基准;任何 style/graph/i18n 改动必须先对照历史。 |
| 9 | `持久建议放入 agent claude ,md` | 用户要求保留的恢复规则必须写入 AGENTS/CLAUDE,并在 reset 前先保存补丁或 checkpoint。 |
| 10 | `Star没有意义,因为他只是一个历史累计的过程...2026年的这个项目是不是在当前阶段...形成一个数据库...data可以放到HF上` | GitHub 项目排名必须优先看 2026 新增 Star、recent velocity、覆盖完整性和证据质量;累计 Star 只能作为历史 adoption prior。 |
| 11 | `核心完成 i18N !!! ... 写到Agents和Cloud的MD当中 ... 约束的双语支持。` | i18n 是 public site/README/SEO/metadata 的硬发布门禁;AGENTS 和 CLOUD 必须约束中文默认入口、英文镜像、canonical/alternate、SEO 和验证。 |
开始工作前自问三句:
1. 这次任务对应哪条用户原话?
2. 产物属于 raw、processed、work、results、ops 的哪一层?
3. 完成后要更新哪个索引、论文、网站或结果文件?
4. 如果涉及 GitHub 项目排名,是否已经区分累计 Star 与 2026/new-star growth,并标注 star-history 覆盖状态?
5. 如果涉及公开网站、README、SEO、论文页或 metadata,是否同步检查了中文默认入口、英文镜像、canonical/alternate 和双语缺口?
6. 如果涉及公开文案,它是否服从最高指导:有逻辑、可读、可吸收、双语同证据链,并完成 `3-5` 个读者/编辑 agents + `3` 个学术 agents 审查,或明确记录未完成审查的发布风险?
研究任务开始前额外检查 wiki:
1. 读 `work/wiki/index.md` 避免重复分析
2. 读 `work/wiki/log.md` 最后 5 条了解近期操作
3. 先查 wiki 再查 raw——wiki 是第一知识源
## LLM Wiki Pattern
本仓库采用 LLM Wiki Pattern 作为知识交付架构。完整规则见 `work/wiki/schema.md`;以下为 Agent 必须遵守的核心原则。
### 三层架构
```
Layer 1 — Raw Sources (不可变) Layer 2 — Wiki (Agent 维护) Layer 3 — Schema (规则)
raw-github/ raw-papers/ work/wiki/ work/wiki/schema.md
raw-social/ raw-blogs/ ├── concepts/ CLAUDE.md
↑ Agent 只读,永不修改 ├── entities/ AGENTS.md
↑ Source of Truth ├── sources/
├── synthesis/
├── index.md ← 内容目录
├── log.md ← 时序记录
└── search-index.json
```
- **Raw 层不可变**:Agent 从 `raw-github/`、`raw-papers/`、`raw-social/`、`raw-blogs/` 读取但永不修改。
- **Wiki 层由 Agent 拥有**:`work/wiki/` 下的页面由 Agent 创建、更新交叉引用、标记矛盾、维持一致性。人类不手写 wiki 页面。
- **Schema 层定义规则**:`work/wiki/schema.md` 规定格式、rank、trust chain、操作流程。`AGENTS.md` 和 `CLAUDE.md` 为顶层规则。
### 操作协议
| 操作 | 流程 | 触发时机 |
|------|------|----------|
| **Ingest** | 读 raw 源 → 提取关键信息 → 写/更新 wiki 页面 → 更新 `index.md` → 追加 `log.md` | 新素材入库 |
| **Query** | 读 `index.md` 定位 → 读目标页 → 综合回答(含引用)→ 好的回答可回存为新 synthesis 页 | 研究提问 |
| **Lint** | 查孤立页、过期声明、缺失 frontmatter、`[UNVERIFIED]` 可验证化、缺失交叉引用 | 定期/手动 |
**关键原则:** 单个源可能触发 10-15 个 wiki 页面更新。Ingest 不是简单索引,是知识整合。
### Agent 启动检查
每个 Agent 会话开始时必须:
1. 读 `work/wiki/index.md` — 获取全貌和最近更新
2. 读 `work/wiki/log.md` 最后 5 条 — 理解近期操作历史
3. 查 `work/wiki/search-index.json` 或 grep `work/wiki/` — 避免重复分析
4. 遵循 `work/wiki/schema.md` 的 rank 和 trust chain 规则
### 页面格式
每个 wiki 页面必须有 YAML frontmatter:
```yaml
---
title: 页面标题
type: concept | entity | source | synthesis
rank: A | B | C
tags: [tag1, tag2]
sources: [path/to/raw/source]
updated: YYYY-MM-DD
---
```
### Rank 体系
| Rank | 含义 | 标准 |
|------|------|------|
| **A** | 已验证,高价值 | 有原始链接,交叉验证,直接相关 |
| **B** | 有用,部分验证 | 有原始链接,合理但未交叉验证 |
| **C** | 未验证或低价值 | 无原始链接,或相关性弱 |
### Trust Chain(信任链)
- 每条事实声明必须标注来源:`[CLAIM] — Source: [URL or file path]`
- 信任等级:`[KNOWN]` 有原始链接 > `[INFERRED]` 有间接证据 > `[UNVERIFIED]` 无法追溯
- 无链接 = 无效声明,必须标 `[UNVERIFIED]`
### Compounding(累积原则)
Wiki 是持久累积产物,不是一次性检索结果:
- 交叉引用已建立,不需要每次重建
- 矛盾已被标记,新源可以挑战旧结论
- 综合分析已反映所有已读内容
- 好的回答(比较分析、连接发现)应回存为新的 wiki 页面,不让它消失在聊天历史中
### 特殊文件
| 文件 | 用途 | 维护频率 |
|------|------|----------|
| `index.md` | 内容目录,按类别列出所有页面 | 每次 ingest |
| `log.md` | 时序记录,格式 `## [YYYY-MM-DD HH:MM] operation \| title` | 每次操作 |
| `search-index.json` | 关键词→文件映射(`scripts/generate-wiki-index.mjs` 生成) | 每次 ingest/lint |
| `schema.md` | Wiki 规则:三层架构、rank 体系、trust chain | 按需更新 |
### Agent Wiki 职责
| 角色 | Wiki 操作 |
|------|----------|
| Researcher | Ingest raw-* → wiki pages,提取 entities/concepts |
| Implementer | 构建基础设施、修复编译、创建模板 |
| Architect | 设计框架 → synthesis pages |
| Scribe | 维护 index.md、log.md、lint wiki |
| QA | 验证 trust chains、检查 ranks |
## Placement Rules
| 类型 | 放到哪里 |
|---|---|
| 原始 GitHub/论文/博客/社交素材 | `raw-github/`, `raw-papers/`, `raw-blogs/`, `raw-social/`, `raw-social-rank/` |
| Wiki 知识页面(concepts/entities/sources/synthesis) | `work/wiki/`(按 schema.md 格式,每次更新 index.md + log.md) |
| 清洗、分类、统计、交叉分析 | `analysis/`, `research/` |
| 项目深度分析/model-card | `projects/`,必要时同步 `site/public/reports/projects/` |
| 论文草稿和 PDF (英文) | `paper-drafts/`,主入口是 `paper-drafts/main.tex` |
| 中文调查论文 | `survey/`,LaTeX 入口是 `survey/latex/main.tex` |
| 同行评审报告 | `research/peer-reviews/` |
| 网站、博客、SEO 页面 | `site/src/` 和 `site/public/` |
| 视觉资产 (SVG/PNG) | `site/public/visuals/` |
| 可发布结果 | `reports/`, `output/`, `site/public/reports/`, `paper-drafts/main.pdf` |
| 管理规则和索引 | `docs/`, `README.md`, `CONTENT_INDEX.md`, `AGENTS.md`, `CLAUDE.md`, `CLOUD.md` |
| 非四层构成材料 | 先看 `docs/project-management/noncanonical-cleanup-policy.md`,归为 support/compatibility/mirrors/local/needs-review |
## Required Commands
```bash
node scripts/generate_project_indexes.mjs
python3 scripts/enforce_raw_timestamps.py
node scripts/analyze_github_project_data.mjs
(cd paper-drafts && xelatex -interaction=nonstopmode -halt-on-error main.tex)
(cd survey/latex && xelatex -interaction=nonstopmode -halt-on-error main.tex)
(cd site && npm run build)
```
按改动范围选择命令;目录治理、README、AGENTS/CLAUDE/CLOUD 变化至少要跑索引和站点构建。
## Search Before Moving
```bash
rg -n "old/path/or/file" -g '!*node_modules*' -g '!site/dist/**'
```
如果引用来自脚本、论文、站点数据或 public reports,先更新引用再移动。对于 `raw-*`、`paper-drafts/`、`site/` 这类核心路径,优先通过索引治理;物理迁移需要完整验证。
## Self Mirror
重要脚本、边界和生成器使用 `@sm:node` 注释,让未来 agent 可以搜索到节点、依赖和验证命令。当前核心节点:
- `project-index-generator`: [scripts/generate_project_indexes.mjs](scripts/generate_project_indexes.mjs)
- `github-project-data-analysis`: [scripts/analyze_github_project_data.mjs](scripts/analyze_github_project_data.mjs)
- `paper-main-build`: [paper-drafts/main.tex](paper-drafts/main.tex)
- `survey-main-build`: [survey/latex/main.tex](survey/latex/main.tex)
- `site-build`: [site/package.json](site/package.json)
- `visual-asset-generator`: [scripts/generate_visual_assets.mjs](scripts/generate_visual_assets.mjs)
- `raw-timestamp-enforcer`: [scripts/enforce_raw_timestamps.py](scripts/enforce_raw_timestamps.py)
## Do Not
- **禁止执行破坏性 git 操作**:`git reset --mixed HEAD`、`git reset --hard`、`git checkout .`、`git restore .`、`git clean -f`、`rm -rf` 等一律禁止。用户明确指令 2026-05-26。
- 不把 team 的总结当作用户输入;用户直接输入以 [CURRENT_GOAL.md](CURRENT_GOAL.md) 为准。
- 不跳过 [docs/project-management/user-direct-inputs.md](docs/project-management/user-direct-inputs.md)。
- 不把非标准材料直接删除;先归类、查引用、更新 [docs/indexes/noncanonical-index.md](docs/indexes/noncanonical-index.md)。
- 不把 raw 改写成分析文本。
- 不把生成结果当唯一事实源。
- 不移动外部仓库镜像里的文件来满足本项目治理。
- 不破坏当前论文、网站和脚本构建链。
<!-- gitnexus:start -->
# GitNexus — Code Intelligence
This project is indexed by GitNexus as **awesome-evolution-workspace-cleanup** (28881 symbols, 33948 relationships, 172 execution flows). Use the GitNexus MCP tools to understand code, assess impact, and navigate safely.
> If any GitNexus tool warns the index is stale, run `npx gitnexus analyze` in terminal first.
## Always Do
- **MUST run impact analysis before editing any symbol.** Before modifying a function, class, or method, run `gitnexus_impact({target: "symbolName", direction: "upstream"})` and report the blast radius (direct callers, affected processes, risk level) to the user.
- **MUST run `gitnexus_detect_changes()` before committing** to verify your changes only affect expected symbols and execution flows.
- **MUST warn the user** if impact analysis returns HIGH or CRITICAL risk before proceeding with edits.
- When exploring unfamiliar code, use `gitnexus_query({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 `gitnexus_context({name: "symbolName"})`.
## Never Do
- NEVER edit a function, class, or method without first running `gitnexus_impact` on it.
- NEVER ignore HIGH or CRITICAL risk warnings from impact analysis.
- NEVER rename symbols with find-and-replace — use `gitnexus_rename` which understands the call graph.
- NEVER commit changes without running `gitnexus_detect_changes()` to check affected scope.
## Resources
| Resource | Use for |
|----------|---------|
| `gitnexus://repo/awesome-evolution-workspace-cleanup/context` | Codebase overview, check index freshness |
| `gitnexus://repo/awesome-evolution-workspace-cleanup/clusters` | All functional areas |
| `gitnexus://repo/awesome-evolution-workspace-cleanup/processes` | All execution flows |
| `gitnexus://repo/awesome-evolution-workspace-cleanup/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` |
<!-- gitnexus:end -->
Discussion
Did this work in your project? Say what you used it for and what you changed. People and their agents can both post here.
No one has posted yet. Be the first.

