Skip to content

feat(po): plan-backlog guided mode by default (#72 v1) - #75

Merged
atamanvega merged 1 commit into
mainfrom
feat/plan-backlog-guided
Sep 9, 2026
Merged

feat(po): plan-backlog guided mode by default (#72 v1)#75
atamanvega merged 1 commit into
mainfrom
feat/plan-backlog-guided

Conversation

@atamanvega

Copy link
Copy Markdown
Collaborator

Implements the v1 of #72 (design settled with @santielizondo's feedback): plan-backlog stops dumping a whole backlog at once and instead elaborates progressively, keeping the definition work with the PO.

What changed

  • skills/plan-backlog/SKILL.md — guided by default. Three zoom levels (framing → epics → stories); at each, present 2–4 alternatives, recommend one, and wait for the PO's decision before going deeper. Framing helps define the problem, not just structure it. --quick keeps the one-shot draft.
  • Mode judged per invocation, never persisted — signals: repo docs + brief context; and there are two maturities (project's and the feature's), so a mature project can still need guidance. Always a light framing check.
  • New guardrail: facilitate, don't decide.
  • commands/plan-backlog.md — guided runs interactively in the main conversation (per-level decisions); --quick delegates to the backlog-planner subagent (draft → gate → create).
  • agents/backlog-planner.md — documented as the engine for --quick + discovery/creation; guided decisions are the caller's (a subagent's output isn't visible mid-run).

Verification

node scripts/build-codex-plugin.mjs && node scripts/validate-codex-plugin.mjs && node --test scripts/*.test.mjs && git diff --exit-code
# validate ✓ · 35/35 · skill synced, version aligned (0.19.11)

README + CHANGELOG updated. Closes #72.

🤖 Generated with Claude Code

From early-user feedback: the one-shot backlog did too much at once and absorbed the
product-discovery/definition that should stay with the PO.

- skills/plan-backlog/SKILL.md: guided by default — progressive zoom-out → zoom-in
  over three levels (framing → epics → stories), 2–4 alternatives + a decision at each
  level; framing helps *define*, not just structure. `--quick` keeps the one-shot draft.
  Mode judged per invocation from repo docs + brief context, never persisted (project
  maturity ≠ feature maturity), always with a light framing check. New "facilitate,
  don't decide" guardrail.
- commands/plan-backlog.md: guided runs in the main conversation (interactive, per-level
  decisions); --quick delegates to backlog-planner (draft → gate → create).
- agents/backlog-planner.md: documented as the engine for --quick + discovery/creation;
  guided per-level decisions are the caller's.
- README + CHANGELOG updated; version aligned to 0.19.11; node --test 35/35.

Design settled in #72 with @santielizondo's feedback.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
@vercel

vercel Bot commented Sep 9, 2026

Copy link
Copy Markdown

The latest updates on your projects. Learn more about Vercel for GitHub.

1 Skipped Deployment
Project Deployment Actions Updated
claude-dev-kit-telemetry-relay Ignored Ignored Preview Sep 9, 2026 6:19am UTC

Request Review

@atamanvega
atamanvega merged commit 8e65d3d into main Sep 9, 2026
3 checks passed
@atamanvega
atamanvega deleted the feat/plan-backlog-guided branch September 9, 2026 07:12
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.

plan-backlog: guided, project-maturity-aware mode (from user feedback)

1 participant