Agent-Skills.md

Agent Skills: Acceptance Criteria

|

UncategorizedID: yellinzero/aico/aico-pm-acceptance-criteria

Repository

yellinzero/aico
yellinzeroLicense: Apache-2.0
1

Install this agent skill to your local

pnpm dlx add-skill https://github.com/yellinzero/aico/tree/HEAD/.codex/skills/aico-pm-acceptance-criteria

Skill Files

Browse the full folder contents for aico-pm-acceptance-criteria.

Download Skill

Loading file tree…

.codex/skills/aico-pm-acceptance-criteria/SKILL.md

Skill Metadata

Name
aico-pm-acceptance-criteria
Description
|

Acceptance Criteria

⚠️ CRITICAL RULES - READ FIRST

  1. READ STORY FIRST: Always read the story file from docs/reference/pm/stories/ before writing criteria
  2. USE GIVEN/WHEN/THEN: All criteria must follow this format
  3. UPDATE STORY FILE: Add criteria to existing story file, don't create new files

Language Configuration

Before generating any content, check aico.json in project root for language field to determine the output language. If not set, default to English.

Process

  1. Review story/feature: Understand what needs to be done
  2. Identify success scenarios: Happy paths first
  3. Write Given/When/Then: For each scenario
  4. Add edge cases: Boundary conditions and errors
  5. Verify testability: Each criterion must be independently verifiable

Acceptance Criteria Template

### Acceptance Criteria for [Story/Feature]

#### Scenario 1: [Scenario Name]

- **Given** [precondition/context]
- **When** [action/trigger]
- **Then** [expected outcome]

#### Scenario 2: [Scenario Name]

- **Given** [precondition/context]
- **When** [action/trigger]
- **Then** [expected outcome]

#### Edge Cases

- **Given** [edge case condition]
- **When** [action]
- **Then** [expected behavior]

Criteria Categories

| Category | Examples | | -------------- | --------------------------- | | Functional | Feature works as specified | | Validation | Input validation rules | | Error handling | Error messages and recovery | | Performance | Response time expectations | | Accessibility | A11y requirements |

Quality Checklist

  • [ ] Each criterion is independently testable
  • [ ] No ambiguous language ("should", "might", "could")
  • [ ] Edge cases are covered
  • [ ] Error states are defined
  • [ ] Performance expectations stated (if relevant)

Key Rules

  • ALWAYS use Given/When/Then structure
  • MUST make each criterion independently testable
  • ALWAYS include edge cases and error scenarios
  • NEVER use vague language - be specific

Common Mistakes

  • ❌ Vague criteria ("works correctly") → ✅ Specific conditions
  • ❌ Missing edge cases → ✅ Include boundary conditions
  • ❌ Implementation details → ✅ Focus on observable behavior