Capabilities → Apply Fixes & Watch 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 fixDeprecated: use 'plan' instead. Generate safe refactor recommendations. ▼ Related commands
Run arc --help for the full list.
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.
Advanced commands Additional commands for deeper workflows.
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 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 fixCopy 6. arc fix-planCopy 7. arc learningCopy 8. arc loopCopy 9. arc planCopy 10. arc prioritizeCopy 11. arc refactorCopy 12. arc refactor-candidatesCopy 13. arc refactor-riskCopy 14. arc riskCopy 15. arc roadmapCopy 16. arc simulateCopy 17. arc suggestCopy 18. arc watchCopy