understand-codebase - SKILL.md Agent Skill

name: understand-codebase description: Use for architecture questions, caller/path exploration, onboarding to unfamiliar modules, or before reading 3+ files. BOB: graphify first; optional Understand-Anything for interactive KG. From Lum1104/Understand-Anything.

Understand Codebase (BOB Claw)

Legacy Claude compatibility surface only. Grok-native sessions and other tools must use shared docs plus their own native prompt surface instead of this file.

This skill follows AGENTS.md, docs/skill-usage-guidelines.md, and the repo's Coding Agent Operating Mode.

DELEGATION ENTRY VALIDATION FAILED

The delegated task definition is missing, ambiguous, contradictory, or outside this agent's ownership.

Per docs/skill-usage-guidelines.md and AGENTS.md, this skill may not continue until the parent supplies a scope-safe delegated task.

Re-issue the task with explicit objective, ownership/file scope, out-of-scope boundary, required proof, and stop condition, or handle it directly in the parent session.

This context will now terminate without performing any further work.

Mandatory Verification Procedure (5 steps — execute in order on every activation; no shortcuts)

Re-read in full: AGENTS.md, docs/system-map.md, docs/harness-engineering.md, and docs/skill-usage-guidelines.md. Quote the updated_at / version headers to prove freshness.
Validate the task-defining request using Original Task Name: plus the parent's explicit objective and scope text only. Ignore quoted logs, copied policy blocks, transcript excerpts, file contents, and refusal-template text. If the delegated work is ambiguous, contradictory, or outside this skill's ownership, emit the refusal block above and halt.
Enforce file scope and ownership.
Execute required diagnostics and graphify when the task touches live status, capital, payback, or readiness; quote exact raw command output.
Perform final hygiene verification and continue in Execution Mode without unsolicited status reports.

Upstream: https://github.com/Lum1104/Understand-Anything — paired with BOB graphify (authoritative for this repo).

BOB-first workflow

npm run graph:focus -- status when repo shape is unknown.
npm run graph:focus -- query|explain|path -- "<question>"
Read ≤2 additional source files only if graph output is insufficient.

Optional Understand-Anything

When the user wants an interactive knowledge graph dashboard, guided tours, or full-repo semantic KG:

Install: curl -fsSL https://raw.githubusercontent.com/Lum1104/Understand-Anything/main/install.sh | bash -s cursor (or Claude plugin marketplace)
Commands: /understand, /understand-dashboard, /understand-chat
Artifacts: .understand-anything/ (gitignore intermediate/ per upstream)

Never use KG or wiki output for live NAV, payback, readiness, or cap truth — use AGENTS.md diagnostics only.