Who calls a function, the tests to run, the route handlers behind an error: one call, with proof lines. Local only.

GitHub stars
9

Install

/plugin install devkb@namiq

Run it inside Claude Code after adding the marketplace with /plugin marketplace add namiq-ai/devkb.

Contents

Discovered from source

Skills 2

Ask the graph first, then read

pack answers a whole question; choose by what you are about to do:

  • Open or edit a file: pack(kind="file", subject=PATH) returns the functions other files call, the dependent files and the tests to run. Run it before your first edit of each file; the Claude Code hook also adds it then.
  • Change a function's behaviour or signature: pack(kind="change", subject=NAME, path=FILE) returns callers at any depth and the tests.
  • Start from an error message: pack(kind="error", subject="MESSAGE") returns what raises it and the handlers that reach it.
  • One hop or how a pattern is written: grep or read the file.

If Coverage says Complete, it is the answer: do not search again or call callers to check it. If Incomplete, search only where it points. For the rest: rca_trace, impact, callers, tests_for, tests_to_run, review_pack, config. If _meta.stale is true, re-read the files that decide the change.

  • To read code, ask before you grep: symbol (a definition's lines; source=True for its body; names, globs, re:, typos tolerated), outline (a file's shape), uses (where a name appears), search_docs.

Review a change

  1. Call review_pack with the commit or base..head. It returns the changed functions, their callers outside the diff, the tests that cover them, the changed functions with no test, the documents governing the tickets named in the commit, rule warnings on the files and the owning roles.
  2. Read the diff. Then read only the callers outside the diff that the change could break.
  3. Report: what changed, who else it reaches, what is untested, whether any file belongs to a role other than the author's.
  4. If drift is listed, those files changed after the graph was built; trust names, re-check lines.

Limits: it describes structure, not correctness. A clean pack is not an approval.

MCP servers 1

Sponsors

Details

Marketplace
namiq-ai/devkb
Source
plugins/devkb
Category
Community