Files
gps-denied-desktop/_docs/tutorial_refactor.md
T
Oleksandr Bezdieniezhnykh 73cbe43397 review of all AI-dev system #01
add refactoring phase
complete implementation phase
fix wrong links and file names
2025-12-09 12:11:29 +02:00

114 lines
2.6 KiB
Markdown

# Refactoring Existing Project
This tutorial guides through analyzing, documenting, and refactoring an existing codebase.
## 4.05 **🧑‍💻 Developers**: User Input
### Define Goals
Create in `_docs/00_problem`:
- `problem_description.md`: What system currently does + what you want to change/improve
- `acceptance_criteria.md`: Success criteria for the refactoring
- `security_approach.md`: Security requirements (if applicable)
## 4.10 **🤖📋AI plan**: Build Documentation from Code
### Execute `/4.refactoring/4.10_documentation`
### Revise
- Review generated component docs
- Verify accuracy against actual code behavior
## 4.20 **🤖📋AI plan**: Form Solution with Flows
### Execute `/4.refactoring/4.20_form_solution_flows`
### Revise
- Review solution description
- Verify flow diagrams match actual system behavior
- Store to `_docs/01_solution/solution.md`
## 4.30 **🤖✨AI Research**: Deep Research of Approaches
### Execute `/4.refactoring/4.30_deep_research`
### Revise
- Review suggested improvements
- Prioritize changes based on impact vs effort
## 4.35 **🤖✨AI Research**: Solution Assessment with Codebase
### Execute `/4.refactoring/4.35_solution_assessment`
### Revise
- Review weak points identified in current implementation
- Decide which to address
## 4.40 **🤖📋AI plan**: Integration Tests Description
### Execute `/4.refactoring/4.40_tests_description`
### Revise
- Ensure tests cover critical functionality
- Add edge cases
## 4.50 **🤖📋AI plan**: Implement Tests
### Execute `/4.refactoring/4.50_implement_tests`
### Verify
- All tests pass on current codebase
- Tests serve as safety net for refactoring
## 4.60 **🤖📋AI plan**: Analyze Coupling
### Execute `/4.refactoring/4.60_analyze_coupling`
### Revise
- Review coupling analysis
- Prioritize decoupling strategy
## 4.70 **🤖📋AI plan**: Execute Decoupling
### Execute `/4.refactoring/4.70_execute_decoupling`
### Verify
- Run integration tests after each change
- All tests must pass before proceeding
## 4.80 **🤖📋AI plan**: Technical Debt
### Execute `/4.refactoring/4.80_technical_debt`
### Revise
- Review debt items
- Prioritize by impact
## 4.90 **🤖📋AI plan**: Performance Optimization
### Execute `/4.refactoring/4.90_performance`
### Verify
- Benchmark before/after
- Run tests to ensure no regressions
## 4.95 **🤖📋AI plan**: Security Review
### Execute `/4.refactoring/4.95_security`
### Verify
- Address identified vulnerabilities
- Run security tests if applicable