write-test-specs

Generate end-to-end QA spec files and an index mapping tests to validation criteria.

Updated Mar 5, 2026
One-click install
npx skills add https://github.com/jaisonerick/spec-plugin --skill write-test-specs
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: write-test-specs
Source: https://github.com/jaisonerick/spec-plugin/tree/main/plugins/spec-plugin/skills/write-test-specs
Command: npx skills add https://github.com/jaisonerick/spec-plugin --skill write-test-specs

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill produces concrete, external-facing test specifications so teams can verify system behavior without relying on implementation details, reducing ambiguity between product, engineering, and QA.

Core Features & Use Cases

  • Spec Generation: Reads plan specs, architecture docs, story files, and roadmap validation gates to design API, integration, UI, health, and data integrity tests.
  • Organized Output: Writes structured QA spec files under specs/<plan-name>/qa/NNN-spec-name.md and a specs index to track coverage and status.
  • Traceability & Validation: Maps every validation gate criterion to at least one test case and groups tests by functional area to support release decisions.
  • Use Case: Prepare acceptance and E2E test suites for a new feature plan so QA can run independent verification as code is delivered.

Quick Start

Create QA specs for plan-0-infrastructure by reading specs/plan-0-infrastructure.md, its stories, architecture, and roadmap and output a specs/plan-0-infrastructure/qa index and spec files.

Frequently Asked Questions about write-test-specs

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

FAQPage Schema
How do I generate end-to-end QA test specs from a software development plan?

To generate end-to-end QA test specs, you need plan specs, architecture documents, story acceptance criteria, and roadmap validation gates. The tool reads these inputs and outputs organized QA spec files along with an index mapping tests to validation criteria.

How do I create acceptance test specifications from story files and roadmap validation gates?

Creating acceptance test specifications involves reading story files and roadmap validation gates to map every criterion to at least one test case. The process groups tests by functional area and writes structured spec files under a dedicated QA directory.

What is the best way to ensure test traceability for release decisions during QA preparation?

Test traceability for release decisions is ensured by mapping every validation gate criterion to a specific test case and generating a specs index. This index tracks coverage and status, linking external-facing tests directly to system behavior requirements.

Can I design API, integration, and UI tests from architecture documents without relying on implementation details?

Yes, you can design API, integration, UI, health, and data integrity tests from architecture documents and plan specs. This approach validates system behavior from the outside, reducing ambiguity between product, engineering, and QA teams.

Do I need roadmap validation gates to produce external-facing test specifications?

Roadmap validation gates are required to produce external-facing test specifications because they provide the necessary criteria for validation. The tool reads these gates alongside plan specs and architecture documents to generate structured QA spec files.

Why does my QA team need generated test specifications instead of writing tests manually during implementation?

Generated test specifications provide concrete, external-facing test cases so teams can verify system behavior independently. This reduces ambiguity between product, engineering, and QA, allowing QA to run independent verification as code is delivered.