abd-acceptance-criteria

Generate and validate WHEN/THEN/AND/BUT acceptance criteria for story-graph.json.

1|Updated Feb 26, 2026
One-click install
npx skills add https://github.com/agilebydesign/agilebydesign-skills --skill abd-acceptance-criteria
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: abd-acceptance-criteria
Source: https://github.com/agilebydesign/agilebydesign-skills/tree/main/skills/abd-acceptance-criteria
Command: npx skills add https://github.com/agilebydesign/agilebydesign-skills --skill abd-acceptance-criteria

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Enables product teams to articulate and validate exploration-phase acceptance criteria for story-graph.json using WHEN/THEN/AND/BUT language, anchored to domain terms and atomic AC constructs.

Core Features & Use Cases

  • Provides templates for acceptance criteria in Markdown and plain text.
  • Includes scanners to enforce behavioral AC structure, domain-term emphasis, and channel-specific language.
  • Supports keep-ac-consistent rules across connected domains and story sizing for coverage.

Quick Start

Run the included templates and scanners to generate and validate exploration-phase acceptance criteria for your story-graph.json.

Frequently Asked Questions about abd-acceptance-criteria

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

FAQPage Schema
How do I write acceptance criteria for a story graph using WHEN/THEN format?

To write acceptance criteria for a story graph, use provided Markdown templates to craft WHEN/THEN/AND/BUT statements anchored to domain terms. This ensures consistent structure and machine-checkable quality across epic, sub-epic, and story levels.

What is the best way to validate behavioral acceptance criteria in a project?

The best way to validate behavioral acceptance criteria is running Python scanners that enforce behavioral AC structure, domain-term emphasis, and channel-specific language. Scanners check atomic segments within your story-graph.json to ensure quality.

Can I use templates to keep acceptance criteria consistent across connected domains?

Yes, you can use keep-ac-consistent rules and templates to maintain acceptance criteria consistency across connected domains. They support story sizing for coverage and apply a unified voice across all project levels.

How do domain terms improve machine-checkable acceptance criteria?

Domain terms improve machine-checkable acceptance criteria by anchoring WHEN/THEN/AND/BUT statements to specific project vocabulary. Scanners use these domain terms to validate atomic segments and enforce channel-specific language within story-graph.json.

What are the limitations of using templates for exploration phase acceptance criteria?

Templates for exploration phase acceptance criteria require strict adherence to atomic segment constructs and domain terms to function properly. Without consistent voice and structure across epic, sub-epic, and story levels, scanner validation may fail.

Do I need Python to run scanners for acceptance criteria validation?

Yes, you need Python to execute the included scanners that validate acceptance criteria structure and domain-term usage. Scanners integrate with project rules to automatically check your story-graph.json file quality.