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.

references/persistence.md

View on GitHub
## Optional save: feature STORY (preferred)

```markdown
# STORY: US01 - [title]
...
```

Use `skills/_shared/templates/features/story/STORY.md`. Place under `features/NNN-slug/USnn/STORY.md`. Optional raw refine dump: `features/NNN-slug/USnn/REFINE/refine.md`.

**Q&A history (REQ-005):** when clarifications ran, also write `features/NNN-slug/USnn/REFINE/qa-history.md` (or `TSnn`) per `references/qa-history.md`. Point the interaction envelope `qa_history_ref` at that **portable** path.

Do **not** create `REFINE/` at repo root.

---

## Optional save: `docs/backlog/<slug>.md` (shortcut)

Prefix file with metadata:

```markdown
# Backlog: [title]

| Field | Value |
|-------|--------|
| **Type** | Bug \| User Story \| Technical Story |
| **Doc language** | content-language (infer from chat; do not hard-code locale) |
| **Refined** | YYYY-MM-DD |
| **Repository** | [folder or remote name] |
| **Preferred promote** | features/NNN-slug/USnn/STORY.md |
| **Q&A history** | docs/backlog/<slug>-qa-history.md |

[generated body]
```

Pair with `docs/backlog/<slug>-qa-history.md` when clarifications exist (same rules as `qa-history.md`).

Do not create `docs/backlog/` in **this toolkit repo** during toolkit porting - only in consumer repos at runtime.

**Paths in metadata / envelopes / handoffs:** portable only (`STORAGE.md` § Portable path / REQ-006 / RNF-002).

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