refactor(workflow): remove redundant sections, focus on core responsibilities

Streamline workflow command documentation by removing sections that don't belong to core command responsibilities.

## Changes

### init.md (-46 lines)
- Remove Integration with Existing Commands section
- Remove Performance Considerations section
- Remove Related Commands section
- Focus: Project initialization and analysis only

### session/complete.md (-30 lines)
- Remove Quick Commands reference section
- Remove Archive Query Commands section
- Focus: Session archival and feature registry updates only

### session/start.md (-34 lines)
- Remove Simple Bash Commands reference section
- Keep: Session ID Format (specification/standard)
- Focus: Session creation and discovery only

### status.md (-165 lines)
- Remove Simple Bash Commands section
- Remove Simple Output Format examples
- Remove Project Mode Quick Commands section
- Focus: Status display logic only

### context-gather.md (-29 lines)
- Remove Usage Examples section
- Remove Success Criteria section
- Remove Error Handling table
- Keep: Notes (core design principles)
- Focus: Context gathering orchestration only

## Benefits
- Reduced documentation redundancy (~304 lines removed)
- Clearer command responsibilities and boundaries
- Easier maintenance and updates
- Commands focus on their specific roles in workflow

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

Co-Authored-By: Claude <noreply@anthropic.com>
This commit is contained in:
catlog22
2025-11-18 11:21:35 +08:00
parent 4dafec7054
commit 2aacc34c24
5 changed files with 0 additions and 304 deletions

View File

@@ -192,170 +192,4 @@ find .workflow/WFS-session/.summaries/ -name "*.md" -type f 2>/dev/null | wc -l
## Completed Tasks
- [COMPLETED] impl-0: Setup completed
```
## Simple Bash Commands
### Basic Operations
- **Find active session**: `find .workflow/ -name ".active-*" -type f`
- **Read session info**: `cat .workflow/session/workflow-session.json`
- **List tasks**: `find .workflow/session/.task/ -name "*.json" -type f`
- **Check task status**: `cat task.json | jq -r '.status'`
- **Count completed**: `find .summaries/ -name "*.md" -type f | wc -l`
### Task Status Check
- **pending**: Not started yet
- **active**: Currently in progress
- **completed**: Finished with summary
- **blocked**: Waiting for dependencies
### Validation Commands
```bash
# Check session exists
test -f .workflow/.active-* && echo "Session active"
# Validate task files
for f in .workflow/session/.task/*.json; do jq empty "$f" && echo "Valid: $f"; done
# Check summaries match
find .task/ -name "*.json" -type f | wc -l
find .summaries/ -name "*.md" -type f 2>/dev/null | wc -l
```
## Simple Output Format
### Default Overview
```
Session: WFS-user-auth
Status: ACTIVE
Progress: 5/12 tasks
Current: impl-3 (Building API endpoints)
Next: impl-4 (Adding authentication)
Completed: impl-1, impl-2
```
### Task Details
```
Task: impl-1
Title: Build authentication module
Status: completed
Agent: code-developer
Created: 2025-09-15
Completed: 2025-09-15
Summary: .summaries/impl-1-summary.md
```
### Validation Results
```
Session file valid
8 task files found
3 summaries found
5 tasks pending completion
```
## Project Mode Quick Commands
### Basic Operations
```bash
# Check if project initialized
bash(test -f .workflow/project.json && echo "Initialized" || echo "Not initialized")
# Read project data
bash(cat .workflow/project.json)
# Count total features
bash(cat .workflow/project.json | jq '.statistics.total_features')
# List all feature IDs
bash(cat .workflow/project.json | jq -r '.features[].id')
# Find feature by keyword
bash(cat .workflow/project.json | jq '.features[] | select(.title | test("auth"; "i"))')
# Get most recent feature
bash(cat .workflow/project.json | jq '.features | sort_by(.implemented_at) | reverse | .[0]')
# List archived sessions
bash(ls -1t .workflow/.archives/WFS-* 2>/dev/null | head -5)
```
### Output Comparison
**Project Overview** (`--project`):
```
## Project: claude_dms3
Initialized: 2025-01-18T10:00:00Z
### Overview
TypeScript workflow automation system with AI agent orchestration
**Technology Stack**:
- TypeScript (primary): 150 files
- Bash: 30 files
Frameworks: Node.js
**Architecture**:
Style: Agent-based workflow orchestration with modular command system
Patterns: Command Pattern, Agent Pattern, Template Method
**Key Components** (3):
- Workflow Planning (.claude/commands/workflow)
Multi-phase planning workflow with brainstorming and task generation
- Agent System (.claude/agents)
Specialized agents for code development, testing, documentation
- CLI Tool Integration (.claude/scripts)
Gemini, Qwen, Codex wrapper scripts for AI-powered analysis
**Metrics**:
- Files: 180
- Lines of Code: 15000
- Complexity: medium
---
### Completed Features (2)
- Authentication System (2025-01-15)
JWT-based authentication with OAuth2 support
Tags: auth, security, api
Session: WFS-auth-system
Archive: .workflow/.archives/WFS-auth-system
Commit: a1b2c3d
- Workflow Planning (2025-01-10)
Multi-phase planning workflow with agent coordination
Tags: workflow, planning
Session: WFS-workflow-v2
Archive: .workflow/.archives/WFS-workflow-v2
Commit: e5f6g7h
### Project Statistics
- Total Features: 2
- Total Sessions: 15
- Last Updated: 2025-01-18T15:30:00Z
### Query Commands
# Find by tag
cat .workflow/project.json | jq '.features[] | select(.tags[] == "auth")'
# View archive
cat .workflow/.archives/WFS-auth-system/IMPL_PLAN.md
# List all tags
cat .workflow/project.json | jq -r '.features[].tags[]' | sort -u
# Regenerate project analysis
/workflow:init --regenerate
```
**Session Overview** (default):
```
Session: WFS-user-auth
Status: ACTIVE
Progress: 5/12 tasks
Current: impl-3 (Building API endpoints)
Next: impl-4 (Adding authentication)
Completed: impl-1, impl-2
```