From 5b73be9f43e0cf80c5756b01d0b3ddda0d770516 Mon Sep 17 00:00:00 2001
From: CleverThis <hal9000@cleverthis.com>
Date: Tue, 5 May 2026 14:30:56 +0000
Subject: [PATCH] docs: fix quickstart plan/apply command signatures

Update docs/quickstart.md to use correct CLI command signatures:
- Replace 'cleveragents plan --project' with 'cleveragents plan use <action> --project'
- Replace 'cleveragents apply --project' with 'cleveragents plan list' + 'cleveragents plan apply <plan-id>'

Addresses reviewer non-blocking suggestion to verify CLI commands match
actual signatures before merging.
---
 docs/quickstart.md | 10 ++++++----
 1 file changed, 6 insertions(+), 4 deletions(-)

diff --git a/docs/quickstart.md b/docs/quickstart.md
index f495088ea..21e01eaf7 100644
--- a/docs/quickstart.md
+++ b/docs/quickstart.md
@@ -32,10 +32,12 @@ Create a resource file under `resources/` (example YAML) and register it with th
 ## Plan and apply
 
 ```bash
-# Generate a plan
-cleveragents plan --project my-project
-# Review the plan, then apply
-cleveragents apply --project my-project
+# Create a plan using an action on your project
+cleveragents plan use <action-name> --project my-project
+# List plans to find the plan ID
+cleveragents plan list
+# Review the plan, then apply it by plan ID
+cleveragents plan apply <plan-id>
 ```
 
 ## Troubleshooting