tibursocampos/agent-dev-toolkit / core/skills/refine-story
refine-story
VerifiedRefine a Bug, User Story, or Technical Story into structured markdown with BDD acceptance and a quality scorecard. Use when refining backlog or invoking /refine-story.
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 14.1 KB |
| reference.md | markdown | 2.4 KB |
| references/boundary.md | markdown | 3.7 KB |
| references/command.md | markdown | 3.5 KB |
| references/exclusions.md | markdown | 1.1 KB |
| references/feature-research.md | markdown | 4.2 KB |
| references/feature.md | markdown | 4.2 KB |
| references/finding-format.md | markdown | 2.7 KB |
| references/guardrails.md | markdown | 2.2 KB |
| references/interaction-envelope.md | markdown | 3.4 KB |
| references/mode-isolation.md | markdown | 2.4 KB |
| references/persistence.md | markdown | 1.3 KB |
| references/product-persona.md | markdown | 955 B |
| references/qa-history.md | markdown | 4.1 KB |
| references/scorecard-rubric.md | markdown | 3.5 KB |
| references/scorecard-template.md | markdown | 2.2 KB |
| references/split-handoff.md | markdown | 797 B |
| references/split.md | markdown | 3.7 KB |
| references/tech.md | markdown | 4.4 KB |
references/scorecard-template.md
View on GitHub## Scorecard template
### Scorecard output format
```markdown
---
## Quality scorecard
| Criterion | Score | Max | Note |
|-----------|-------|-----|------|
| Objective | [x] | 12 | [specific note] |
| Acceptance criteria (BDD) | [x] | 20 | [happy / rule / failure budget status] |
| Product depth | [x] | 10 | [Valuable + AC budget + Who/Job/Outcome; Evidence omit OK] |
| Story scope | [x] | 10 | [specific note] |
| Implementation steps | [x] | 13 | [specific note] |
| No vague language | [x] | 5 | [specific note] |
| [type-specific 1] | [x] | [max] | [specific note] |
| [type-specific 2] | [x] | [max] | [specific note] |
| [type-specific 3] | [x] | [max] | [specific note] |
| [type-specific 4] | [x] | [max] | [specific note] |
### Total: [sum] / 100
### Strengths
- [specific]
### Improvements
- **[Criterion]**: [what is missing and how to fix]
---
```
Chat display (feature, tech, split): render the total, every criterion row, strengths, and improvements in chat right after the markdown. The full scorecard is chat-only and is never persisted; only the short summary below is. Rules: notes must be specific (not "OK"); improvements name exact gaps; incomplete user input reflected honestly.
**AC budget:** Acceptance criteria notes must state whether **happy**, **rule/edge**, and **failure** slots are present with observable Then (`gherkin-budget.md`). Cap Product depth at **6** if any slot is missing.
**Persona / JTBD:** Optional for User Story (`persona-context.md`). Scorecard must **not** penalize absence of persona, JTBD, Who / Job / Outcome, or Product intent on **Bug** or **Technical Story** (use `n/a`). On User Story, missing persona is not a defect when Objective states beneficiary and value — but Who/Job/Outcome (or equivalent) is required for full Product depth.
**Evidence:** Do **not** force inventing Evidence (`product-evidence-lite.md` — omit > fabricate).
When persisting as `STORY.md`, copy a short scorecard summary into the template `Scorecard (resumo)` table. Map **Product depth** from the Product depth criterion (/10 → 1–5) per `scorecard-rubric.md`. Map other rows from overall /100 bands when a dedicated criterion score is unavailable: 80+ = 5, 60–79 = 4, 40–59 = 3, else ≤2.
---
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| slack-gif-creatoranthropics/skillsKnowledge and utilities for creating animated GIFs optimized for Slack. Provides constraints, validation tools, and animation concepts. Use when users request animated GIFs for Slack like "make me a GIF of X doing Y for Slack." | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |
| ponytailDietrichGebert/ponytailLazy senior dev mode for any coding task: the smallest change that fully solves it, and a reply a busy human understands in one read. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailList every `shortcut:` comment (and older `ponytail:` ones) as a debt ledger. One-shot report, changes nothing. Use for "ponytail debt", "what did ponytail defer", "list the shortcuts", /ponytail-debt. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |