Skip to content

feat(plan): add bite-sized work item decomposition#246

Open
mvanhorn wants to merge 2 commits intoEveryInc:mainfrom
mvanhorn:feat/plan-work-items
Open

feat(plan): add bite-sized work item decomposition#246
mvanhorn wants to merge 2 commits intoEveryInc:mainfrom
mvanhorn:feat/plan-work-items

Conversation

@mvanhorn
Copy link
Contributor

Summary

  • Adds Phase 5.5: Work Item Decomposition to /ce:plan that generates structured, bite-sized work items
  • Each task is 2-5 minutes with exact file paths, complete code, verification commands, and commit boundaries
  • ## Work Items section added to MORE template (3-8 tasks) and A LOT template (5-15 tasks grouped by phase)
  • MINIMAL template unchanged - quick issues stay quick
  • No changes to ce:work needed - structured format is valid markdown it already parses

Motivation

/ce:work Phase 1 Step 3 says "Use TodoWrite to break plan into actionable tasks" - but this decomposition happens ad-hoc at runtime, without the planning context. Plans should do the heavy lifting (80/20 philosophy).

Superpowers (42K stars) attributes much of its quality to this exact pattern - their plans produce 2-5 minute steps with exact paths, complete code, run commands, and expected output.

Related: #146 "Plan with files"

Changes

File Lines What
commands/ce/plan.md +98 Phase 5.5 instructions + Work Items in MORE and A LOT templates
.claude-plugin/plugin.json +1/-1 Version bump 2.38.1 -> 2.38.2
CHANGELOG.md +6 Entry for this change

Test plan

  • Run /ce:plan "add user auth" and select MORE - verify Work Items section appears with file paths, code, and verification commands
  • Run /ce:plan "simple typo fix" and select MINIMAL - verify no Work Items section
  • Run /ce:plan "major refactor" and select A LOT - verify Work Items grouped into phases
  • Run /ce:work on a plan with Work Items - verify TodoWrite picks up tasks correctly

Closes #245
Refs #146

Compound Engineered Generated with Claude Code

Plans now include structured Work Items sections with exact file paths,
complete code snippets, verification commands, and commit boundaries.
Phase 5.5 decomposes implementation into 2-5 minute tasks that ce:work
can execute directly as TodoWrite items. TDD-first when applicable.

Only for MORE and A LOT detail levels - MINIMAL stays quick.

Closes EveryInc#245
Refs EveryInc#146

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
## Work Items

> Ordered by dependency. Each task is 2-5 minutes.
> ce:work will use these as TodoWrite items.
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Avoid mentioning specific tool names so we can be agnostic to claude code vs codex etc

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Removed the tool name reference. Now reads "Use these as TodoWrite items during implementation." 275f312

## Work Items

> Ordered by dependency. Each task is 2-5 minutes.
> ce:work will use these as TodoWrite items.
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

ditto here, don't name specific tools like this

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Fixed in the same commit. 275f312

Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Remove this change, changelog is generated with release process.

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Reverted. 275f312

Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Remove the version bump, auto release process handles it

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Reverted. 275f312

- Remove tool-specific references (ce:work, TodoWrite) from plan
  templates to keep content tool-agnostic
- Revert CHANGELOG.md entry (auto-generated by release process)
- Revert plugin.json version bump (auto-release handles versioning)

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
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.

feat(plan): add bite-sized work item decomposition to ce:plan

2 participants