Skip to content

feat(perps): add write-perps-ticket product-authoring skill#58

Merged
abretonc7s merged 2 commits into
mainfrom
perps/write-perps-ticket-skill
Jun 29, 2026
Merged

feat(perps): add write-perps-ticket product-authoring skill#58
abretonc7s merged 2 commits into
mainfrom
perps/write-perps-ticket-skill

Conversation

@abretonc7s

Copy link
Copy Markdown
Contributor

What

Adds write-perps-ticket — the product (first) pass that pairs with breakdown-perps-tickets (#57, the engineering pass). It helps a PM (or a Claude acting for one) turn a raw observation/idea/goal into one clean, complete ticket that states intent and expected outcome, then stops before implementation.

Splits the two jobs the team actually has (per the product discussion): the PM describes what's broken / expected with no implementation, and engineering does the technical split + layer routing as a second pass.

Modes

Typed, each with its own tight format:

  • Bug — what's broken + testable expected + repro + surface + pre-conditions + severity
  • EPIC — user-facing outcome + feature-level acceptance + scope (tasks deferred to engineering)
  • Initiative — why + measurable success metric + scope boundary + candidate child EPICs

Why these choices

  • Intent, not implementation. Product tickets state testable outcomes — no file paths, component names, or layer routing. Prescribing implementation boxes engineering in and goes stale when code moves; routing needs codebase access and belongs to the breakdown pass.
  • Surfacing section (severity, plain-words area label, correct type) so reported bugs get triaged instead of lost in the backlog — a direct pain point.
  • Number semantics, not decimals. Expected values described semantically ("shows USD value") since perps precision is range-adaptive.
  • Clean handoff. Output of this skill = input to breakdown-perps-tickets. Both reuse domains/perps/knowledge/*.

Relation to #57

Complementary, not dependent. #57 = engineer split/route; this = PM authoring. Merge order doesn't matter.

The PM-side first pass that pairs with breakdown-perps-tickets:
authors one clean bug/EPIC/initiative ticket stating intent and
expected outcome, with no implementation or layer routing.

- Typed modes (bug | epic | initiative), each with its own tight format
- Intent-not-implementation principle: testable outcomes, no file paths,
  no repo/component routing (that is the engineer breakdown pass)
- Surfacing section (severity, area label, correct type) so reported
  bugs get triaged instead of lost in the backlog
- Hands off to breakdown-perps-tickets; reuses domains/perps/knowledge
@abretonc7s abretonc7s enabled auto-merge (squash) June 29, 2026 15:55
@abretonc7s abretonc7s merged commit c7deeea into main Jun 29, 2026
27 checks passed
@abretonc7s abretonc7s deleted the perps/write-perps-ticket-skill branch June 29, 2026 15:59
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