Capabilities → Apply Fixes & Delegation Apply Fixes & Delegation Apply safe architectural fixes (arc fix), Cursor-ready handoff (arc finish --copy, watch [c]), and advanced planning.
Tier: Pro
Common use cases • Prioritizing refactors by risk and impact • Simulating architecture changes safely • Planning migration and cleanup order • Getting suggestions for architecture improvements CLI Output Example Run inside your repository
terminal
$ arc fix
Found 2 safe fixes in this run:
1. Break dependency cycle — src/auth/AuthService.ts
2. Remove unused import — src/order/OrderService.ts
Run 'arc fix' to apply, or arc watch (Pro) to keep clean. Primary commands Most common workflows for this capability.
arc blastDisplay dependency fan-out tree (blast radius) for a module. ▼ Example usage
arc blast <path>Copy
Related commands
Run arc --help for the full list.
arc decisionRun one deterministic architecture decision cycle. ▼ Example usage
arc decisionCopy
Related commands
Run arc --help for the full list.
arc deleteRemove a module and report impact. ▼ Example usage
arc delete <path>Copy
Related commands
Run arc --help for the full list.
arc evolveDeterministic bounded improvement: baseline, three isolated strategies, verify; dirty repos run in snapshot-only mode; --apply requires a clean git tree. ▼ Example usage
arc evolve [--apply] [--dry-run] [--force] [--watch] [--json]Copy
Related commands
Run arc --help for the full list.
arc finishResolve remaining issues: plan, apply safe fixes, or copy prompt for Cursor/LLM. ▼ Example usage
arc finish [--preview] [--apply] [--copy]Copy
Related commands
Run arc --help for the full list.
arc fixApply safe architectural fixes automatically. ▼ Related commands
Run arc --help for the full list.
Advanced commands Additional commands for deeper workflows.
arc fix-planCompile deterministic, machine-executable fix plans from architecture issues. ▼ Example usage
arc fix-plan [--file <path>] [--type <type>] [--json]Copy
Related commands
Run arc --help for the full list.
arc learningExport or aggregate learning pattern datasets (history → export → global). ▼ Example usage
arc learning export | learning aggregate --inputs <paths> --output <path>Copy
Related commands
Run arc --help for the full list.
arc loopDeterministic architecture control loop. Select and apply (or delegate) the safest single fix. ▼ Example usage
arc loop [--json] [--force]Copy
Related commands
Run arc --help for the full list.
arc planImpact of files changed in a git diff; generate refactor plan. ▼ Example usage
arc planCopy
Related commands
Run arc --help for the full list.
arc prioritizeRank architectural issues by risk. ▼ Example usage
arc prioritizeCopy
Related commands
Run arc --help for the full list.
arc refactorApply or preview refactor strategies. ▼ Example usage
arc refactor [path]Copy
Related commands
Run arc --help for the full list.
arc refactor-candidatesList modules that are refactor candidates. ▼ Example usage
arc refactor-candidatesCopy
Related commands
Run arc --help for the full list.
arc refactor-riskAssess refactor risk for a module. ▼ Example usage
arc refactor-riskCopy
Related commands
Run arc --help for the full list.
arc riskIdentify the most architecturally risky modules. ▼ Example usage
arc risk [path]Copy
Related commands
Run arc --help for the full list.
arc roadmapGenerate architectural refactor roadmap for the repository. ▼ Example usage
arc roadmapCopy
Related commands
Run arc --help for the full list.
arc simulateSimulate impact of changes. ▼ Example usage
arc simulate <action> <path>Copy
Related commands
Run arc --help for the full list.
arc suggestDeterministic refactor suggestions for a module or directory. ▼ Example usage
arc suggest [path]Copy
Related commands
Run arc --help for the full list.
arc undoRevert the last arc fix or finish --apply changes (one level). ▼ Example usage
arc undoCopy
Related commands
Run arc --help for the full list.
arc watchWatch the project and run the architecture control loop after relevant file changes. ▼ Example usage
arc watchCopy
Related commands
Run arc --help for the full list.
Typical workflow How engineers use these commands together.
1. arc blastCopy 2. arc decisionCopy 3. arc deleteCopy 4. arc evolveCopy 5. arc finishCopy 6. arc fixCopy 7. arc fix-planCopy 8. arc learningCopy 9. arc loopCopy 10. arc planCopy 11. arc prioritizeCopy 12. arc refactorCopy 13. arc refactor-candidatesCopy 14. arc refactor-riskCopy 15. arc riskCopy 16. arc roadmapCopy 17. arc simulateCopy 18. arc suggestCopy 19. arc undoCopy 20. arc watchCopy