diff --git a/README.md b/README.md
index e967f31..e4b2cc9 100644
--- a/README.md
+++ b/README.md
@@ -83,7 +83,7 @@ copilot> upgrade this app to Java 21
 copilot> migrate this Spring Boot app to Azure
 ```
 
-**Note:** Only `modernize` is user-invocable. All other agents are internal and routed to automatically by the orchestrator.
+**Note:** Use `modernize` for the guided end-to-end workflow. Specialist agents can also be selected directly for focused scenarios; coordinator and worker agents are internal and routed automatically.
 
 ## Workflow
 
diff --git a/plugins/github-copilot-modernization/README.md b/plugins/github-copilot-modernization/README.md
index e967f31..e4b2cc9 100644
--- a/plugins/github-copilot-modernization/README.md
+++ b/plugins/github-copilot-modernization/README.md
@@ -83,7 +83,7 @@ copilot> upgrade this app to Java 21
 copilot> migrate this Spring Boot app to Azure
 ```
 
-**Note:** Only `modernize` is user-invocable. All other agents are internal and routed to automatically by the orchestrator.
+**Note:** Use `modernize` for the guided end-to-end workflow. Specialist agents can also be selected directly for focused scenarios; coordinator and worker agents are internal and routed automatically.
 
 ## Workflow
 
diff --git a/plugins/github-copilot-modernization/docs/USER_GUIDE.md b/plugins/github-copilot-modernization/docs/USER_GUIDE.md
index 66dd460..26041b8 100644
--- a/plugins/github-copilot-modernization/docs/USER_GUIDE.md
+++ b/plugins/github-copilot-modernization/docs/USER_GUIDE.md
@@ -48,12 +48,12 @@ Update to the latest version:
    copilot --agent=github-copilot-modernization:modernize
    ```
 
-   **Important:** Only `modernize` is user-invocable. All other agents are internal and automatically invoked by the orchestrator:
+   **Recommended:** Use `modernize` for the guided end-to-end workflow. Specialist agents can also be selected directly for focused scenarios. Internal agents, including the following coordinators and workers, are invoked automatically:
    - `assessment-coordinator` - Internal coordinator for assessment phase
    - `planning-coordinator` - Internal coordinator for planning phase
    - `execution-coordinator` - Internal coordinator for execution phase
-   - `modernize-java-upgrade` - Internal agent for Java version upgrades
-   - `modernize-azure-java` - Internal agent for Azure migrations
+   - `modernize-azure-integration-tester` - Internal integration-test worker
+   - `modernize-rearchitecture-worker` - Internal rearchitecture worker
 
 3. The orchestrator will automatically:
    - Assess your application