Modernize task and workflow documentation architecture

Based on Gemini CLI analysis, updated all command documentation to align with current Single Source of Truth (SSoT) architecture.

## Key Updates

### Command Reference Modernization
- Updated all `/task:context` and `/workflow:context` references to unified `/context` command
- Removed all references to deprecated `/task:sync` and `/workflow:sync` commands
- Updated related commands sections across all task and workflow files

### Architecture Alignment
- Clarified JSON-first data model where `.task/*.json` files are authoritative
- Updated descriptions to reflect that markdown files are generated views, not synchronized documents
- Removed outdated "bidirectional sync" concepts in favor of automatic data consistency

### File Reference Standardization
- Fixed `TODO_CHECKLIST.md` → `TODO_LIST.md` naming inconsistencies
- Updated workflow integration examples to use proper command names
- Standardized command integration descriptions

### Documentation Consistency
- Aligned task creation, breakdown, execution, and replanning documentation with current architecture
- Updated workflow issue integration to reflect JSON-based task creation
- Enhanced CHANGELOG.md with comprehensive documentation modernization details

## Impact
- Eliminates confusion about deprecated commands
- Provides accurate guidance on current system behavior
- Aligns documentation with actual implementation
- Reduces maintenance overhead by removing outdated synchronization concepts

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

Co-Authored-By: Claude <noreply@anthropic.com>
This commit is contained in:
catlog22
2025-09-07 23:22:26 +08:00
parent 46911ec251
commit 503386a14b
6 changed files with 16 additions and 9 deletions

View File

@@ -36,6 +36,14 @@
- **ENHANCED**: Consistent session handling in gemini-chat, gemini-execute, gemini-mode, workflow commands
- **IMPROVED**: Error handling for missing session registry files
#### Documentation Modernization & Architecture Alignment
- **UPDATED**: All command references to use unified `/context` command instead of deprecated `/task:context` and `/workflow:context`
- **REMOVED**: All references to deprecated `/task:sync` and `/workflow:sync` commands
- **ALIGNED**: Task and workflow documentation with Single Source of Truth (SSoT) architecture
- **CLARIFIED**: JSON-first data model where `.task/*.json` files are authoritative and markdown files are generated views
- **STANDARDIZED**: File naming consistency (TODO_CHECKLIST.md → TODO_LIST.md)
- **ENHANCED**: Command integration descriptions to reflect automatic data consistency instead of manual synchronization
## [Previous] - 2025-01-28
### ✨ New Features