test-documentation

Document validated test cases in Jira or Xray with ROI prioritization and traceability.

Updated Aug 31, 2026
One-click install
npx skills add https://github.com/ahuaracab/test-genesis --skill test-documentation-ahuaracab
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: test-documentation
Source: https://github.com/ahuaracab/test-genesis/tree/main/.agents/skills/test-documentation
Command: npx skills add https://github.com/ahuaracab/test-genesis --skill test-documentation-ahuaracab

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Teams that validate behavior during sprints often lose that knowledge because test cases never reach the test management system, leaving no regression repository and broken traceability between stories, test plans, and test cases. This Skill formalizes already-validated scenarios into TMS artifacts (Test Cases, Acceptance Test Plans, Test Sets, Test Executions) with correct naming, prioritization, and link structure. ## Core Features & Use Cases - Analyze, Prioritize, Document pipeline: Derives test cases from acceptance criteria using EP, BVA, state-transition, decision-table, and pairwise techniques, then applies an ROI formula to classify each as Candidate, Manual, or Deferred before writing anything to the TMS. - Multi-modality TMS support: Resolves whether the project uses Jira with Xray, Jira-native, Notion, or Azure DevOps, and adapts artifact containers, membership semantics, and linking rules accordingly. - Repair-traceability mode: Audits an existing Story-ATS-ATP-ATR-TC cascade, presents a fix plan, waits for explicit approval, then repairs broken links and verifies coverage. - Use Case: After a story is QA-approved, invoke the skill with the story key to create the mandatory ATS, link the ATP and ATR, and persist only regression-worthy test cases with Gherkin specifications and automation verdicts. ## Quick Start Ask the agent to document the validated test scenarios for a specific Jira story key, for example by requesting that it analyze and document test cases in the TMS for PROJ-123.

Frequently Asked Questions about test-documentation

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

FAQPage Schema
How do I document test cases in Jira after a story is approved?

Invoke the skill with the story key; it runs Analyze, Prioritize, and Document phases. It derives test cases from acceptance criteria, assigns each a Candidate, Manual, or Deferred verdict via ROI scoring, then creates the ATS, ATP, ATR, and test cases with correct links.

How does the skill decide which test cases to automate?

Each scenario gets an ROI score based on frequency, impact, stability, effort, and dependencies. The score maps to one of three verdicts: Candidate flows to test-automation, Manual stays in regression, and Deferred is not persisted.

Does it work with both Jira Xray and Jira without Xray?

Yes. A Phase 0 gate resolves the TMS modality by checking config, environment variables, and available issue types. Jira-Xray uses Xray-internal membership via GraphQL, while Jira-native expresses ATS membership as issue links.

How do I fix broken traceability links between a story and its test cases?

Use the repair-traceability mode with the ticket key. It audits the coverage cascade, presents a fix plan, waits for your explicit approval, applies repairs toward the ATS path, and verifies the coverage panel is filled.

When should I not use this skill for testing work?

Do not use it for exploratory testing of unvalidated behavior, which belongs to sprint-testing, or for writing automated test code, which belongs to test-automation. It only documents behavior that was already validated.