chore: wire Understand-Anything codebase graph into team workflow#1401
Merged
Conversation
Add CLAUDE.md guidance for the Understand-Anything Claude Code plugin (install, daily usage, refresh process, repo-specific gotchas) and gitignore the scratch + dashboard local-diff outputs while keeping knowledge-graph.json committed so the dashboard works for the next developer without re-running a full index.
- Ship initial knowledge graph (.understand-anything/knowledge-graph.json, 356K, 145 files indexed) so teammates can open /understand-dashboard without a full re-index on first use. - Gitignore meta.json (timestamp churn) and fingerprints.json (per-machine incremental cache) to keep PR diffs clean. Commit config.json and .understandignore as shared team settings. - Disable autoUpdate post-commit hook in config.json — it would otherwise modify the graph on every commit and pollute feature-PR diffs. Refresh cadence (weekly + after big refactors) documented in CLAUDE.md. - Add orientation pointers to /add-protocol, /fix-issue, and /develop-plugin: spend cheap graph-lookups before dispatching research subagents. - Enable the plugin in .claude/settings.json so teammates with the plugin installed see it auto-enabled. - Document install + usage in README.md (brief; CLAUDE.md has the deeper guidance).
🧹 PR Environment Cleaned UpThe PR environment has been successfully deleted. Deleted Resources:
All resources have been cleaned up and will no longer incur costs. |
ℹ️ No PR Environment to Clean UpNo PR environment was found for this PR. This is expected if:
|
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
config.jsonto keep PR diffs clean. Refresh is on a manual cadence: weekly incremental/understand, full/understand --fullafter wide-blast-radius refactors./add-protocol,/fix-issue, and/develop-pluginso research subagents are dispatched only for what the graph can't answer cheaply..claude/settings.jsonso teammates who install it locally see it auto-enabled.README.md(brief) andCLAUDE.md(deeper guidance + known caveats).How to use after this lands
In Claude Code at the repo root:
Restart Claude Code, then:
/understand-dashboard— interactive force-directed graph at http://127.0.0.1:5173/understand-chat <question>— Q&A over the graph/understand-diff— impact analysis of uncommitted changes/understand-onboard— guided tour for new contributors/understand --full— full re-index after a large refactorGitignore strategy
knowledge-graph.json,config.json,.understandignore(shared team settings).meta.json(timestamp churn),fingerprints.json(per-machine incremental cache),intermediate/,diff-overlay.json.Test plan
/plugin marketplace add Lum1104/Understand-Anything+/plugin install understand-anything, restart, confirm plugin loads./understand-dashboardopens and renders the committed graph (no re-index needed)./understand-chat "where does X live?"returns sensible answers againstplugins/,lib/, andapp/api/./understand --fullfrom a clean checkout produces only the expected diff toknowledge-graph.json; nometa.json/fingerprints.jsonshow up ingit status.@/*aliases are picked up as edges in the graph (known upstream bug — verify after first run; see CLAUDE.md gotchas).Known caveats (called out in CLAUDE.md)
@/*edges; re-run after upstream fix lands.5173; kill other Vite projects first.