Skip to content

tibursocampos/agent-dev-toolkit / core/skills/refine-story

refine-story

Verified

Refine 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.

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` |
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: 198kUpdated Claude CodeCodexVerifiedInstall
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: 194kUpdated Claude CodeCodexVerifiedInstall
ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report.Stars: 194kUpdated Claude CodeCodexVerifiedInstall
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: 194kUpdated Claude CodeCodexVerifiedInstall