feat: integrate native task system for real-time orchestration#186
feat: integrate native task system for real-time orchestration#186
Conversation
Add guidance for using Claude Code's native task tools (TaskCreate, TaskUpdate, TaskList) during phase execution: - Native tasks = session coordination layer (real-time tracking) - Markdown tasks.md = persistent record (survives compactions) Key changes to commands/tasks.md: - New "Real-Time Task Coordination" section explaining two-layer approach - TaskUpdate calls in sequential phase execution flow - TaskList usage for parallel phase dependency tracking Key changes to templates/tasks-template.md: - "Real-Time Coordination" section in Orchestration Model - Setup instructions for creating tasks with blockedBy dependencies - Updated sequential/parallel execution to use native task status - Checkpoint sync instructions for markdown persistence The blockedBy feature automatically enforces TDD order (can't start Tests until Stub completes) and surfaces ready-to-dispatch work via TaskList. Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
![chatgpt-codex-connector[bot]](https://avatars.githubusercontent.com/in/1144995?s=60&v=4){kind=small}
There was a problem hiding this comment.
💡 Codex Review
Here are some automated review suggestions for this pull request.
Reviewed commit: 90f20ddc2a
ℹ️ About Codex in GitHub
Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you
- Open a pull request for review
- Mark a draft as ready
- Comment "@codex review".
If Codex has suggestions, it will comment; otherwise it will react with 👍.
Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".
commands/tasks.md
Outdated
| → On success: `TaskUpdate: "Phase N: Validate" status: completed` | ||
|
|
||
| **IMPORTANT**: Update tasks.md checkboxes immediately after each subagent returns successfully. This keeps progress visible and ensures state is preserved across context compactions. | ||
| **At phase completion**: Update tasks.md checkboxes to sync the persistent record. This ensures state is preserved across context compactions. |
There was a problem hiding this comment.
If a context compaction or session interruption happens mid‑phase, native Task* state is lost and the markdown file is the only persistent record. This instruction delays updating tasks.md until the end of the phase set, so any completed Stub/Tests/Implement steps since the last checkpoint are dropped, leading to re‑running work or misordered dependencies on resume. To preserve progress across compactions, the markdown sync needs to happen after each task completion (or at least after each step), not only at phase completion.
Useful? React with 👍 / 👎.
- Use consistent short format "PN: Step" (e.g., "P1: Stub") for task names - Clarify markdown sync happens after each phase, not just at checkpoints - Replace "..." with explicit comment "(repeat pattern for each phase)" Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
# [4.1.0](v4.0.1...v4.1.0) (2026-01-23) ### Features * integrate native task system for real-time orchestration ([#186](#186)) ([d64eee1](d64eee1))
|
🎉 This PR is included in version 4.1.0 🎉 The release is available on GitHub release Your semantic-release bot 📦🚀 |
1 participant
Summary
TaskCreate,TaskUpdate,TaskList) during phase-based orchestrationblockedBydependency tracking (Claude Code v2.1.16)Changes
commands/tasks.md- New "Real-Time Task Coordination" section with TaskUpdate callstemplates/tasks-template.md- Setup instructions and updated execution patternsHow it works
blockedBydependenciesTaskUpdatestatus as subagents dispatch/completeTaskList: See what's unblocked and ready to dispatchBenefits
blockedByenforces TDD order automaticallyTaskListshows exactly what's ready vs. blockedTest plan
🤖 Generated with Claude Code