Skip to content

Align execution skills with plan checkbox progress tracking#1628

Draft
jvalamis wants to merge 1 commit into
obra:mainfrom
jvalamis:fix/plan-checkbox-progress
Draft

Align execution skills with plan checkbox progress tracking#1628
jvalamis wants to merge 1 commit into
obra:mainfrom
jvalamis:fix/plan-checkbox-progress

Conversation

@jvalamis
Copy link
Copy Markdown

Summary

Plans and release notes say checkbox syntax is for agent progress tracking, but execution skills only documented TodoWrite and never instructed flipping - [ ]- [x] in the plan file — so every committed plan stayed all-unchecked after shipped work.

This PR aligns execution with authoring intent:

  • subagent-driven-development: Flowchart and "Plan progress" section require marking completed steps in the plan file; TodoWrite is optional mirror only.
  • executing-plans: Each verified step flips its checkbox in the plan file.
  • writing-plans: "Progress tracking (agents)" section documents plan-file updates as the durable log.
  • Document-review spec + codex-tools + testing.md: Same clarification.

Replaces the direction of closed PR #1626 (which incorrectly said checkboxes were human-only).

Test plan

  • Read subagent-driven-development — plan file updates required; no "do not flip checkboxes"
  • Read executing-plans Step 2 — - [ ]- [x] after verification
  • writing-plans header still says "syntax for tracking"
  • Run a small plan execution and confirm plan file gains - [x] entries

Plans say checkboxes are for agent tracking; SDD and executing-plans
only used TodoWrite and left plan files all-unchecked. Require flipping
- [ ] to - [x] in the plan file after verified steps; TodoWrite optional.
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