tdd

Enforces a test-driven workflow of writing failing tests, minimal implementation, running suite, committing.

Updated Aug 23, 2026
One-click install
npx skills add https://github.com/acedergren/oci-self-service-portal --skill tdd-acedergren
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: tdd
Source: https://github.com/acedergren/oci-self-service-portal/tree/main/.claude/skills/tdd
Command: npx skills add https://github.com/acedergren/oci-self-service-portal --skill tdd-acedergren

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Test-driven development (TDD) enforces writing failing tests before implementing code, reducing defects and aligning software behavior with requirements.

Core Features & Use Cases

  • Guided test-first workflow: prompts to write failing tests, then implement the minimum code to pass.
  • Structured iteration: enforces red-green-refactor cycles and disciplined commits.
  • Mocking & test placement guidance: helps place tests correctly across colocated files, routes, and APIs to maximize coverage.

Quick Start

Write a failing unit test for the target module, implement the minimum code to make it pass, run the full test suite, and commit.

Frequently Asked Questions about tdd

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

FAQPage Schema
How do I enforce a strict test-driven development workflow from writing failing tests to committing code?▼

To enforce test-driven development, you write a failing unit test first, implement the minimum code required to pass it, run the full test suite, and commit. This structured red-green-refactor cycle ensures software behavior aligns with requirements and reduces defects.

What is the best way to structure unit tests and mocking for colocated files, routes, and APIs?▼

The best way to structure unit tests is to place them in colocated files alongside target modules, routes, and APIs. This workflow provides guidance on correct test placement and mock validation to maximize coverage across classic test-driven development scenarios.

Does this test-driven development workflow work with Vitest for unit testing?▼

Yes, this test-driven development workflow supports Vitest for unit testing. It guides you through writing failing tests, implementing code to pass them, and running the full suite to ensure quality assurance before committing changes in your software project.

Can I use this workflow for test placement and mock validation across API and route tests?▼

Yes, you can use this workflow for test placement and mock validation across API and route tests. It applies to software projects with colocated tests, helping you maximize coverage by correctly placing tests for modules, routes, and APIs.

How do I maintain commit hygiene during a red-green-refactor cycle?▼

To maintain commit hygiene during a red-green-refactor cycle, you write a failing test, implement the minimum code to pass, run the full test suite to confirm, and then commit. This disciplined approach ensures only verified, tested code is committed to the repository.

When do I need a guided test-first workflow for software development?▼

You need a guided test-first workflow when you want to reduce defects and align software behavior with requirements. It enforces writing failing tests before implementing code, ensuring strict adherence to quality assurance and proper test coverage across your project.