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 |
reference.md
View on GitHub# refine-story — reference index
Extended detail for `skills/refine-story/SKILL.md`. **Do not Read this file for procedural detail** when a section file exists — load `references/<section>.md` per Process step or Reference routing.
Contract: `SKILL-REFERENCE-RETRIEVAL.md` (`SR-LAZY-REFERENCE`). Selective retrieval: `SELECTIVE-RETRIEVAL.md` rule `SR-NO-FULL-DUMP` — never dump entire `memory-bank/` or paste a full PRD into refine chat/handoffs.
**Modes:** load **one** playbook — `references/feature.md` | `references/tech.md` | `references/split.md` — never the other modes by default. Isolation matrix: `references/mode-isolation.md` (REQ-004). Envelopes + Q&A: `interaction-envelope.md` / `qa-history.md` (REQ-005). READY dual-plane: consume `readiness-severity.md` (REQ-006) — do not rewrite taxonomy or PS1 asserts.
Scorecard includes **Story scope**, **Product depth**, and AC budget happy/rule/failure (see `references/scorecard-rubric.md`); contracts: `skills/_shared/backlog-item-types/story-sizing.md`, `gherkin-budget.md`, `invest-and-story-quality.md`.
| Section | Path |
|---------|------|
| Command playbook (step discovery) | `references/command.md` |
| Mode: feature (User Story / Bug) | `references/feature.md` |
| Feature research (orchestrated + mode=feature) | `references/feature-research.md` |
| Mode: tech (Technical Story) | `references/tech.md` |
| Mode: split (checklist-ready steps) | `references/split.md` |
| Mode isolation (REQ-004) | `references/mode-isolation.md` |
| Interaction envelope (REQ-005) | `references/interaction-envelope.md` |
| Q&A history (REQ-005) | `references/qa-history.md` |
| Boundary vs O1 / sdd-spec | `references/boundary.md` |
| Clarification READY / NEEDS_CLARIFICATION | `readiness-severity.md` + `clarify-depth.md` + `references/boundary.md` § Clarification STOP |
| Requirement review (step 4a, sibling skill) | `requirement-review/SKILL.md` |
| Scorecard rubric | `references/scorecard-rubric.md` |
| Scorecard template | `references/scorecard-template.md` |
| Guardrails | `references/guardrails.md` |
| Persistence | `references/persistence.md` |
| Split-story handoff | `references/split-handoff.md` |
| Product persona / JTBD → `persona-context.md` | `references/product-persona.md` |
| Exclusions | `references/exclusions.md` |
| Finding format (id, severity, evidence, recommendation) | `references/finding-format.md` |
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 |