test-writer

Generate end-to-end test suites from user stories and architecture docs.

18|3|Updated Mar 28, 2026
One-click install
npx skills add https://github.com/ondrej-svec/heart-of-gold-toolkit --skill test-writer-ondrej-svec
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: test-writer
Source: https://github.com/ondrej-svec/heart-of-gold-toolkit/tree/main/plugins/marvin/skills/test-writer
Command: npx skills add https://github.com/ondrej-svec/heart-of-gold-toolkit --skill test-writer-ondrej-svec

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Writes comprehensive test suites derived from user stories and architecture documentation to enforce RED state by ensuring failures are detected early and never masked by optimistic tests.

Core Features & Use Cases

  • Reads stories and architecture docs to extract acceptance criteria and architecture constraints.
  • Generates behavioral tests and conformance tests that reference STORY IDs and dependencies for traceability.
  • Supports standalone and pipeline modes, and ensures tests fail when implemented correctly.

Quick Start

Generate a RED-state test suite from the project stories and architecture docs.

Frequently Asked Questions about test-writer

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

FAQPage Schema
How do I generate failing tests from user stories and architecture docs?

Behavioral tests validate expected interactions, while conformance tests check architecture dependencies. Both types reference STORY IDs for traceability, import real implementations, avoid mocks, and run npm test to confirm RED state.

Can I integrate test generation into a CI pipeline mode?

Yes, test generation supports both standalone and pipeline modes. In pipeline mode, it reads stories and architecture docs automatically to produce behavioral and conformance tests that enforce RED state without manual intervention.

What is RED state in behavioral and conformance testing?

RED state in behavioral and conformance testing means tests intentionally fail before implementations are complete. By importing real implementations and avoiding mocks, running npm test validates that failures are detected early and never masked.

Do I need mocks for end-to-end test suites generated from stories?

No, generated end-to-end test suites avoid mocks entirely. They import real implementations to ensure that running npm test accurately validates the RED state against actual architecture dependencies.

Why do my generated test files reference STORY IDs?

Generated test files reference STORY IDs to maintain traceability between user stories, architecture docs, and test suites. This ensures every behavioral and conformance test maps back to specific acceptance criteria.