Skip to content

feat: graphify agent discovery for token savings on clone#24

Merged
mforce merged 1 commit into
mainfrom
feat/graphify-agent-discovery
May 4, 2026
Merged

feat: graphify agent discovery for token savings on clone#24
mforce merged 1 commit into
mainfrom
feat/graphify-agent-discovery

Conversation

@mforce
Copy link
Copy Markdown
Owner

@mforce mforce commented May 4, 2026

Summary

  • Add AGENTS.md as single source of truth for graphify knowledge graph instructions (works with Claude Code, Copilot CLI, Cursor)
  • Consolidate CLAUDE.md to reference AGENTS.md instead of duplicating graphify instructions
  • Generate and commit graphify-out/wiki/ (27 articles) so agents navigate structured markdown instead of reading raw source files
  • Commit graph outputs (graph.json, GRAPH_REPORT.md, graph.html) so the knowledge graph is available immediately on clone
  • Add PreToolUse hook (.claude/settings.json) that nudges agents to check the graph before grepping
  • Add git hooks (.hooks/) for auto-rebuild on commit/checkout

Test plan

  • Clone fresh copy, verify graphify-out/GRAPH_REPORT.md and graphify-out/wiki/index.md exist
  • Start a new Claude Code session, verify AGENTS.md instructions appear in context
  • Run a grep command, verify PreToolUse hook fires with graph nudge
  • Make a code change and commit, verify post-commit hook rebuilds the graph
  • All 88 existing tests pass (verified in pre-push hook)

…on clone

- Create AGENTS.md as single source of truth for graphify instructions
- Update CLAUDE.md to reference AGENTS.md instead of duplicating
- Generate wiki (graphify-out/wiki/) for structured codebase navigation
- Add .claude/settings.json with PreToolUse hook for search commands
- Add git hooks (.hooks/) for auto-rebuild on commit/checkout
- Update .gitignore to ignore graphify-out/cache/
- Commit graph outputs (graph.json, GRAPH_REPORT.md, graph.html, wiki/)
@mforce mforce merged commit 8e9f813 into main May 4, 2026
3 checks passed
@mforce mforce deleted the feat/graphify-agent-discovery branch May 4, 2026 04:29
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant