A TDD guide focusing on observable business behavior and inside-out design emergence for cleaner architecture.

Install

mkdir -p .claude/skills/outside-in-tdd && curl -L -o skill.zip "https://agentskills.codes/api/skills/download/16648" && unzip -o skill.zip -d .claude/skills/outside-in-tdd && rm skill.zip

Installs to .claude/skills/outside-in-tdd

Activation

This is the description your AI agent reads to decide when to run this skill — the better it matches your request, the more reliably it fires.

Use when writing tests from the outside-in, defining behavior before code, or any feature where tests should start from observable business behavior and let internal design emerge
179 chars✓ has a “when” trigger
Advanced

Key capabilities

  • Map Gherkin scenarios to acceptance tests
  • Write acceptance tests with real domain objects
  • Let domain design emerge from failing tests
  • Verify with mutation testing
  • Write domain tests for business policies and rules
  • Mock only external boundaries in tests

How it works

The skill guides outside-in development by translating Gherkin scenarios into acceptance tests, allowing domain design to emerge from compilation failures, and verifying with mutation testing.

Inputs & outputs

You give it
approved Gherkin scenarios
You get back
acceptance tests, domain tests, and emergent domain design

When to use outside-in-tdd

  • Apply outside-in TDD
  • Map Gherkin scenario to acceptance tests
  • Drive domain design through failing tests
  • Mock external boundaries in tests

About outside-in-tdd

Promotes an outside-in testing methodology. It requires developers to start with Gherkin scenarios and write failing tests before creating domain classes, ensuring the design is driven strictly by requirements.

Use when writing tests from the outside-in, defining behavior before code, or any feature where tests should start from observable business behavior and let internal design emerge

When not to use it

  • When Gherkin scenarios are not written and approved
  • When creating domain classes before a test fails to compile
  • When mocking domain objects in acceptance tests

Limitations

  • The skill requires Gherkin scenarios to be written and approved
  • The skill emphasizes real domain objects and mocked external boundaries
  • The skill requires mutation testing for all changes

How it compares

This skill enforces an outside-in TDD approach where design emerges from failing tests and external boundaries are mocked, ensuring behavior-driven development unlike upfront design.

Compared to similar skills

outside-in-tdd side by side with the closest alternatives in the catalog.

SkillInstallsUpdatedSafetyDifficulty
outside-in-tdd (this skill)04moNo flagsAdvanced
tdd-workflow64moReviewIntermediate
qlty-check57moReviewBeginner
superpowers-tdd57moNo flagsIntermediate

Try saying

Example prompts that trigger this skill in your AI assistant.

Search skills

Search the agent skills registry