xiaohongshu
xiaohongshu
atdd
Guide teams through Acceptance Test-Driven Development workflow. Use when: defining acceptance criteria, running specification workshops, writing user stories with acceptance tests, PO sign-off. Keywords: ATDD, acceptance test, acceptance criteria, user story, product owner, specification worksho...
Full skill instructions
Language: English | 繁體中文
Version: 1.0.0 Last Updated: 2026-01-19 Applicability: Claude Code Skills
This skill guides teams through the Acceptance Test-Driven Development workflow, helping them:
┌─────────────────────────────────────────────────────────────────┐
│ 🤝 SPECIFICATION WORKSHOP Phase │
│ □ Product Owner presents user story │
│ □ Team asks clarifying questions │
│ □ Acceptance criteria defined together │
│ □ Concrete examples written for each AC │
│ □ Edge cases and error scenarios discussed │
│ □ Out of scope explicitly documented │
├─────────────────────────────────────────────────────────────────┤
│ 🧪 DISTILLATION Phase │
│ □ Examples converted to executable tests │
│ □ Ambiguity removed from tests │
│ □ Tests in executable format (Gherkin, FitNesse, etc.) │
│ □ Product Owner signs off on tests │
├─────────────────────────────────────────────────────────────────┤
│ 💻 DEVELOPMENT Phase │
│ □ Acceptance tests initially fail (RED) │
│ □ BDD used for feature tests, TDD for unit tests │
│ □ Incremental progress toward passing ATs │
│ □ All acceptance tests pass (GREEN) │
│ □ Code refactored and clean │
├─────────────────────────────────────────────────────────────────┤
│ 🎬 DEMO Phase │
│ □ All acceptance tests passing │
│ □ Demo environment prepared │
│ □ Key stakeholders present │
│ □ Product Owner validates functionality │
│ □ Story accepted or criteria refined │
└─────────────────────────────────────────────────────────────────┘
| Element | Format | Example |
|---|---|---|
| User Story | As a / I want / So that | As a customer, I want to reset my password, so that I can regain access |
| AC Format | Given / When / Then | Given I'm on the login page, When I click "Forgot Password", Then I should see a reset form |
| Out of Scope | Bullet list | - SMS reset, - Admin reset capability |
| Technical Notes | Bullet list | - Token expires in 24 hours |
| Principle | Description | Check |
|---|---|---|
| Independent | Can be developed independently | No blocking dependencies |
| Negotiable | Details can be discussed | Not a contract |
| Valuable | Delivers business value | PO can explain the "why" |
| Estimable | Can be estimated | Team understands scope |
| Small | Fits in one sprint | < 1 week of work |
| Testable | Can be verified | Clear acceptance criteria |
When conducting a specification workshop:
Story Presentation (5 min)
User Story: [Title]
As a [role]
I want [feature]
So that [benefit]
Business Value: [Why this matters]
Clarifying Questions (10 min)
AC Definition (20 min)
### AC-1: [Criterion name]
**Given** [precondition]
**When** [action]
**Then** [expected result]
Out of Scope (10 min)
Technical Notes (5 min)
When converting AC to executable tests:
Review Each AC
Choose Test Format
| Format | Best For |
|---|---|
| Gherkin | Behavior-focused, business-readable |
| FitNesse | Data-driven, wiki tables |
| Robot Framework | Complex workflows |
| Code (xUnit) | Technical teams |
Write Executable Tests
# For AC-1: Password reset request
Scenario: Request password reset
Given I am on the login page
And I have a registered account
When I click "Forgot Password"
And I enter my email address
Then I should see "Reset link sent"
And I should receive an email within 5 minutes
Get PO Sign-off
When preparing for demo:
Pre-Demo Checklist
□ All acceptance tests passing
□ Demo environment ready
□ Test data prepared
□ Stakeholders notified
Demo Structure (15-30 min)
Possible Outcomes
## User Story: [Title]
**As a** [role]
**I want** [feature]
**So that** [benefit]
## Acceptance Criteria
### AC-1: [Happy path]
**Given** [precondition]
**When** [action]
**Then** [expected result]
### AC-2: [Error scenario]
**Given** [precondition]
**When** [invalid action]
**Then** [error handling]
### AC-3: [Edge case]
**Given** [edge condition]
**When** [action]
**Then** [appropriate result]
## Out of Scope
- [Feature 1 not included]
- [Feature 2 deferred to future]
## Technical Notes
- [Implementation constraint]
- [Dependency information]
- [Performance requirement]
## Questions / Assumptions
- [Open question 1]
- [Assumption 1]
ATDD Level (Business Acceptance)
│
│ User Story + Acceptance Criteria
│ PO Sign-off
│
▼
BDD Level (Behavior Specification)
│
│ Feature Files (Gherkin)
│ Three Amigos collaboration
│
▼
TDD Level (Implementation)
│
│ Unit Tests
│ Red → Green → Refactor
│
▼
Verification (Demo)
│
└──▶ PO Acceptance
# Link ATDD to SDD Spec
## User Story: US-123
**Spec Reference**: SPEC-001
### AC-1: Implements SPEC-001 Section 3.1
**Given** [from spec requirements]
**When** [action per spec]
**Then** [expected per spec]
This skill supports project-specific configuration.
CONTRIBUTING.md for "Disabled Skills" sectionCONTRIBUTING.md for "ATDD Standards" sectionIf no configuration found:
Ask: "This project hasn't configured ATDD preferences. Which acceptance test format do you prefer?"
After selection, suggest documenting in CONTRIBUTING.md:
## ATDD Standards
### Acceptance Test Format
- Gherkin (Cucumber.js)
### User Story Template
- INVEST criteria required
- Given-When-Then format for AC
### Workflow
- Specification workshop required for all stories
- PO sign-off before development
- Demo for each completed story
For complete standards, see:
For related standards:
| Symptom | Likely Problem | Quick Fix |
|---|---|---|
| Features marked done but PO rejects | AC not validated with PO | Mandatory PO sign-off |
| Long dev with no progress | AC too large or vague | Break into smaller criteria |
| Acceptance tests always pass first time | Tests written after implementation | Tests before dev |
| Endless scope discussions | No "out of scope" definition | Explicit out-of-scope |
| AC can't be automated | QA/Dev not involved in AC definition | Technical perspective in workshop |
| Activity | Product Owner | Developer | QA/Tester |
|---|---|---|---|
| Define user story | R/A | C | C |
| Specification workshop | R | C | C |
| Define acceptance criteria | A | R | R |
| Write executable tests | C | R | R/A |
| Implement feature | C | R/A | C |
| Execute acceptance tests | I | R | R/A |
| Accept/reject feature | R/A | I | I |
Legend: R = Responsible, A = Accountable, C = Consulted, I = Informed
| Version | Date | Changes |
|---|---|---|
| 1.0.0 | 2026-01-19 | Initial release |
This skill is released under CC BY 4.0.
Source: universal-dev-standards
xiaohongshu
technical spec
product ux expert
database patterns
Conduct multi-agent task orchestration and workflow coordination.
Initialize project with Conductor artifacts (product definition,
Expert in web animations, transitions, and motion design using Framer Motion and CSS
Creates Mermaid and ASCII diagrams for flowcharts, architecture, ERDs, state machines, mindmaps, and more. Use when user mentions diagram, flowchart, mermaid, ASCII diagram, text diagram, terminal diagram, visualize, C4, mindmap, architecture diagram, sequence diagram, ERD, or needs visual docume...
PostgreSQL bindings for H3 hexagonal grid system. Use when working with H3 cells in Postgres, including spatial indexing, geometry/geography integration, and raster analysis.
Context-Driven Development skill for projects using Conductor. Use this skill when you detect a `conductor/` directory in the project, when working on tasks defined in a `plan.md` file, or when the user asks about tracks, specs, or plans. Automatically applies TDD workflow, tracks task completion...
Display project status, active tracks, and next actions
Official Stakpak application containerization standard operating procedure, a step-by-step guidline to properly dockerize applications. This is a rule book curated by the Stakpak Team.
Generate, edit, and beat-sync AI video with leading models in one workspace.
The world's fastest calendar for remote work
Transform Your Design with AI Designer by ImgCreator.ai
Revolutionizing Video Production with AI-Powered Creativity
Extend an image past the frame and let AI fill the new aspect ratio.
Discover your celebrity doppelgänger with StarByFace!
ChainClarity explains 700+ crypto whitepapers in plain English, with layered summaries, comparisons, research tools, alerts, and a $4.99 Pro plan.
Opus.ai: Revolutionize Your Web Experience