All-platform progressive-disclosure skill split + generator (addresses #1106). Splits each platform's skill into a lean core (~615 lines, full default pipeline inline) + on-demand references/, generated from a single source via tools/skillgen with a CI/pre-commit drift gate. 13 hosts split, aider/devin stay monoliths. Also fixes the stale bare-path bugs across the previously hand-maintained variants and moves the always-on blocks into packaged markdown. Verified: all 5 generator guards pass, byte-verbatim load-bearing slices, lean cores self-sufficient on the default path across all 13 split hosts, references gated to non-default branches, description preserves the graphify-out-query-first clause. Supersedes #1119 (Claude-first subset). Known follow-up applied on top: harden _always_on() against a missing packaged file so a partial install can't brick the CLI.
34 lines
1.2 KiB
Markdown
34 lines
1.2 KiB
Markdown
# graphify reference: commit hook and native CLAUDE.md integration
|
|
|
|
Load this when the user asked to install the post-commit hook or wire graphify into a project's CLAUDE.md.
|
|
|
|
## For git commit hook
|
|
|
|
Install a post-commit hook that auto-rebuilds the graph after every commit. No background process needed - triggers once per commit, works with any editor.
|
|
|
|
```bash
|
|
graphify hook install # install
|
|
graphify hook uninstall # remove
|
|
graphify hook status # check
|
|
```
|
|
|
|
After every `git commit`, the hook detects which code files changed (via `git diff HEAD~1`), re-runs AST extraction on those files, and rebuilds `graph.json` and `GRAPH_REPORT.md`. Doc/image changes are ignored by the hook - run `/graphify --update` manually for those.
|
|
|
|
If a post-commit hook already exists, graphify appends to it rather than replacing it.
|
|
|
|
---
|
|
|
|
## For native CLAUDE.md integration
|
|
|
|
Run once per project to make graphify always-on in Claude Code sessions:
|
|
|
|
```bash
|
|
graphify claude install
|
|
```
|
|
|
|
This writes a `## graphify` section to the local `CLAUDE.md` that instructs Claude to check the graph before answering codebase questions and rebuild it after code changes. No manual `/graphify` needed in future sessions.
|
|
|
|
```bash
|
|
graphify claude uninstall # remove the section
|
|
```
|