| 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):
-
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.
-
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.
-
Optional module context. mcp__nlt-build__tapps_impact_analysis(file_path='...', symbol='...', granularity='both') for import + symbol blast radius.
-
Edit loop. After each Python file change, mcp__nlt-build__tapps_quick_check(file_path='...').
-
After edits. mcp__nlt-build__tapps_diff_impact(file_paths='...') or finish with /tapps-finish-task (include_impact default true refreshes cache).
-
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.
