Integrate ts_knowledge_graph with Claude Code (Graphify-style)

Goal

Integrate ts_knowledge_graph with Claude Code (and other agents) the way Graphify is — let the agent query the knowledge graph instead of blindly grepping the codebase.

How Graphify does it

Graphify's Claude Code integration is a bundle of three standard Claude Code extension points:

1. A CLAUDE.md directive — tells Claude to read the generated graph report before answering architecture/dependency questions.
2. A PreToolUse hook in settings.json — fires before every Grep/Glob call so the graph is consulted first (the "always-on" angle they advertise).
3. An MCP server exposing the graph as callable tools — the most agent-native path, still on Graphify's roadmap (their issue #146), not shipped.

Why we are well positioned

The query layer is already designed as "JSON in, JSON out" agent tools:

• GraphQuery methods (whoCalls, blastRadius, deadExports, neighborhood, references) map one-to-one onto agent tools.
• Every CLI query command accepts --json.

The hard part (a clean, machine-readable query surface) is done; integration is plumbing on top.

Options (lowest to highest effort)

Proposed plan

1. Start with a Skill — matches Graphify's actual shipping form, fastest to value. Wraps the existing --json CLI; zero changes to core code, just a SKILL.md teaching Claude the commands and when to reach for blast-radius / dead-exports / who-calls.
2. Then add an MCP server — thin adapter over GraphQuery (already JSON-in/JSON-out) for tool-native, cross-agent use.
3. Skip the PreToolUse always-on hook initially — clever but adds latency to every search and is the easiest piece to add later.

References

• Graphify GitHub: https://github.com/safishamsi/graphify
• Graphify + Claude Code integration page: https://graphify.net/graphify-claude-code-integration.html
• ck:graphify (ClaudeKit docs): https://docs.claudekit.cc/docs/engineer/skills/graphify
• Graphify + code-review-graph (DEV Community): https://dev.to/mir_mursalin_ankur/graphify-code-review-graph-build-a-self-updating-knowledge-graph-for-claude-code-and-other-ai-j1m

Start by reading the existing GraphQuery methods and the CLI query commands that support --json. Then review the proposed .claude/skills/SKILL.md integration and determine how the planned MCP adapter would expose the same operations. Done means the agreed Claude Code integration is documented and usable without changes to the core graph query layer.