Files
Claude-Code-Workflow/.claude/workflows/todowrite-coordination-rules.md
catlog22 9502741d50 Remove granular progress tracking across workflow system
- Remove detailed progress views (Total Tasks: X, Completed: Y %) from all templates
- Simplify TODO_LIST.md structure by removing Progress Overview sections
- Remove stats tracking from session-management-principles.json schema
- Eliminate progress format and calculation logic from context command
- Remove percentage-based progress displays from action-planning-agent
- Simplify vibe command coordination by removing detailed task counts
- Focus on essential JSON state changes rather than UI progress metrics

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

Co-Authored-By: Claude <noreply@anthropic.com>
2025-09-08 15:26:01 +08:00

1.1 KiB

TodoWrite-Workflow Coordination Rules

Overview

This document defines the complete coordination system between Claude's TodoWrite tool and the workflow persistence layer (TODO_LIST.md and JSON task files).

TodoWrite Tool Architecture

Tool Purpose and Scope

TodoWrite Tool:

  • Claude's internal task coordination interface
  • Real-time progress tracking during active sessions
  • Agent coordination and status management
  • Immediate task visibility for execution context

NOT for:

  • Long-term task persistence (that's JSON task files)
  • Cross-session task continuity (that's TODO_LIST.md)
  • Historical task audit trails (that's workflow summaries)

Core Coordination Principles

Execution Order Rules

  1. Create TodoWrite FIRST - Before any agent coordination begins
  2. Real-time Updates - Agents update todo status during execution
  3. Progress Tracking - Maintain visible workflow state throughout
  4. Single Active Rule - Only one todo in_progress at any time
  5. Completion Gates - Mark completed only when truly finished
  6. Persistence Sync - TodoWrite changes trigger workflow file updates