diff --git a/.planning/ROADMAP.md b/.planning/ROADMAP.md
index 3141ce8..be4cc3e 100644
--- a/.planning/ROADMAP.md
+++ b/.planning/ROADMAP.md
@@ -21,6 +21,7 @@ Decimal phases appear between their surrounding integers in numeric order.
 - [ ] **Phase 7: v2 — Leftovers** - Expanded default excludes, `--skip-env` / `skip_env` setting, and `--verbose` flag
 - [ ] **Phase 8: Integration Tests** - Testcontainers-based suite verifies all requirements automatically against a real SSH daemon
 - [ ] **Phase 9: Documentation** - README.md tells the full story: why, how to install, use-cases, comparison table, prerequisites, troubleshooting, and project badges
+- [ ] **Phase 10: Add Phase Autosuggestion** - add phase autosuggestion
 
 ## Phase Details
 
@@ -220,6 +221,14 @@ Cross-cutting constraints:
   7. A feedback and suggestions section links to GitHub Issues with a welcome message for bug reports and feature requests
   8. README.md includes badges for build status, latest release version, and test status
 
+### Phase 10: Add Phase Autosuggestion
+**Goal**: add phase autosuggestion
+**Depends on**: Phase 8
+**Plans**: TBD
+
+**Success Criteria** (what must be TRUE):
+  1. TBD
+
 ## Progress
 
 **Execution Order:**
@@ -236,3 +245,4 @@ Phases execute in numeric order: 1 → 2 → 3 → 4 → 5 → 6
 | 7. v2 — Leftovers | 0/? | Not started | - |
 | 8. Integration Tests | 0/? | Not started | - |
 | 9. Documentation | 0/? | Not started | - |
+| 10. Add Phase Autosuggestion | 0/? | Not started | - |
diff --git a/.planning/STATE.md b/.planning/STATE.md
index 222f9b9..a216c25 100644
--- a/.planning/STATE.md
+++ b/.planning/STATE.md
@@ -7,7 +7,7 @@ stopped_at: Phase 5 complete — pre-flight checks and health polling verified a
 last_updated: "2026-05-17T06:10:00Z"
 last_activity: 2026-05-17
 progress:
-  total_phases: 9
+  total_phases: 10
   completed_phases: 5
   total_plans: 14
   completed_plans: 14
@@ -89,6 +89,8 @@ Recent decisions affecting current work:
 - Phase 7 edited: renamed from "Skip .env Override Option" to "Leftovers"; skip_env_override → skip_env; --verbose split into its own Wave 2
 - Phase 8 added: Integration Tests (testcontainers-based suite verifying all requirements against real SSH daemon)
 - Phase 9 added: Documentation (README.md — motivation, install, use-cases, comparison table, prerequisites, troubleshooting, badges, feedback section)
+- Phase 10 added: add phase autosuggestion
+
 
 ### Pending Todos