feat: /docs:flow defaults to full lifecycle, use --only for specific flow

Author: binaryk

README.md

@@ -69,7 +69,7 @@ aidocs init .
 │                         DOCUMENT A MODULE                                    │
 ├──────────────────────────────────────────────────────────────────────────────┤
 │                                                                              │
-│  /docs:flow campaign --lifecycle    ← Just run this one command!             │
+│  /docs:flow campaign                ← Just run this one command!             │
 │           │                                                                  │
 │           ├──→ Auto-runs /docs:discover campaign (analyzes code)             │
 │           ├──→ Auto-runs /docs:explore campaign (tests UI)                   │
@@ -95,7 +95,7 @@ aidocs init .
 /docs:generate https://myapp.com/dashboard
 
 # Smart: Full module documentation (auto-discovers and explores)
-/docs:flow campaign --lifecycle
+/docs:flow campaign
 
 # Maintain: Update after code changes
 /docs:update --base main
@@ -252,8 +252,9 @@ Interactively explore a module's UI with Playwright:
 Document a complete entity lifecycle. **Auto-runs discover and explore if needed.**
 
 ```bash
-/docs:flow campaign                        # Smart flow detection
-/docs:flow campaign --lifecycle            # Full CRUD documentation
+/docs:flow campaign                        # Full CRUD lifecycle (default)
+/docs:flow campaign --only create          # Only document create flow
+/docs:flow campaign --only edit            # Only document edit flow
 /docs:flow "user registration"             # Custom flow description
 /docs:flow order --include-errors          # Include error states
 /docs:flow campaign --skip-explore         # Skip UI exploration (faster)
@@ -262,7 +263,7 @@ Document a complete entity lifecycle. **Auto-runs discover and explore if needed
 **What happens:**
 1. Auto-runs `/docs:discover` if module not analyzed yet
 2. Auto-runs `/docs:explore` if UI not explored yet
-3. Documents the complete flow with screenshots
+3. Documents full lifecycle (create → view → edit → delete) by default
 
 **Produces step-by-step guides with:**
 - Screenshots at each step

src/aidocs_cli/templates/workflows/flow/workflow.md

@@ -17,18 +17,21 @@ description: Document a complete entity lifecycle or custom user flow with cross
 
 Parse the arguments:
 ```
-/docs:flow <entity|"custom description"> [--lifecycle] [--include-errors] [--skip-explore] [--output]
+/docs:flow <entity|"custom description"> [--only <action>] [--include-errors] [--skip-explore] [--output]
 ```
 
 Examples:
 ```
-/docs:flow campaign                      # Smart detection of main flow
-/docs:flow campaign --lifecycle          # Full CRUD: create, view, edit, delete
+/docs:flow campaign                      # Full CRUD lifecycle (default)
+/docs:flow campaign --only create        # Only document create flow
+/docs:flow campaign --only edit          # Only document edit flow
 /docs:flow "user registration"           # Custom flow by description
 /docs:flow order --include-errors        # Include error states
-/docs:flow campaign --skip-explore       # Skip UI exploration (use existing knowledge)
+/docs:flow campaign --skip-explore       # Skip UI exploration (faster)
 ```
 
+**Default behavior:** Documents full lifecycle (create → view → edit → delete)
+
 ---
 
 ## STEP 1: AUTO-RUN PREREQUISITES