coleam00/skills

plan-create-stories

Decomposes a PRD into well-formed, engineer-ready tickets — Jira issues or GitHub issues.

ソースを見る
リポジトリの原文

見出し、例、コード、表、リンク、参照画像を含む原文を表示しています。

Create Stories: PRD → Ticket Backlog

Overview

Turn a finished PRD into a backlog of small, well-formed tickets. Each Implementation Phase in the PRD becomes a group of tickets; each User Story becomes one or more tickets with explicit acceptance criteria.

This skill is platform-agnostic by design — the `--platform` flag decides whether the backlog lands in Jira or in GitHub Issues. Everything before that flag (reading the PRD, decomposing it, writing acceptance criteria) is identical.

Arguments

ArgumentRequiredMeaning
<prd-path>yesPath to the PRD produced by plan-create-prd
--platformyesjira or github — where the tickets are created
--projectjira onlyJira project key (e.g. HELP)
--epicjira onlyJira epic key to parent the tickets under (e.g. HELP-1)
--milestonegithub onlyoptional GitHub milestone to attach issues to

If --platform is missing, stop and ask — do not guess.

Workflow

1. Read and decompose the PRD

  • Read <prd-path> in full.
  • Walk the Implementation Phases section. Each phase is a ticket group.
  • Walk the User Stories section. Each story maps to one ticket (split if it

hides more than ~a day of work).

  • For every ticket, draft:
  • Title — imperative, specific (Add token refresh endpoint, not Auth).
  • Description — what and why, linked back to the PRD phase.
  • Acceptance criteria — a checklist a reviewer can verify.
  • Phase label — which PRD phase it belongs to.
  • Keep tickets small. A ticket that can't be described in one screen is two

tickets.

2. Confirm the plan before creating anything

Print the proposed ticket list (titles + phase grouping) and the target platform. This is the checkpoint — creating real tickets is not reversible in one click.

3. Create the tickets — branch on --platform

`--platform jira`:

  • Use the Atlassian MCP server.
  • Create each ticket under --epic in --project.
  • Map: PRD phase → a label or the epic; acceptance criteria → the description.
  • Capture each created issue key.

`--platform github`:

  • Use the gh CLI: gh issue create --title "..." --body "..." [--label phase-N] [--milestone "..."].
  • Put acceptance criteria in the issue body as a markdown checklist.
  • Apply a phase-N label per PRD phase (create the label if missing with

gh label create).

  • Capture each created issue number/URL.

4. Report

  • A table: ticket title → phase → created key/number/URL.
  • The PRD path the backlog was generated from.
  • Next step: each phase is now ready to run as a PIV loop.

Quality Checks

  • ✅ Every ticket traces back to a PRD phase or user story
  • ✅ Every ticket has verifiable acceptance criteria
  • ✅ Tickets are small (≤ ~1 day of work)
  • ✅ The correct platform was used and every create succeeded
  • ✅ Phase grouping is preserved (labels/epic) so the backlog stays navigable

Notes

  • Greenfield vs brownfield changes the PRD's scope (MVP vs next epic), not

this skill — plan-create-stories runs the same either way.

  • Never create tickets without the step-2 confirmation.
  • If a phase is too vague to decompose, stop and flag it — that's a PRD gap,

not a ticket-writing problem.

同じリポジトリから

関連する Skills

すべての Skills
coleam00
コミュニティ

hooks-create

Author a working Claude Code hook from a plain-English description of what it should guarantee or do. You describe the behavior ("never let the agent edit my migrations", "don't stop until the tests pass", "log every command"); this skill picks the right lifecycle event, writes the hook script, and wires it into .claude/settings.json. Use when you want a deterministic guarantee or automation in your AI Layer and don't want to write the hook by hand. The meta-tool for the hooks primitive.

導入数
1
GitHub Stars
495
更新日
9月9日
coleam00
コミュニティ

piv-review-pr

Full pull-request review — fetch the PR, run the project's validation, review the diff with fresh eyes (dispatching the code-reviewer agent), categorize issues by severity, post the review to GitHub (approve / request-changes / comment), and save a report. The agentic gate that runs on an open PR before a human approves. Use after piv-create-pr.

導入数
1
GitHub Stars
495
更新日
9月9日
coleam00
コミュニティ

piv-run-full-loop

Autonomously develops a complete feature from priming through planning, execution, and commit by chaining the four core PIV-loop skills. Use when you want a full hands-off feature build from a single description.

導入数
1
GitHub Stars
495
更新日
9月9日
coleam00
コミュニティ

piv-slice-epic

Slice an epic (with its architecture decisions) into PIV-sized tickets with a dependency graph, then create them in your tracker (Jira via the Atlassian MCP, or GitHub/Linear/local). Accepts the epic and its architecture as one doc or as an epic plus a separate linked architecture page. Turns a large strategic doc into the discrete units of work that the PIV loop consumes.

導入数
1
GitHub Stars
495
更新日
9月9日