test-spec

What it does

Transforms product requirements and implementation details into a comprehensive test specification and QA plan for iOS/macOS apps, covering unit tests, UI tests, accessibility testing, and beta testing. Creates TEST_SPEC.md content from PRD and implementation specs, guiding QA strategy.

How it works

• Activates when the user says any of: "generate test spec", "create QA plan", "write testing guide", "generate test cases", or "create test specification".
• Reads input sources from:
  • docs/PRD.md: features with acceptance criteria, user stories, success criteria, non-functional requirements.
  • docs/IMPLEMENTATION_GUIDE.md: viewmodels to test, data models to test, API endpoints, file structure.
  • docs/UX_SPEC.md: user flows, interactions, states, edge cases.
  • docs/ARCHITECTURE.md: testing strategy overview, tech stack.
• Generates output in docs/TEST_SPEC.md with the structure outlined in the skill, including sections for Test Strategy, Pyramid, Levels, Environments, and detailed unit test cases, view model tests, and helper examples.
• Provides concrete test case templates for data models and view models, including file paths, test case names, inputs, and expected outputs, using the project’s naming conventions and Swift/XCTest style as shown in the examples.

When to use it

Use when creating a QA strategy and corresponding test specification for an iOS/macOS app, ensuring coverage across unit, integration, UI, and manual testing via beta channels.

What it can touch

• Reads: docs/PRD.md, docs/IMPLEMENTATION_GUIDE.md, docs/UX_SPEC.md, docs/ARCHITECTURE.md
• Writes: docs/TEST_SPEC.md
• Tools mentioned for context in the skill include: XCTest, XCUITest, TestFlight, JSON encoding/decoding patterns, and mock testing approaches (as shown in the examples). The skill’s allowed-tools are Read, Write, Glob, Grep, AskUserQuestion.

Caveats

• Requires that PRD, IMPLEMENTATION_GUIDE, UX_SPEC exist (as prerequisites).
• Output follows the structured template shown in the provided skill examples and does not propose outcomes beyond what is specified in those templates.