# Af Writing Scenarios

> Write BDD Markdown scenario specifications with Preconditions, Steps, and Expected outcomes. Use when creating scenarios for a mini-PRD, classifying test types (E2E, Integration, Component, Unit), or structuring acceptance criteria.

- Skill: `majiayu000/af-writing-scenarios` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds add majiayu000/af-writing-scenarios`
- Raw SKILL.md: https://api.skillmd.com/api/skills/majiayu000/af-writing-scenarios/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Product & Planning
- Author: majiayu000 (https://skillmd.com/u/majiayu000)
- Updated: 2026-09-09
- Page: https://skillmd.com/skills/majiayu000/af-writing-scenarios

---


# Writing Scenarios

## What to read

**Scenario format (Preconditions/Steps/Expected structure):**
→ [bdd-guide.md#scenario-format](../../docs/guides/bdd-guide.md#scenario-format)

**Test type classification (E2E, Integration, Component, Unit):**
→ [bdd-guide.md#test-type-classification](../../docs/guides/bdd-guide.md#test-type-classification)

**Coverage requirements (happy path, errors, boundaries, validation):**
→ [bdd-guide.md#coverage-requirements](../../docs/guides/bdd-guide.md#coverage-requirements)

**Selector contracts for test IDs:**
→ [bdd-guide.md#selector-contracts](../../docs/guides/bdd-guide.md#selector-contracts)

**For comprehensive BDD rules, language rules, and pitfalls:**
→ [af-bdd-expertise/SKILL.md](../af-bdd-expertise/SKILL.md)