test-design

Design a target test-system blueprint from a Phase 1 inventory.

9|2|Updated Jun 6, 2026
One-click install
npx skills add https://github.com/app-vitals/shipwright --skill test-design-app-vitals
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: test-design
Source: https://github.com/app-vitals/shipwright/tree/main/plugins/shipwright/skills/test-design
Command: npx skills add https://github.com/app-vitals/shipwright --skill test-design-app-vitals

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

It turns a Phase 1 test inventory into a complete target test-system blueprint, so teams can design the right testing architecture before reconciling existing tests.

Core Features & Use Cases

  • Selects the best framework for each test layer across unit, integration, smoke, and E2E.
  • Defines local substitutes for external dependencies so tests stay runnable without hosted services.
  • Specifies canary execution rules, test-data strategy, CI pipeline shape, coverage floors, speed budgets, and repo configuration.
  • Use it when you need a greenfield test plan for a repository that must support reliable local execution and fast CI.

Quick Start

Run the test-design skill after Phase 1 has produced the inventory so it can write the target test-system blueprint to docs/test-readiness/test-system.md.

Frequently Asked Questions about test-design

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

FAQPage Schema
How do I design a test system blueprint for a greenfield repository?

To design a test system blueprint, you need to select frameworks for each layer, define dependency substitutes, establish canary contracts, and set coverage targets. This produces a complete target architecture for reliable local execution and fast CI.

What is a canary testing contract and when do I need one?

A canary testing contract specifies execution rules for canary deployments to validate production changes safely. You need one when designing a target test system blueprint that must support reliable integration across local and CI workflows.

How do I set coverage targets and speed budgets for CI pipelines?

Setting coverage targets and speed budgets involves specifying minimum coverage floors and maximum execution times within your test system blueprint. This ensures your CI pipeline shape maintains fast feedback while validating unit, integration, and E2E tests.

Does this test design approach work without hosted services for local execution?

Yes, this test design approach works without hosted services by defining local substitutes for external dependencies. This ensures your unit, integration, smoke, and E2E tests stay fully runnable in local environments without requiring hosted services.

How do I select the best testing framework for each test layer?

Selecting the best testing framework for each test layer requires evaluating your unit, integration, smoke, and E2E needs against your target test system blueprint. The design process matches framework capabilities to your specific speed budgets and coverage targets.

What do I need before planning a greenfield test system architecture?

Before planning a greenfield test system architecture, you need a Phase 1 test inventory. This inventory provides the baseline repository configuration and test data strategy needed to design the complete target test system blueprint.