codebase-survey

Plugin codebase-survey from marketplace mtrense-skills in mtrense/skills. Commands read from the repo's manifest — today.

Skills (5)

• codebase-architecture-assessment

  Cross-cutting architecture pass after per-module surveys are complete. Reads every <module>/CODEBASE.md and the top-level CODEBASE.md, looks for domain- boundary leaks, coupling hotspots, deviations between stated and actual architecture, and stack inconsistencies. Writes findings to docs/codebase/a

• codebase-derive-instructions

  Read the assembled codebase survey (CODEBASE.md files, docs/codebase/*.md, assessment findings) and produce a lean, source-anchored CLAUDE.md at the repo root plus one per module that has rules. Lifts kind:rule findings only; observations stay in assessment.md. Verifies length budgets, rule duplicat

• codebase-survey-init

  Bootstrap a codebase survey: delegate raw structural discovery to the structural-discovery subagent, synthesize the module map (judgment call — stays in the main session), then write the top-level CODEBASE.md plus per-module stub files. Run once per repository, before per-module deep-dives.

• codebase-survey-module

  Deep-dive survey of one module. Spawns the dep-grapher, api-surface-extractor, wire-api-extractor, test-auditor, and ops-detective subagents in parallel, then assembles the module's CODEBASE.md from their reports. Idempotent — re-running rewrites the file. Trigger after /codebase-survey-init has pro

• codebase-survey-update

  Incremental refresh of an existing codebase survey. With no argument, each module is diffed from its own recorded surveyed_sha to HEAD. With a commit range or PR# argument, that range is used uniformly. Maps changed paths to affected module docs, dispatches narrowly-scoped subagents for only those m

Subagents (6)

• api-surface-extractor

  Extracts the language-level public API surface of a module — exported symbols, types, functions, classes, traits — using language-aware tooling first (cargo public-api, tsc --emitDeclarationOnly, go doc, pdoc) and import-grep as fallback. Returns a structured listing. Used during a per-module survey

• dep-grapher

  Computes inbound and outbound dependencies for a module by running the project's native dependency tooling (cargo tree, npm ls, pip-deptree, go mod graph, mvn dependency:tree, etc.). Returns a structured report. Skips cleanly if no native tool is available. Use during a per-module survey to populate

• ops-detective

  Surveys CI/CD pipelines, container builds, deploy manifests, secrets handling, observability hooks, and logging libraries — without executing anything. Returns a structured inventory of what runs where and what watches it. Used during the per-module survey and the repo-level CODEBASE.md.

• structural-discovery

  Discovers raw structural signals about an unknown codebase: build manifests, workspace declarations, top-level layout, and language mix. Returns a structured report. Does NOT infer module boundaries — that synthesis is left to the caller. Use for the first pass of a codebase survey.

• test-auditor

  Audits a module's test situation: discovers test files, runs the project's test runner in collect-only / list mode to count tests by layer (unit / integration / e2e), and surfaces coverage when readily available. Returns pyramid-shape numbers, not opinions about adequacy. Used during a per-module su

• wire-api-extractor

  Extracts the external/network API surface of a module: HTTP routes, gRPC services, GraphQL schemas, AsyncAPI / message-broker topics. Prefers spec artifacts (OpenAPI, .proto, .graphql) and framework introspection over greps; falls back to grepping route-registration patterns. Distinct from api-surfa

Similar plugins