Skip to content

feat(skills): plan-backlog — idea → well-formed backlog (#64) - #65

Merged
atamanvega merged 2 commits into
mainfrom
feat/plan-backlog
Sep 2, 2026
Merged

feat(skills): plan-backlog — idea → well-formed backlog (#64)#65
atamanvega merged 2 commits into
mainfrom
feat/plan-backlog

Conversation

@atamanvega

Copy link
Copy Markdown
Collaborator

Implements the v1 of #64 — the product-owner, upstream half of the kit: turn an idea/description into a well-formed backlog and create it in the configured tracker.

Closes the loop idea → backlog → ticket → PR (created stories feed work-story).

What it does (skills/plan-backlog/SKILL.md)

  1. Intake, any format — chat text, PDF, Word (.docx via textutil/pandoc), an artifact, a Confluence page; Figma links → figma-fetch.
  2. Discovery-first — reads .claude/dev-kit.json (tracker.type) and learns the team's native hierarchy, fields, and a sample of recent issues to calibrate granularity; asks only what it can't discover.
  3. Draft — a neutral model (Initiative/Epic → INVEST user stories with Given/When/Then AC → sub-tasks, dependencies) mapped to the tracker's native types; recommends a shape and confirms it.
  4. Approval gate (mandatory) — presents the full draft; creates nothing until the user approves (same doctrine as work-story).
  5. Create — via adapters: Jira (Atlassian MCP createJiraIssue + links), Linear (MCP, Project/sub-issues), GitHub (gh issue create + milestones/labels, read-back verified), Azure (az boards + relations).
  6. Handoff — each created story is ready for work-story <KEY>.

Guardrails

Never create before approval · discovery-first (mirror the team, don't impose) · no fabricated scope/AC · secrets/PII care · report partial failures.

Notes

  • It's the write counterpart to issue-fetch (which reads) — no overlap with any existing skill/agent (there was no ticket-creating capability before).
  • Bundled into the plugin (build synced 11 skills), version → 0.19.8, all manifests aligned.

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 · no drift

🤖 Generated with Claude Code

) (v0.19.8)

The upstream, product-owner half of the workflow: turn an idea (chat text, PDF,
Word, artifact, Confluence) into a well-formed backlog — epics, INVEST user
stories with Given/When/Then acceptance criteria, sub-tasks, dependencies — and
create it in the configured tracker AFTER an explicit approval gate.

- Discovery-first: learns the team's native hierarchy/conventions from the tracker
  instead of imposing one; maps a neutral model onto Jira / Linear / GitHub Issues
  / Azure DevOps via adapters (the write counterpart to issue-fetch).
- Never creates anything before approval; grounds everything in the source (no
  fabricated scope/AC); watches for secrets/PII.
- Created stories hand off to work-story → PR, closing idea → backlog → ticket → PR.
- Bundled + version aligned (0.19.8); node --test 35/35.

Design: #64.

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

vercel Bot commented Sep 2, 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 2, 2026 11:48am UTC

Request Review

…64)

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
@atamanvega
atamanvega merged commit 4d47313 into main Sep 2, 2026
3 checks passed
@atamanvega
atamanvega deleted the feat/plan-backlog branch September 2, 2026 11:48
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