atdd-assistant

Guide Acceptance Test-Driven Development workflows for defining and validating user stories.

70|13|Updated Dec 24, 2025
One-click install
npx skills add https://github.com/AsiaOstrich/universal-dev-standards --skill atdd-assistant
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: atdd-assistant
Source: https://github.com/AsiaOstrich/universal-dev-standards/tree/main/.gemini/skills/atdd-assistant
Command: npx skills add https://github.com/AsiaOstrich/universal-dev-standards --skill atdd-assistant

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill streamlines the Acceptance Test-Driven Development (ATDD) process, ensuring clear requirements, collaborative development, and verifiable software.

Core Features & Use Cases

  • Guided Workshops: Facilitates specification workshops to define user stories and acceptance criteria.
  • Testable Criteria: Helps write clear, unambiguous acceptance criteria using the Given-When-Then format.
  • Workflow Integration: Guides teams through the entire ATDD cycle: Workshop, Distillation, Development, Demo, and Done.
  • Use Case: A development team uses this Skill to collaboratively define acceptance criteria for a new user login feature, ensuring all stakeholders agree on what "done" means before coding begins.

Quick Start

Use the atdd-assistant skill to start an interactive ATDD session.

Frequently Asked Questions about atdd-assistant

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I write acceptance criteria in Given-When-Then format for agile user stories?

To write acceptance criteria in Given-When-Then format for user stories, you define the initial context, the action taken, and the expected outcome. This Skill facilitates specification workshops to convert these criteria into executable tests, ensuring unambiguous requirements.

What is the best way to run a specification workshop for ATDD?

The best way to run a specification workshop for ATDD is to collaboratively define user stories and validate them against INVEST criteria. This Skill guides teams through the entire workflow, ensuring stakeholders agree on what 'done' means before coding begins.

How does ATDD workflow integrate with BDD and TDD practices?

ATDD workflow integrates with BDD and TDD practices by bridging collaborative requirement definitions with executable testing. This Skill guides the transition from specification workshops through test distillation and development, validating acceptance criteria throughout the agile cycle.

Can I use this to validate user stories against INVEST criteria before development?

Yes, you can validate user stories against INVEST criteria before development. This Skill provides dedicated templates for user stories and acceptance criteria, supporting the evaluation of stories to ensure they are actionable and verifiable.

What are the main stages of the Acceptance Test-Driven Development cycle?

The main stages of the Acceptance Test-Driven Development cycle are Workshop, Distillation, Development, Demo, and Done. This Skill guides teams sequentially through these stages to ensure collaborative development and verifiable software.