Menu
Refactor safely in Codex by mapping dependents before edits, making structural changes in small increments, and validating imports, exports, and tests after each change.
Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.
Based on SOC occupation classification
Find duplicate functions and eliminate them so they stay gone. Triage tl dupes output by tier, apply the right consolidation pattern, and lock the win with a duplication-ratchet test. Use when asked to dedupe, remove duplication, consolidate copy-paste, clean up repeated helpers, or act on tl dupes output.
Find duplicate functions in Codex and remove them so they stay gone โ triage tl dupes by tier, consolidate the second home (not both copies), and add a duplication-ratchet test to block regressions. Use when deduping, removing copy-paste, consolidating repeated helpers, or acting on tl dupes output.
Git commits, pushes, and GitHub operations using tokenlean. Covers tl push (with multi-file safety guard), tl commit-prep, tl gh (bulk issue/PR/release operations), and when to use tl gh vs gh CLI vs GitHub MCP. Use when committing, pushing, creating/closing/viewing issues, managing PRs, creating releases, or any git/GitHub workflow.
Git commits, pushes, and GitHub operations using tokenlean. Covers tl push (with multi-file safety guard), tl commit-prep, tl gh (bulk issue/PR/release operations). Use when committing, pushing, creating/closing/viewing issues, managing PRs, creating releases, or any git/GitHub workflow.
Add new functionality by understanding existing patterns and dependencies before writing code. Locates where the feature belongs, studies conventions, implements following precedent, then verifies integration. Use when asked to add a feature, flag, endpoint, component, or module.
Thorough code review using token-efficient context gathering. Analyzes PRs, diffs, or staged changes by checking blast radius, complexity, and dependencies before reviewing the actual code. Use when asked to review a PR, review changes, or do a code review.
| name | safe-refactor |
| description | Refactor safely in Codex by mapping dependents before edits, making structural changes in small increments, and validating imports, exports, and tests after each change. |
| compatibility | Codex CLI with terminal access, git, tokenlean CLI (npm i -g tokenlean) |
Change structure without changing behavior.
Analyze impact -> Plan -> Refactor -> Verify
tl parallel \
"impact=tl impact <file>" \
"exports=tl exports <file>" \
"symbols=tl symbols <file>"
These three commands tell you:
If tl impact shows 10+ dependents, consider whether this refactor is worth the risk.
Choose smallest safe unit:
For each consumer of the target:
tl snippet <imported-symbol> <consumer-file> # How is the symbol actually used?
Apply the refactor. Then immediately check:
tl guard # Circular deps, unused exports, other issues
tl parallel \
"test=tl run 'npm test'" \
"impact=tl impact <file>" \
"diff=tl diff"
What are you changing?
โโ Renaming a symbol
โ โ tl impact to find all importers
โ โ Update all import sites
โ โ tl guard to verify no broken imports
โ
โโ Moving a file
โ โ tl impact for full dependent list
โ โ Move file, update all import paths
โ โ tl guard for circular deps
โ
โโ Extracting a function/module
โ โ tl symbols + tl deps on source file
โ โ Extract, add exports
โ โ tl impact on original to update importers
โ โ tl guard + tl run tests
โ
โโ Changing a function signature
โ tl impact + tl flow to find all callers
โ tl snippet on each caller to see usage
โ Update signature + all call sites
โ tl run tests
tl unused after refactoring catches exports you forgot to clean up.