Skip to content

feat(structured-plan-mode): use native TaskCreate/TaskUpdate#14

Open
pemontto wants to merge 1 commit intoNikiforovAll:mainfrom
pemontto:feature/native-task-tracking
Open

feat(structured-plan-mode): use native TaskCreate/TaskUpdate#14
pemontto wants to merge 1 commit intoNikiforovAll:mainfrom
pemontto:feature/native-task-tracking

Conversation

@pemontto
Copy link

@pemontto pemontto commented Feb 8, 2026

Summary

  • Replace deprecated TodoWrite with Claude Code's native TaskCreate/TaskUpdate system
  • Phases 1-4 and implementation tasks (T01-T0N) are now registered as native tasks, writing to ~/.claude/tasks/
  • Enables external viewers (your claude-task-viewer, etc.) to display real-time progress
  • The .plans/ file structure is preserved as-is — native tasks are a lightweight index, not a replacement

Motivation

Claude Code now has a native task system (TaskCreate/TaskUpdate) that persists task state to ~/.claude/tasks/{session-uuid}/{id}.json. External tools like claude-task-viewer read from this location to provide kanban boards and cross-session visibility.

The current skill uses TodoWrite, which is session-scoped and invisible to external tooling. This PR bridges the gap by registering plan phases and implementation tasks in the native system alongside the existing .plans/ markdown files.

What Changed

Before After
TodoWrite for phases 1-4 TaskCreate for phases 1-4
No native tracking for T01-T0N TaskCreate for each implementation task in Phase 4
Dual-tracking (task file + plan.md) Triple-tracking (task file + plan.md + native task)
TodoWrite status updates TaskUpdate status transitions (in_progress/completed)
No external visibility Visible in ~/.claude/tasks/ for viewers

Non-Changes

  • .plans/[feature-name]/ directory structure: unchanged
  • plan.md content and format: unchanged
  • Task file (T01.md etc.) content and format: unchanged
  • assets/plan-template.md and references/task-planning-guide.md: unchanged
  • Phased workflow and user interaction model: unchanged

Test plan

  • Run /structured-plan-mode on a test feature, verify phases appear in ~/.claude/tasks/
  • Verify .plans/ directory and markdown files are still created as before
  • Confirm claude-task-viewer displays the session with phases and tasks
  • Check that TaskUpdate status transitions (in_progress, completed) are reflected in viewer
  • Verify task dependencies via addBlockedBy are correctly set

…TaskUpdate

Use Claude Code's native task system (TaskCreate/TaskUpdate) instead of
the deprecated TodoWrite for tracking phases and implementation tasks.
This writes task state to ~/.claude/tasks/, enabling external viewers
(claude-task-viewer, etc.) to display real-time progress.

The .plans/ file structure is preserved as the source of truth for
content. Native tasks serve as a lightweight index for external
visibility and cross-session tracking.

Key changes:
- Phase 1-4 registered via TaskCreate at setup
- Implementation tasks (T01-T0N) registered via TaskCreate in Phase 4
- Status updates in three places: task file, plan.md, native task system
- Task dependencies expressed via TaskUpdate addBlockedBy
@pemontto pemontto force-pushed the feature/native-task-tracking branch from 677c5a5 to 6365670 Compare February 8, 2026 02:15
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant