Установка codegraph: npm и claude mcp add-json вместо brew (#19, O-8, 0.4.1) #20

aep · 2026-10-23T22:14:39+03:00

aep commented

2026-10-23 22:14:39 +03:00

Closes #19 — находка O-8 из прогона harness-doctor 23.10.2026 (bounded: без OpenSpec change и плана).

Что сделано

skills/harness-doctor/SKILL.md, чеклист «Машина»:
- при MISS codegraph — npm i -g @colbymchenry/codegraph, а не brew install codegraph (такой формулы нет, команда падает);
- tea ставится через brew install tea;
- новая строка: подключить MCP через claude mcp add-json -s user codegraph '{…"alwaysLoad":true}', перезапустить сессию, выполнить codegraph init в проекте. Почему не codegraph install: он дописывает секцию в ~/.claude/CLAUDE.md, которую сотрёт install.sh, и файл выходит за порог 3 КБ.
README.md: в таблице слоёв и в блоке установки — те же команды и то же предупреждение.
CHANGELOG.md: 0.4.1.

Рецепт проверен на этой машине:

npm i -g поставил codegraph 1.6.2;
claude mcp get codegraph показывает ✔ Connected;
после codegraph init doctor выдаёт ok codegraph 1.6.2 и ok codegraph: индекс есть.

Проверка

bash tests/run.sh — passed 472, failed 0.

Находки

Маркер	Что	Статус
O-8	неверная подсказка установки codegraph в SKILL.md и README	fixed `af090c2`
O-9	`adopt-project.sh` и `new-project.sh` пропускают `codegraph init`, если `.codegraph/` уже есть. В репозитории закоммичен `.codegraph/.gitignore`, поэтому в свежем клоне каталог есть, а индекса нет (так было в cc-harness)	deferred
O-10	doctor проверяет только бинарник `codegraph`; не подключённый MCP-сервер он не видит	deferred

Rulings I made

Теста нет: правка только в тексте документации, поведения скриптов она не меняет. Цена: подсказка может снова устареть, и тест этого не поймает.
Версия 0.4.1: SKILL.md ставится в ~/.claude, а версия пакета ведётся только в CHANGELOG. Цена: нет.

После merge

bash install.sh — обновит ~/.claude/skills/harness-doctor/SKILL.md.

🤖 Generated with Claude Code

Closes #19 — находка O-8 из прогона harness-doctor 23.10.2026 (bounded: без OpenSpec change и плана). ## Что сделано - `skills/harness-doctor/SKILL.md`, чеклист «Машина»: - при `MISS codegraph` — `npm i -g @colbymchenry/codegraph`, а не `brew install codegraph` (такой формулы нет, команда падает); - `tea` ставится через `brew install tea`; - новая строка: подключить MCP через `claude mcp add-json -s user codegraph '{…"alwaysLoad":true}'`, перезапустить сессию, выполнить `codegraph init` в проекте. Почему не `codegraph install`: он дописывает секцию в `~/.claude/CLAUDE.md`, которую сотрёт `install.sh`, и файл выходит за порог 3 КБ. - `README.md`: в таблице слоёв и в блоке установки — те же команды и то же предупреждение. - `CHANGELOG.md`: 0.4.1. Рецепт проверен на этой машине: - `npm i -g` поставил codegraph 1.6.2; - `claude mcp get codegraph` показывает `✔ Connected`; - после `codegraph init` doctor выдаёт `ok codegraph 1.6.2` и `ok codegraph: индекс есть`. ## Проверка - `bash tests/run.sh` — passed 472, failed 0. ## Находки | Маркер | Что | Статус | |---|---|---| | O-8 | неверная подсказка установки codegraph в SKILL.md и README | fixed af090c2 | | O-9 | `adopt-project.sh` и `new-project.sh` пропускают `codegraph init`, если `.codegraph/` уже есть. В репозитории закоммичен `.codegraph/.gitignore`, поэтому в свежем клоне каталог есть, а индекса нет (так было в cc-harness) | deferred | | O-10 | doctor проверяет только бинарник `codegraph`; не подключённый MCP-сервер он не видит | deferred | ## Rulings I made - Теста нет: правка только в тексте документации, поведения скриптов она не меняет. Цена: подсказка может снова устареть, и тест этого не поймает. - Версия 0.4.1: `SKILL.md` ставится в `~/.claude`, а версия пакета ведётся только в CHANGELOG. Цена: нет. ## После merge `bash install.sh` — обновит `~/.claude/skills/harness-doctor/SKILL.md`. 🤖 Generated with [Claude Code](https://claude.com/claude-code)

aep added 1 commit 2026-10-23 22:14:40 +03:00

docs: установка codegraph через npm и claude mcp add-json, не brew (#19 , O-8) af090c2b0d

harness-doctor/SKILL.md советовал `brew install codegraph` — формулы нет,
команда падает. codegraph — npm-пакет @colbymchenry/codegraph; MCP
подключается отдельно через `claude mcp add-json -s user`. Штатный
`codegraph install` не годится: дописывает секцию в ~/.claude/CLAUDE.md,
которую сотрёт install.sh. README (таблица и блок установки) — те же
команды. CHANGELOG 0.4.1.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

aep merged commit dce95e7e86 into main

2026-10-23 22:15:56 +03:00

aep referenced this issue from a commit

2026-10-23 22:15:58 +03:00

Merge pull request 'Установка codegraph: npm и claude mcp add-json вместо brew (#19, O-8, 0.4.1)' (#20) from feat/19-codegraph-install into main

aep referenced this pull request

2026-10-23 22:16:16 +03:00

Follow-ups from #19 #21

aep referenced this pull request

2026-10-23 22:16:26 +03:00

harness-doctor и README: неверная подсказка установки codegraph (O-8, bounded) #19

aep referenced this pull request