Skip to content

Basinfy/Basinfy-SaaS-Studio / .claude/skills/saas-create-stories

saas-create-stories

Verified

Break an epic into implementable stories with Gherkin acceptance criteria and ADR refs.

FileKindSize
SKILL.mdskill md16.7 KB
references/qa-lead-gate.mdmarkdown3.1 KB

references/qa-lead-gate.md

View on GitHub
# Phase 5: QA lead review (QL-STORY-READY)

Read only when the `review_gate` line says `skill-gates=run` (`review_mode: full`).
Run it after the stories are drafted and before the Phase 6 write ask.

**An existing QA plan first.** Look for the newest `production/qa/saas-qa-plan-*.md`. If
its Automated Tests Required section holds specs for stories in this epic (match by
title or slug), they can stand in for the agent's specs. Where the two differ, ask:
"Which test specs should these stories carry?" Options: The QA plan's / The QA
lead's / None yet. "None yet" writes
`*Test cases not yet defined — run /saas-qa-plan to generate them.*` This never adds a
second hand-off.

**Hand the review to the `qa-lead` agent, once,** with gate **QL-STORY-READY**. The
agent reads its own gate file; do not read it here. One report carries both the
verdicts and the specs: never hand it a second job for the specs.

Brief:
- **Objective:** judge each drafted story's acceptance criteria for testability, and
  write test specs for the ones that pass.
- **Give it:** the full story list inline (no story file exists yet, so the stories
  stand in for the gate's paths), each with its acceptance criteria, type, and
  TR-IDs with their requirement text from `tr-registry.yaml`; and the epic PRD's
  acceptance criteria for reference.
- **Return:** per story, ADEQUATE, GAPS, INADEQUATE, or NOT ASSESSED naming a
  missing input. For each ADEQUATE story, its spec block in the formats below: one
  Given/When/Then per criterion for Logic and Integration, manual steps for
  Visual/Feel and UI.
- **Boundaries:** it writes no file.

Act on each story's verdict:

- **ADEQUATE:** keep its specs.
- **GAPS:** ask: "How do you want to handle the flagged criteria?" Options: Revise
  them / Accept and go on / Discuss further. Revise nothing before the answer. On
  Revise: draft the new criteria, show them, and send just those stories back to
  the agent in one follow-up brief. On Accept: the criteria stay, and the story's
  QA Test Cases read `*Test cases not yet defined — run /saas-qa-plan to generate them.*`
- **INADEQUATE:** the story is not written as it stands. Revise its criteria with
  the user (draft, show, confirm), then ask the agent for its specs. If the user
  will not revise it, drop it from this run and name it as dropped in the Phase 6
  list.
- **NOT ASSESSED:** not an ADEQUATE. Name the missing input, then supply it and ask
  again, or write the story without specs (the `/saas-qa-plan` line) and mark it
  `QL-STORY-READY: NOT ASSESSED — [input]` in the Phase 6 list.

A story carries specs only once it is ADEQUATE: untestable criteria cannot be built
correctly. The specs go in the story's `## QA Test Cases`; the user builds
against them and does not invent new ones.

Logic and Integration:

```
Test: [criterion text]
  Given: [precondition]
  When: [action]
  Then: [expected result]
  Edge cases: [boundary values or failure states]
```

Visual/Feel and UI:

```
Manual check: [criterion text]
  Setup: [how to reach the state]
  Verify: [what to look for]
  Pass condition: [an unambiguous pass]
```
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