Skip to content

feat(plan-work-items): classify each item's implementation, review, and expected paths - #226

Merged
mxriverlynn merged 1 commit into
v6.0.0-betafrom
feat/plan-work-items-item-classification
Oct 15, 2026
Merged

mxriverlynn merged 1 commit into
v6.0.0-betafrom
feat/plan-work-items-item-classification

Conversation

@mxriverlynn

Copy link
Copy Markdown
Collaborator

Replaces #111 by @taminomara, rebased onto v6.0.0-beta to resolve its merge conflicts. The original branch lives on a fork we can't push to, so this PR carries the same commit with @taminomara kept as the commit author. All credit for the change is theirs.

What the change does

plan-work-items now records, for each work item, which skill or agent should build it and which should review it, and whether each part can run unattended (AFK) or needs a human (HITL). Each item also records a Type (deliverable, audit, or spike), whether it needs a human decision before work starts, and the files it is expected to touch. A new deliverable-skill catalog maps each kind of deliverable to its suggested implementation and review.

How the conflicts were resolved

The skill changed a lot on v6.0.0-beta since #111 was opened, so the resolution adapts the change to the new shape rather than replaying it line for line:

  • The breakdown is now drafted by plan-synthesizer, not project-manager. The new directives sit beside the existing justification and drafting-order directives.
  • v6.0.0-beta removed the separate Tests block, so there is no Checks block. The audit and spike check guidance moved into Acceptance criteria.
  • Summary stays first. The classification fields (Type, Requires pre-work decisions, Suggested implementation, Suggested review, Expected paths) render after Acceptance criteria and before Depends on.
  • Catalog skill names updated for skills that moved out of han-core (han-documentation:*, han-research:research).
  • Long-form doc changes ported to its new home, han-planning/docs/skills/plan-work-items.md. Links to the implement-work-items doc were dropped, since that skill isn't in this repo yet; SKILL.md still offers it only when it is available.

Open from #111

The original PR was a draft, and @taminomara noted audit and spike were meant to merge into one type before it was ready. That is still open, so this PR is also a draft.

…nd expected paths

Enrich the producer so each work item carries the markers the downstream
driver needs, without pulling in the driver itself:

- Add a Type field (deliverable / audit / spike) and rename Tests -> Checks
  in the work-item template.
- Add Suggested implementation, Suggested review, Requires pre-work decisions,
  and Expected paths fields, selected via a new deliverable-skill catalog.
- Direct project-manager to derive those markers and expected paths, and close
  the run with the three-bucket (unattended / pauses-for-human) recommendation.
- Reframe the upstream unverified-assumptions guidance onto Requires pre-work
  decisions, since item-level HITL/AFK moves to the per-marker model.

Split out of feat/autonomous-driver-core-loop as a standalone producer-side
change; carries no implement-work-items edits.

Rebased onto v6.0.0-beta, resolving conflicts with the reworked skill:

- The breakdown is now dispatched to plan-synthesizer, not project-manager;
  the new directives sit beside the Justification and drafting-order ones.
- v6 removed the separate Tests block, so there is no Checks block; the
  audit and spike check guidance moved into Acceptance criteria.
- Summary stays first; the classification fields (Type, Requires pre-work
  decisions, Suggested implementation/review, Expected paths) render after
  Acceptance criteria and before Depends on.
- Catalog skill namespaces updated for skills that moved out of han-core
  (han-documentation, han-research).
- Long-form doc changes ported to han-planning/docs/skills/plan-work-items.md;
  links to the not-yet-merged implement-work-items doc dropped.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
Co-Authored-By: River Bailey <river.bailey@testdouble.com>
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01BvgX88kC9h9xbe4zGLf7BC
@mxriverlynn
mxriverlynn marked this pull request as ready for review October 15, 2026 15:19
@mxriverlynn
mxriverlynn merged commit 6c275e7 into v6.0.0-beta Oct 15, 2026
2 checks passed
@mxriverlynn
mxriverlynn deleted the feat/plan-work-items-item-classification branch October 15, 2026 15:19
@mxriverlynn mxriverlynn mentioned this pull request Oct 15, 2026
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.

2 participants