uat-test-design

Generates three-tier UAT and acceptance test item catalogs from repository analysis.

974|62|Updated Jul 24, 2025
One-click install
npx skills add https://github.com/classmethod/tsumiki --skill uat-test-design
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: uat-test-design
Source: https://github.com/classmethod/tsumiki/tree/main/skills/uat-test-design
Command: npx skills add https://github.com/classmethod/tsumiki --skill uat-test-design

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve?

Creating UAT and acceptance test item lists for large projects is slow and error-prone, especially when requirements documents are missing or scattered. This Skill explores any repository, inventories available information sources, and produces a structured L1/L2/L3 test item catalog without hardcoding project-specific paths.

Core Features & Use Cases

  • Automated Inventory & Classification: Runs an inventory script to measure documentation, E2E specs, unit tests, and screens, then classifies sources by category and trust level (forward requirements vs. reverse-generated docs).
  • Parallel Sub-Agent Extraction: Delegates extraction to sub-agents with strict reading budgets and pre-assigned ID ranges, so the parent agent never reads item bodies and large projects stay manageable.
  • Automation Coverage Judgment: Determines whether each L2 item is already covered by E2E or unit tests, separating auto-covered items into dedicated files and deriving a four-level manual execution hierarchy.
  • Use Case: Point the Skill at a repository before acceptance testing; it produces an index with count summaries, L1 business scenarios, per-feature-group L2 items, L3 non-functional checks, and a gaps report listing missing evidence.

Quick Start

Ask the AI to generate a UAT and acceptance test item list from this repository using the uat-test-design skill.

Frequently Asked Questions about uat-test-design

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

FAQPage Schema
How do I generate a UAT test item list from an existing repository?

Run the Skill against the repository root. It executes an inventory script to measure documentation, E2E specs, unit tests, and screens, confirms scope and environment with you, then delegates extraction to parallel sub-agents that write L1, L2, and L3 item files directly.

How does the Skill handle very large projects with thousands of files?

It enforces reading budgets of 10,000 lines and 30 files per sub-agent, splits oversized feature groups before delegation, and marks low-priority sources as lookup-only. The parent agent processes only metadata summaries, never item bodies.

Can it generate acceptance tests when no requirements documents exist?

Yes, but with a caveat. If only reverse-generated or implementation-derived sources exist, it continues and records a fallback note in the index stating that expected results are based on current implementation, leaving business validity judgment to the acceptance team.

Does it avoid duplicating tests already covered by E2E or unit tests?

Yes. Each L2 item gets a coverage judgment (E2E, Unit, E2E+Unit, or none) based on test-name grep matching. Items fully covered by E2E with no production-environment value are separated into covered files, while Unit-only items stay in the UAT body.

What output formats does the UAT test design produce?

It writes Markdown files into a date-stamped directory under docs/uat/: an index with count summaries and hierarchy-split tables, L1 scenarios, per-group L2 files, L3 non-functional items, and a gaps report. An xlsx conversion is available on request.

What are the limitations of repository-based UAT generation?

If information sources are almost entirely absent, the Skill stops and asks for documentation rather than inventing expected results. It also caps practical scope around 30 feature groups or 800 L2 items, proposing phased narrowing beyond that.