agentleFS
cdeustcdeust/ai-architect-mcp-codebase/skills/impact-analysis/SKILL.md

impact-analysis

Skill7 starsChanged 3 months agoMITView on GitHub

Trace the structural blast radius of a proposed or actual code change with ai-architect. Use for implementation planning, pull-request review, regression analysis, dependency checks, or identifying callers, importers, users, communities, and processes affected by a symbol or diff.

11 other projects use a version of this.

Adopted by

Most recently taken up by

The file

We split this skill into the rules it gives an agent

8 rules. 0 are common, 0 are distinctive, and 8 are very specific to this project.

  • 0

    Common

    Most of the 10 edited versions we read keep these.

  • 0

    Distinctive

    This author's own choices. Worth a look.

  • 8

    Very specific

    Tied to their project's names, files or tools. Probably skip.

  • Common
  • Distinctive
  • Very specific
  1. Very specific:

    Use the eight-tool core profile.

    line 8
  2. Very specific:

    If a full-profile workflow supplies a check_security_gates receipt, inspect both gates_passed and assessment_complete.

    line 17
  3. Very specific:

    Call health_check. Build or refresh the graph with analyze_codebase, and keep the exact returned graph_path.

    line 24
  4. Very specific:

    If an actual unified diff or base/head refs exist, call detect_changes.

    line 25
  5. Very specific:

    Use search_codebase to resolve every proposed or changed symbol to an exact qualified name.

    line 26
  6. Very specific:

    Call get_impact for each target.

    line 27
  7. Very specific:

    Call query_graph with graph="missed".

    line 28
  8. Very specific:

    Follow high-risk dependents with get_context or get_symbol.

    line 29

“Common” is measured: kept by at least 6 in 10 of the 10 edited versions of this file we could read. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.

Keep what fits and drop the rest. Your version, ready for your agents.
Files
SKILL.md

Impact Analysis

Use the eight-tool core profile. Treat graph results as a lower bound wherever the tool reports heuristic resolution, dynamic dispatch, or coverage gaps.

For Rust caller or impact questions, request lsp: true in analyze_codebase and make rust-analyzer available. Inspect lsp_status.state: disabled means static-only analysis; failed means analysis continued and may retain partial LSP results. Record the error and treat affected conclusions as unverified until source checks or a successful rerun support them. completed means the pass returned, not that every call resolved. Record unresolved sites and coverage gaps.

If a full-profile workflow supplies a check_security_gates receipt, inspect both gates_passed and assessment_complete. A true pass with an incomplete assessment is not security clearance: report skipped checks, unresolved symbols and warnings. This core-profile workflow does not invoke that additional tool.

Workflow

  1. Call health_check. Build or refresh the graph with analyze_codebase, and keep the exact returned graph_path.
  2. If an actual unified diff or base/head refs exist, call detect_changes. Do not invent a diff for a proposal that has not been implemented.
  3. Use search_codebase to resolve every proposed or changed symbol to an exact qualified name. Confirm important targets with get_symbol or get_context.
  4. Call get_impact for each target. Page callers through next_offset. Treat importers, users, and implementors as capped summaries; use query_graph with an explicit ORDER BY when a complete paged list matters.
  5. Call query_graph with graph="missed". Inspect flagged ranges and search relevant source, including unflagged files, even when no gaps are flagged before making a negative claim about callers, dependencies, or test coverage. Clean parsing can still miss relationships.
  6. Follow high-risk dependents with get_context or get_symbol. Use sibling graphs only when the user supplies or authorizes those graph paths.

Deliverable

Separate direct graph evidence from inference. Report affected symbols, callers and dependency types, communities, graph-derived processes, co-change hints, coverage gaps, and unverified risks. Preserve the tool's epistemic qualifier instead of upgrading a lower-bound result into a completeness claim.

Download now (ZIP)

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

No reviews yet

People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.

  • It worked
  • Partly
  • It didn't
What did you use it for? e.g. Reviewing pull requests in a Rails app

Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.