fix: Align docs command session management with workflow standards

- 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>
This commit is contained in:
catlog22
2025-09-18 19:59:15 +08:00
parent d840171571
commit 44a699bd56

View File

@@ -40,10 +40,18 @@ The command performs structured planning and task creation:
**2. Task Generation** **2. Task Generation**
- **Create session**: `.workflow/WFS-docs-[timestamp]/` - **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 - **Generate IMPL_PLAN.md**: Documentation requirements and task breakdown
- **Create task.json files**: Individual documentation tasks with flow_control - **Create task.json files**: Individual documentation tasks with flow_control
- **Setup TODO_LIST.md**: Progress tracking for documentation generation - **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 ## Output Structure
``` ```
.workflow/docs/ .workflow/docs/
@@ -116,12 +124,14 @@ Each documentation task uses the workflow-architecture.md 5-field schema:
**Document Structure**: **Document Structure**:
``` ```
.workflow/WFS-docs-[timestamp]/ .workflow/
├── IMPL_PLAN.md # Main documentation plan ├── .active-WFS-docs-20231201-143022 # Active session marker (matches folder name)
── TODO_LIST.md # Progress tracking ── WFS-docs-20231201-143022/ # Documentation session folder
├── .process/ ├── IMPL_PLAN.md # Main documentation plan
── ANALYSIS_RESULTS.md # Documentation analysis ── TODO_LIST.md # Progress tracking
└── .task/ ├── .process/
│ └── ANALYSIS_RESULTS.md # Documentation analysis
└── .task/
├── IMPL-001.json # System overview task ├── IMPL-001.json # System overview task
├── IMPL-002.json # Module documentation task ├── IMPL-002.json # Module documentation task
├── IMPL-003.json # Architecture documentation task ├── IMPL-003.json # Architecture documentation task