graphify-labs--graphify/tools/skillgen/expected/graphify__skills__trae__references__hooks.md

graphify reference: commit hook and native AGENTS.md integration

Load this when the user asked to install the post-commit hook or wire graphify into a project's AGENTS.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.

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 AGENTS.md integration (Trae)

Run once per project to make graphify always-on in Trae sessions:

graphify trae install       # or: graphify trae-cn install

This writes a ## graphify section to the local AGENTS.md that instructs Trae to check the graph before answering codebase questions and rebuild it after code changes. No manual /graphify needed in future sessions.

Note: Unlike Claude Code, Trae does NOT support PreToolUse hooks. The AGENTS.md rules are the always-on mechanism — there is no automatic graph rebuild on tool use. Run /graphify --update manually after code changes if the graph needs refreshing.

graphify trae uninstall     # or: graphify trae-cn uninstall   # remove the section