kata-test-plan-design

Generate a feature test plan mapping acceptance criteria to unit, integration, and end-to-end levels.

Updated Sep 3, 2025
One-click install
npx skills add https://github.com/guardiatechnology/design-system --skill kata-test-plan-design
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: kata-test-plan-design
Source: https://github.com/guardiatechnology/design-system/tree/main/.claude/skills/kata-test-plan-design
Command: npx skills add https://github.com/guardiatechnology/design-system --skill kata-test-plan-design

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

It prevents under-testing and misaligned effort by translating acceptance criteria into the right mix of Unit, Integration, and E2E coverage while explicitly documenting risks, gaps, and targets.

Core Features & Use Cases

  • Maps acceptance criteria to test levels using clear behavioral types and an adjacent-level strategy to capture both domain correctness and real boundary behavior.
  • Expands each AC with mandatory scenario coverage, including known errors, edge cases, idempotency/replay behavior, and dependency failure modes.
  • Defines measurable coverage expectations per tier (minimum coverage and mutation score), plus concrete tooling/fixtures/resources and a structured output artifact for the workflow.

Example use case: when building a refund flow (POST endpoint with idempotency), the skill produces a plan that covers domain rules, repository/integration behavior, and the cross-service/data persistence path—while calling out what E2E UI will be intentionally deferred.

Quick Start

Ask an AI to generate a Gate-ready test plan for your feature’s acceptance criteria and persist it to .ahrena/issues/{n}/02b-test-plan.md.

Frequently Asked Questions about kata-test-plan-design

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

FAQPage Schema
How do I map acceptance criteria to unit, integration, and e2e test levels?▼

To map acceptance criteria to test levels, you distribute behavioral rules across unit tests, persistence and external contracts across integration tests, and critical user journeys across e2e tests. This ensures domain correctness and real boundary behavior are both captured.

What is the best way to design a test plan that covers idempotency and dependency failure scenarios?▼

Designing a test plan for idempotency and dependency failures involves expanding each acceptance criteria with mandatory negative, edge, and replay behavior scenarios. This approach explicitly documents risks and coverage gaps to prevent misaligned testing effort.

How do you define coverage targets and mutation score expectations for a feature test plan?▼

Defining coverage targets requires setting tier-based measurable expectations for minimum coverage and mutation scores. This structures your testing strategy by prioritizing critical paths and domain rules while intentionally deferring lower-risk areas like e2e UI flows.

When do I need to generate a separate test plan artifact for my feature workflow?▼

You need a separate test plan artifact when translating feature acceptance criteria into actionable testing strategies. Generating a structured markdown file captures the AC to level mapping, required tools, fixtures, and containers needed for execution.

Can I use this test strategy approach for multi-endpoint flows and external contract testing?▼

Yes, this test strategy approach applies to multi-endpoint flows and external contract testing by mapping integration tests to repository behavior and cross-service data persistence paths. It ensures complex interactions are validated without over-testing UI layers.

Why does my test coverage miss critical edge cases and known errors in business rules?▼

Test coverage misses critical edge cases when acceptance criteria are not expanded with mandatory scenario coverage. Explicitly adding known errors, idempotency, and dependency failure modes to your test plan prevents under-testing domain rules and boundary behavior.