---
name: tapps-refactor
user-invocable: true
model: claude-sonnet-4-6
description: >-
  Function-level refactor workflow using call graph tools (Epic 114).
  Use before changing a symbol's signature, deleting a function, or
  refactoring callers — maps blast radius via tapps_call_graph and diff_impact.
allowed-tools: >-
  mcp__nlt-build__tapps_session_start
  mcp__nlt-build__tapps_call_graph
  mcp__nlt-build__tapps_impact_analysis
  mcp__nlt-build__tapps_diff_impact
  mcp__nlt-build__tapps_quick_check
  mcp__nlt-build__tapps_validate_changed
  mcp__nlt-build__tapps_checklist
argument-hint: "[symbol or file-path]"
---

Symbol-level refactor workflow (Epic 114 / ADR-0017):

1. **Session bootstrap.** Call `mcp__nlt-build__tapps_session_start()` — read `data.call_graph` (`ready`, `stale`, `degraded`). Stale is informational; graph tools auto-rebuild on first use.

2. **Before editing a function.** `mcp__nlt-build__tapps_call_graph(symbol='...', query='callers')` — who calls this symbol? Use `query='callees'` for downstream dependencies or `query='chain'` for bounded chains.

3. **Optional module context.** `mcp__nlt-build__tapps_impact_analysis(file_path='...', symbol='...', granularity='both')` for import + symbol blast radius.

4. **Edit loop.** After each Python file change, `mcp__nlt-build__tapps_quick_check(file_path='...')`.

5. **After edits.** `mcp__nlt-build__tapps_diff_impact(file_paths='...')` or finish with `/tapps-finish-task` (`include_impact` default true refreshes cache).

6. **Close out.** `/tapps-finish-task` with `task_type=refactor` — checklist recommends `tapps_call_graph` and `tapps_diff_impact`.

See `docs/CALL_GRAPH.md` for gap_rate / degraded semantics.