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/mode-isolation.md
View on GitHub# Mode isolation (feature | tech | split)
**REQ-004 / CA2 / CT2.** Load **exactly one** mode playbook after Step 0.5. Never preload the other two. Do **not** invent a fourth product mode or a parallel requirement-challenge skill; challenge work stays in `requirement-review`.
## Isolation matrix (observável)
| Concern | `feature` | `tech` | `split` |
|---------|-----------|--------|---------|
| Playbook file | `references/feature.md` **only** | `references/tech.md` **only** | `references/split.md` **only** |
| Default item types | User Story \| Bug | Technical Story | Any one type (ask once) |
| Type template load | **one** of `user-story.md` \| `bug.md` | `technical-story.md` **only** | **one** matching type |
| Persona / JTBD | Allowed for User Story | **Forbidden** unless operator switches mode to `feature` | Only if User Story + Who/Job helps |
| Primary outcome | Product-facing refine + scorecard | Technical problem→solution refine | Steps ready for `/split-story-checklist` |
| Chat prompt prefix | `[Refine · feature]` | `[Refine · tech]` | `[Refine · split]` |
| May load other mode playbooks? | **No** | **No** | **No** — do not run full feature/tech playbooks |
## Hard stops (leak prevention)
1. Mode unset / invalid → **STOP**; ask Trigger prompt; load **zero** playbooks.
2. Operator asks for rules from another mode mid-session → either **switch mode explicitly** (re-resolve 0.5, unload prior playbook rules) or answer with a one-line pointer and stay in current mode — never merge playbooks.
3. `split` reshapes steps only; it does **not** silently become a product or tech full refine.
4. Envelope `mode` field **must** match the active playbook (see `interaction-envelope.md`).
## CT2 checklist (manual — ≥2 modes)
Pick any two of `{feature, tech, split}` and verify:
- [ ] Each invocation loads **only** its playbook path
- [ ] Prompt prefix / envelope `mode` differ between the two
- [ ] Type-template set does not overlap incorrectly (e.g. tech never loads `user-story.md`)
- [ ] No second requirement-challenge skill folder and no `feature-refinement.md` created
## Pointers
| Topic | Path |
|-------|------|
| Per-mode steps | `references/feature.md` \| `tech.md` \| `split.md` |
| Interaction envelope | `references/interaction-envelope.md` |
| READY dual-plane | `readiness-severity.md` (consume; do not rewrite taxonomy) |
| Exclusions | `references/exclusions.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 |