writing-tests-against-stubs

Write and verify tests against frozen stubs with unimplemented markers.

Updated May 7, 2026
One-click install
npx skills add https://github.com/TK-Evans01/tk-harness --skill writing-tests-against-stubs
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: writing-tests-against-stubs
Source: https://github.com/TK-Evans01/tk-harness/tree/main/plugins/tk-rpie/skills/writing-tests-against-stubs
Command: npx skills add https://github.com/TK-Evans01/tk-harness --skill writing-tests-against-stubs

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill ensures that tests against stubs are written correctly, covering all acceptance criteria and failing with the expected unimplemented marker, thereby promoting effective test-driven development (TDD) practices.

Core Features & Use Cases

  • Strict Test Verification: Enforces that tests fail with the unimplemented marker, ensuring proper testing against stubs.
  • Acceptance Criterion Coverage: Ensures that every acceptance criterion from the design doc has a corresponding test.
  • Property-Based Testing: Encourages the use of property-based testing for pure functions to ensure robustness.

Quick Start

Run all tests for the 'normalize_email' function to verify that they fail with the unimplemented marker.

Frequently Asked Questions about writing-tests-against-stubs

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

FAQPage Schema
How do I write TDD tests against frozen stubs that fail correctly?

To write TDD tests against frozen stubs, you must ensure the tests fail with the expected unimplemented marker and cover all acceptance criteria. This enforces proper test-driven development practices before implementation begins.

How do I verify my test suite covers all acceptance criteria?

Verifying acceptance criteria coverage requires mapping every criterion from your design doc to a corresponding test. This ensures your test suite comprehensively validates all specified requirements against the frozen stubs.

When should I use property-based testing for pure functions?

Property-based testing for pure functions should be used to ensure robustness across a wide range of inputs. It complements standard stub testing by validating mathematical invariants and edge cases automatically.

Does this stub testing approach work with the rpie three-phase flow?

Yes, this stub testing approach is specifically designed for the rpie three-phase flow. It requires strict adherence to TDD principles to effectively verify unimplemented markers and acceptance criteria.

Why do my stub tests need to fail with an unimplemented marker?

Stub tests need to fail with an unimplemented marker to strictly verify that the test is checking the correct behavior before any logic is written. This prevents false positives and ensures proper TDD progression.

What are the limitations of testing against frozen stubs?

Testing against frozen stubs is limited to verifying acceptance criteria and unimplemented markers. It does not validate actual implementation logic, integration points, or runtime side effects outside the defined pure function boundaries.