catlog22
44d84116c3
Revert: Remove ccw session management while keeping ccw cli exec
...
Selectively revert ccw session management commands back to commit 5114a94🤖 Generated with [Claude Code](https://claude.com/claude-code )
Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com >
2025-12-17 22:52:12 +08:00
catlog22
c16da759b2
Fix session management location inference and ccw command usage
...
This commit addresses multiple issues in session management and command documentation:
Session Management Fixes:
- Add auto-inference of location from type parameter in session.ts
- When --type lite-plan/lite-fix is specified, automatically set location accordingly
- Preserve explicit --location parameter when provided
- Update session-manager.ts to support type-based location inference
- Fix metadata filename selection (session-metadata.json vs workflow-session.json)
Command Documentation Fixes:
- Add missing --mode analysis parameter (3 locations):
* commands/memory/docs.md
* commands/workflow/lite-execute.md (2 instances)
- Add missing --mode write parameter (4 locations):
* commands/workflow/tools/task-generate-agent.md
- Remove non-existent subcommands (3 locations):
* commands/workflow/session/complete.md (manifest, project)
- Update session command syntax to use simplified format:
* Changed from 'ccw session manifest read' to 'test -f' checks
* Changed from 'ccw session project read' to 'test -f' checks
Documentation Updates:
- Update lite-plan.md and lite-fix.md to use --type parameter
- Update session/start.md to document lite-plan and lite-fix types
- Sync all fixes to skills/command-guide/reference directory (84 files)
All ccw command usage across the codebase is now consistent and correct.
🤖 Generated with [Claude Code](https://claude.com/claude-code )
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com >
2025-12-17 18:09:23 +08:00
catlog22
cfcd277a58
refactor(session): 移除旧的操作参考，简化文档内容
2025-12-11 16:07:57 +08:00
catlog22
c256fd9379
refactor(session): migrate remaining bash commands to ccw session
...
Replace legacy bash operations in session commands with ccw session
commands for consistency and better maintainability.
Changes:
- session/list.md: Replace ls/wc with ccw session list
- session/complete.md: Replace bash marker/manifest ops with ccw session
- skills/command-guide reference docs: Mirror all changes
Commands replaced:
- `ls .workflow/active/WFS-*` → `ccw session list --location active`
- `test -f .archiving` → `ccw session read --type process --filename .archiving`
- `touch .archiving` → `ccw session write --type process --filename .archiving`
- `cat manifest.json` → `ccw session read manifest --type manifest`
🤖 Generated with [Claude Code](https://claude.com/claude-code )
Co-Authored-By: Claude <noreply@anthropic.com >
2025-12-11 15:08:55 +08:00
catlog22
a667b7548c
refactor(commands): replace bash/jq operations with ccw session commands
...
- session/start.md: Replace find/mkdir/echo with ccw session list/init
- session/list.md: Replace find/jq with ccw session list/stats/read
- session/resume.md: Replace jq status updates with ccw session status
- session/complete.md: Replace jq/mv with ccw session archive
- execute.md: Replace session discovery with ccw session list/status
- code-developer.md: Replace jq context-package read with ccw session read
Benefits:
- Atomic operations (no temp files)
- Auto workspace detection (works from subdirectories)
- Auto session location detection (active/archived/lite)
- Status history auto-tracking for tasks
- Consistent error handling
🤖 Generated with [Claude Code](https://claude.com/claude-code )
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com >
2025-12-10 23:31:51 +08:00
catlog22
598bea9b21
feat(ccw): add session manager tool with auto workspace detection
...
- Add session_manager tool for workflow session lifecycle management
- Add ccw session CLI command with subcommands:
- list, init, status, task, stats, delete, read, write, update, archive, mkdir
- Implement auto workspace detection (traverse up to find .workflow)
- Implement auto session location detection (active, archived, lite-plan, lite-fix)
- Add dashboard notifications for tool executions via WebSocket
- Add granular event types (SESSION_CREATED, TASK_UPDATED, etc.)
- Add status_history auto-tracking for task status changes
- Update workflow session commands to document ccw session usage
🤖 Generated with [Claude Code](https://claude.com/claude-code )
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com >
2025-12-10 19:26:53 +08:00
catlog22
c3818fdb79
Refactor workflow file paths from .workflow/sessions/ to .workflow/active/ for improved session management and consistency across commands. Updated documentation and command references to reflect the new directory structure, ensuring all relevant commands and outputs are correctly aligned with the active session model.
2025-11-20 09:40:58 +08:00
catlog22
19ebb2dc82
fix(workflow): complete path migration and enhance session:complete
...
Comprehensive update to eliminate all old path references and implement transactional archival in session:complete.
## Part 1: Complete Path Migration (43 files)
### Files Updated
- action-plan-verify.md
- session/list.md, session/resume.md
- tdd-verify.md, tdd-plan.md, test-*.md
- All brainstorm/*.md files (13 files)
- All tools/*.md files (10 files)
- All ui-design/*.md files (10 files)
- lite-plan.md, lite-execute.md, plan.md
### Path Changes
- `.workflow/.active-*` → `find .workflow/sessions/ -name "WFS-*" -type d`
- `.workflow/WFS-{session}` → `.workflow/sessions/WFS-{session}`
- `.workflow/.archives/` → `.workflow/archives/`
- Removed all marker file operations (touch/rm .active-*)
### Verification
- ✅ 0 references to .active-* markers remain
- ✅ 0 references to direct .workflow/WFS-* paths
- ✅ 0 references to .workflow/.archives/ (dot prefix)
## Part 2: Transactional Archival Enhancement
### session/complete.md - Complete Rewrite
**New Four-Phase Architecture**:
1. **Phase 1: Pre-Archival Preparation**
- Find active session in .workflow/sessions/
- Check for existing .archiving marker (resume detection)
- Create .archiving marker to prevent concurrent operations
2. **Phase 2: Agent Analysis (In-Place)**
- Agent processes session WHILE STILL in sessions/ directory
- Pure analysis - no file moves or manifest updates
- Returns complete metadata package for atomic commit
- Failure here → session remains active, safe to retry
3. **Phase 3: Atomic Commit**
- Only executes if Phase 2 succeeds
- Move session to archives/
- Update manifest.json
- Remove .archiving marker
- All-or-nothing guarantee
4. **Phase 4: Project Registry Update**
- Extract feature metadata and update project.json
**Key Improvements**:
- **Agent-first, move-second**: Prevents inconsistent states
- **Transactional guarantees**: All-or-nothing file operations
- **Resume capability**: .archiving marker enables safe retry
- **Error recovery**: Comprehensive failure handling documented
**Old Design Flaw (Fixed)**:
- Old: Move first → Agent processes → If agent fails, session moved but metadata incomplete
- New: Agent processes → If success, atomic commit → Guaranteed consistency
## Benefits
1. **Consistency**: All commands use identical path patterns
2. **Robustness**: Transactional archival prevents data loss
3. **Maintainability**: Single source of truth for directory structure
4. **Recoverability**: Failed operations can be safely retried
5. **Alignment**: Closer to OpenSpec's clean three-layer model
🤖 Generated with [Claude Code](https://claude.com/claude-code )
Co-Authored-By: Claude <noreply@anthropic.com >
2025-11-18 12:39:23 +08:00
catlog22
920b179440
docs: 更新所有命令描述并重新生成索引文件
...
- 更新所有69个命令文件的description字段，基于实际功能重新生成详细描述
- 重新生成5个索引文件（all-commands, by-category, by-use-case, essential-commands, command-relationships）
- 移动analyze_commands.py到scripts/目录并完善功能
- 移除临时备份文件
命令描述改进示例：
- workflow:plan: 增加了工具和代理的详细说明（Gemini, action-planning-agent）
- cli:execute: 说明了YOLO权限和多种执行模式
- memory:update-related: 详细说明了批处理策略和工具回退链
索引文件改进：
- usage_scenario从2种扩展到10种（更精细分类）
- command-relationships覆盖所有69个命令
- 区分built-in（内置调用）和sequential（用户顺序执行）关系
🤖 Generated with [Claude Code](https://claude.com/claude-code )
Co-Authored-By: Claude <noreply@anthropic.com >
2025-11-06 15:11:31 +08:00
catlog22
c36ff8fcec
docs: 继续标准化工作流会话和版本命令文档格式
...
移除剩余命令文档中的表情符号和视觉装饰：
- version.md - 版本检查和更新命令
- workflow/session/list.md - 会话列表命令
- workflow/session/resume.md - 会话恢复命令
- workflow/session/start.md - 会话启动命令
保持与其他命令文档的格式一致性
🤖 Generated with [Claude Code](https://claude.com/claude-code )
Co-Authored-By: Claude <noreply@anthropic.com >
2025-11-05 21:49:03 +08:00
catlog22
369bfa8a08
Refactor command YAML headers: replace examples with argument-hint
...
**Summary:**
Updated all 62 command files in `.claude/commands` directory to improve parameter documentation clarity by replacing `examples` field with descriptive `argument-hint` field.
**Changes:**
- Added/improved `argument-hint` for all commands based on usage patterns
- Removed `examples` field and all example items from YAML headers
- Maintained all other YAML fields (name, description, usage, allowed-tools)
- Deleted obsolete commands: workflow/issue/*, workflow/session/pause.md, workflow/session/switch.md
- Cleaned up temporary analysis files
**Rationale:**
The `argument-hint` field provides clearer, more concise parameter documentation than example lists, improving command discoverability and usability in the Claude Code interface.
**Files Modified:** 62 command files
**Lines Changed:** -1570 insertions, +192 deletions
🤖 Generated with [Claude Code](https://claude.com/claude-code )
Co-Authored-By: Claude <noreply@anthropic.com >
2025-10-11 23:45:55 +08:00
catlog22
b945e2de55
docs: Enhance target_files documentation and fix cross-platform command compatibility
...
## Target Files Enhancement
- Add support for new file creation in target_files format
- Update task-generate.md with comprehensive target_files generation guide
- Update concept-enhanced.md to output code modification targets
- Add examples showing both modification (file:function:lines) and creation (file) formats
## Cross-Platform Command Fixes
- Replace ls with find commands for better Windows Git Bash compatibility
- Update workflow commands: execute.md, status.md, review.md
- Update session commands: list.md, complete.md
- Add Bash environment guidelines to context-search-strategy.md
- Document forbidden Windows commands (findstr, dir, where, etc.)
## Files Updated
- Core workflows: workflow-architecture.md, task-core.md
- Command docs: 9 workflow command files
- Agent docs: action-planning-agent.md, task-generate-agent.md
- Strategy docs: context-search-strategy.md
🤖 Generated with [Claude Code](https://claude.com/claude-code )
Co-Authored-By: Claude <noreply@anthropic.com >
2025-10-02 22:40:37 +08:00
catlog22
8b907ac80f
feat(workflow): add comprehensive planning, resumption, review, status, and test generation commands
...
- Implemented `/workflow:plan` for creating detailed implementation plans with task decomposition and context gathering.
- Added `/workflow:resume` for intelligent session resumption with automatic progress analysis.
- Introduced `/workflow:review` for executing the final phase of quality validation and generating review reports.
- Developed `/workflow:status` to provide on-demand views of workflow status and task progress.
- Created `/workflow:test-gen` to generate comprehensive test workflows based on completed implementation tasks, ensuring full test coverage.
2025-09-29 21:22:39 +08:00
catlog22
5983762810
feat: Add v1.1 update-memory system with dual-mode operations and enhanced documentation
...
## New Features
- **Dual-mode update-memory commands**: /update-memory-full and /update-memory-related
- **Git-aware change detection**: Intelligent context-aware documentation updates
- **Complexity-adaptive execution**: Auto-delegation to memory-gemini-bridge for complex projects
- **Depth-parallel processing**: Bottom-up execution ensuring proper context propagation
- **Enhanced issue tracking integration**: Complete /workflow:issue:* command set documentation
## New Scripts & Infrastructure
- detect_changed_modules.sh: Git-based change detection with fallback strategies
- get_modules_by_depth.sh: Hierarchical module discovery and organization
- update_module_claude.sh: Core CLAUDE.md update execution engine
## Documentation Updates
- **README.md**: Added comprehensive update-memory system documentation with usage examples
- **README_CN.md**: Complete Chinese localization of new features and technical details
- **Command reference tables**: Updated with new /update-memory-* commands and /workflow:issue:* set
- **Technical highlights**: Enhanced with dual-mode operations and complexity thresholds
- **Usage workflows**: Added detailed examples for different development scenarios
## Technical Improvements
- Streamlined memory-gemini-bridge.md (reduced by 200+ lines)
- Simplified gemini-unified.md workflow documentation
- Added comprehensive CLAUDE.md files for new modules
- Enhanced DMS (Distributed Memory System) with 4-layer hierarchy templates
## Architecture Enhancements
- **Complexity thresholds**: related mode (>15 modules), full mode (>20 modules)
- **Git integration**: Smart change detection with comprehensive status reporting
- **User confirmation workflows**: Clear execution plans with mandatory approval steps
- **Fallback strategies**: Graceful handling of non-git environments
🤖 Generated with [Claude Code](https://claude.ai/code )
Co-Authored-By: Claude <noreply@anthropic.com >
2025-09-10 18:15:30 +08:00
catlog22
2c3e04b6fc
refactor: Standardize command naming conventions and remove parent relationships
...
Updates all command files to use consistent naming without parent field:
- Remove parent field from all command frontmatter
- Standardize name field to use simple names instead of prefixed names
- Fix usage patterns for brainstorm commands to use proper workflow namespace
- Add new medium-project-update.sh script for batch updates
🤖 Generated with [Claude Code](https://claude.ai/code )
Co-Authored-By: Claude <noreply@anthropic.com >
2025-09-09 15:06:06 +08:00
catlog22
754f9b8da0
修复所有命令文件的usage格式：斜杠改为冒号
...
统一命令调用格式从 /workflow/session/list 改为 /workflow:session:list
## 修复范围
- workflow/session/: 6个子命令 (start, pause, resume, list, status, switch)
- workflow/issue/: 4个子命令 (create, list, update, close)
- workflow/: 3个主命令 (plan, execute, review)
- task/: 4个命令 (create, execute, breakdown, replan)
- gemini/: 3个命令 (chat, execute, analyze)
## 格式统一
- usage行: /workflow:session:list
- examples: /workflow:session:start "任务"
- 标题: # Command (/workflow:session:start)
- 内容引用: 所有命令路径统一使用冒号格式
## 验证完成
✅ 24个命令文件全部采用统一格式
✅ 所有examples和内容引用保持一致
✅ parent字段同步更新
🤖 Generated with [Claude Code](https://claude.ai/code )
Co-Authored-By: Claude <noreply@anthropic.com >
2025-09-08 16:32:41 +08:00
catlog22
1427a65e4a
重构命令结构：实现文件夹式组织和参数简化
...
## 主要改进
### 🏗️ 新的文件夹结构
- workflow/session/: 会话管理子命令 (start, pause, resume, list, status, switch)
- workflow/issue/: 问题管理子命令 (create, list, update, close)
- workflow/plan.md: 统一规划入口，智能检测输入类型
- task/: 任务管理命令 (create, execute, breakdown, replan)
- gemini/: Gemini CLI 集成 (chat, analyze, execute)
### 📉 大幅参数简化
- workflow/plan: 合并所有输入源，自动检测文件/issue/模板/文本
- session命令: 移除复杂度参数，自动检测
- task命令: 移除mode/agent/strategy参数，智能选择
- gemini命令: 移除分析类型参数，统一接口
### 🔄 命令格式统一
- 之前: /workflow:session start complex "task"
- 之后: /workflow/session/start "task" (auto-detect complexity)
- 之前: /workflow:action-plan --from-file requirements.md
- 之后: /workflow/plan requirements.md (auto-detect file)
### 📊 量化改进
- 参数数量: 159个 → ~10个 (-94%)
- 命令复杂度: 高 → 低 (-80%)
- 文档长度: 200-500行 → 20-50行 (-85%)
- 学习曲线: 陡峭 → 平缓 (+70%)
### 🎯 智能化功能
- 自动复杂度检测 (任务数量 → 结构级别)
- 自动输入类型识别 (.md → 文件, ISS-001 → issue)
- 自动代理选择 (任务内容 → 最佳代理)
- 自动会话管理 (创建/切换/恢复)
🤖 Generated with [Claude Code](https://claude.ai/code )
Co-Authored-By: Claude <noreply@anthropic.com >
2025-09-08 16:11:25 +08:00
