gsd-verify-work

Run conversational user acceptance tests and generate phase-specific UAT markdown reports.

Updated Aug 15, 2025
One-click install
npx skills add https://github.com/gesmith0606/nfl_data_engineering --skill gsd-verify-work-gesmith0606
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: gsd-verify-work
Source: https://github.com/gesmith0606/nfl_data_engineering/tree/main/.claude/skills/gsd-verify-work
Command: npx skills add https://github.com/gesmith0606/nfl_data_engineering --skill gsd-verify-work-gesmith0606

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Validate built features through structured conversational user acceptance testing and preserve session state so stakeholders can confirm deliverables actually work from an end-user perspective. It removes the friction of ad-hoc testing by guiding a single-test-at-a-time workflow, capturing outcomes, and creating an auditable UAT artifact for each phase.

Core Features & Use Cases

  • Conversational UAT sessions: Presents and runs one test at a time in plain text, capturing user responses and session gates to ensure clarity and reproducibility.
  • Persistent reporting: Produces phase-specific UAT markdown reports (e.g., 4-UAT.md) that track all results, decisions, and next steps for audits and handoffs.
  • Automated diagnosis and fix planning: When tests fail, automatically diagnoses gaps, drafts verified fix plans, and prepares the output for execution via the /gsd:execute-phase path.
  • Use Case: A QA lead or product manager runs phase 4 validation to confirm feature parity, capture failures, and hand a ready-to-run fix plan to engineers.

Quick Start

Run the verify-work workflow for phase 4 to perform a conversational UAT and generate the 4-UAT.md report.

Frequently Asked Questions about gsd-verify-work

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

FAQPage Schema
How do I run conversational user acceptance testing for a development phase?

Conversational user acceptance testing is run by executing a single-test-at-a-time workflow that captures user responses and session gates to validate built features. The system maintains persistent session state and produces an auditable markdown report for each phase.

Can I automatically generate a fix plan when UAT tests fail?

Yes, when UAT tests fail, the system automatically diagnoses gaps and drafts verified fix plans ready for execution. It prepares actionable fix plans that can be directly handed off to engineers for iterative issue resolution.

What is the best way to maintain persistent state and audit results across UAT sessions?

The best way to maintain persistent state is by emitting phase-specific UAT markdown reports, such as phase_{n}-UAT.md, that track all results, decisions, and next steps. This creates an auditable artifact for stakeholder handoffs and release validation.

How does session gating work in conversational QA validation?

Session gating in conversational QA works by presenting one test at a time in plain text and capturing user responses before proceeding. This ensures clarity and reproducibility by validating each test outcome individually before moving to the next step.

Do I need built features ready before starting iterative fix planning and diagnosis?

Yes, this workflow is designed for development and release candidates, meaning built features must exist to validate. It validates feature parity from an end-user perspective and generates diagnostic findings for any gaps discovered.

Why use a conversational UAT workflow instead of ad-hoc testing for feature validation?

A conversational UAT workflow removes the friction of ad-hoc testing by structuring validation into single-test sessions with automated diagnosis. It captures outcomes systematically and generates phase-specific reports with ready-to-run fix plans for engineering handoff.