From 44a699bd56a209936e676f355480de82db179233 Mon Sep 17 00:00:00 2001
From: catlog22 <catlog22@github.com>
Date: Thu, 18 Sep 2025 19:59:15 +0800
Subject: [PATCH] fix: Align docs command session management with workflow
 standards
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

- Add explicit active marker creation with matching session folder name
- Update session management to use .active-WFS-docs-[timestamp] format
- Add comprehensive session management documentation with critical warnings
- Update document structure example to show proper marker-folder relationship
- Ensure consistency with workflow-architecture.md session management patterns

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <noreply@anthropic.com>
---
 .claude/commands/workflow/docs.md | 30 ++++++++++++++++++++----------
 1 file changed, 20 insertions(+), 10 deletions(-)

diff --git a/.claude/commands/workflow/docs.md b/.claude/commands/workflow/docs.md
index 74e4d7ff..dd70ed68 100644
--- a/.claude/commands/workflow/docs.md
+++ b/.claude/commands/workflow/docs.md
@@ -40,10 +40,18 @@ The command performs structured planning and task creation:
 
 **2. Task Generation**
 - **Create session**: `.workflow/WFS-docs-[timestamp]/`
+- **Create active marker**: `.workflow/.active-WFS-docs-[timestamp]` (must match session folder name)
 - **Generate IMPL_PLAN.md**: Documentation requirements and task breakdown
 - **Create task.json files**: Individual documentation tasks with flow_control
 - **Setup TODO_LIST.md**: Progress tracking for documentation generation
 
+### Session Management ⚠️ CRITICAL
+- **Check for active sessions**: Look for `.workflow/.active-WFS-docs-*` markers
+- **Marker naming**: Active marker must exactly match session folder name
+- **Session creation**: `WFS-docs-[timestamp]` folder with matching `.active-WFS-docs-[timestamp]` marker
+- **Task execution**: Use `/workflow:execute` to run individual documentation tasks within active session
+- **Session isolation**: Each documentation session maintains independent context and state
+
 ## Output Structure
 ```
 .workflow/docs/
@@ -116,16 +124,18 @@ Each documentation task uses the workflow-architecture.md 5-field schema:
 
 **Document Structure**:
 ```
-.workflow/WFS-docs-[timestamp]/
-├── IMPL_PLAN.md           # Main documentation plan
-├── TODO_LIST.md           # Progress tracking
-├── .process/
-│   └── ANALYSIS_RESULTS.md   # Documentation analysis
-└── .task/
-    ├── IMPL-001.json      # System overview task
-    ├── IMPL-002.json      # Module documentation task
-    ├── IMPL-003.json      # Architecture documentation task
-    └── IMPL-004.json      # API documentation task
+.workflow/
+├── .active-WFS-docs-20231201-143022  # Active session marker (matches folder name)
+└── WFS-docs-20231201-143022/         # Documentation session folder
+    ├── IMPL_PLAN.md                  # Main documentation plan
+    ├── TODO_LIST.md                  # Progress tracking
+    ├── .process/
+    │   └── ANALYSIS_RESULTS.md       # Documentation analysis
+    └── .task/
+        ├── IMPL-001.json             # System overview task
+        ├── IMPL-002.json             # Module documentation task
+        ├── IMPL-003.json             # Architecture documentation task
+        └── IMPL-004.json             # API documentation task
 ```
 
 ### Task Flow Control Templates