Files
Claude-Code-Workflow/.claude/commands/workflow/status.md
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

3.1 KiB

name, description, usage, argument-hint, examples
name description usage argument-hint examples
workflow:status Generate on-demand views from JSON task data /workflow:status [task-id]
optional
task-id
/workflow:status
/workflow:status impl-1
/workflow:status --validate

Workflow Status Command (/workflow:status)

Overview

Generates on-demand views from JSON task data. No synchronization needed - all views are calculated from the current state of JSON files.

Usage

/workflow:status                    # Show current workflow overview
/workflow:status impl-1             # Show specific task details
/workflow:status --validate         # Validate workflow integrity

Implementation Flow

Step 1: Find Active Session

find .workflow/ -name ".active-*" -type f 2>/dev/null | head -1

Step 2: Load Session Data

cat .workflow/WFS-session/workflow-session.json

Step 3: Scan Task Files

find .workflow/WFS-session/.task/ -name "*.json" -type f 2>/dev/null

Step 4: Generate Task Status

cat .workflow/WFS-session/.task/impl-1.json | jq -r '.status'

Step 5: Count Task Progress

find .workflow/WFS-session/.task/ -name "*.json" -type f | wc -l
find .workflow/WFS-session/.summaries/ -name "*.md" -type f 2>/dev/null | wc -l

Step 6: Display Overview

# Workflow Overview
**Session**: WFS-session-name
**Progress**: 3/8 tasks completed

## Active Tasks
- [⚠️] impl-1: Current task in progress
- [ ] impl-2: Next pending task

## Completed Tasks
- [✅] 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

# 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
  • /workflow:execute - Uses this for task discovery
  • /workflow:resume - Uses this for progress analysis
  • /workflow:session:status - Shows session metadata