test-driven-development

Generate Rust test stubs from specs, tasks, or descriptions.

3.1k|286|Updated Sep 7, 2025
One-click install
npx skills add https://github.com/mikeyobrien/ralph-orchestrator --skill test-driven-development-mikeyobrien
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: test-driven-development
Source: https://github.com/mikeyobrien/ralph-orchestrator/tree/main/.claude/skills/test-driven-development
Command: npx skills add https://github.com/mikeyobrien/ralph-orchestrator --skill test-driven-development-mikeyobrien

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Unified TDD workflows can be brittle without a guided process. This skill ensures test-first development by generating concrete test scaffolds from specs, tasks, or descriptive prompts, helping teams validate requirements before implementation and reducing downstream rework.

Core Features & Use Cases

  • Three input modes handle specs (.spec.md), tasks (.code-task.md), and ad-hoc descriptions.
  • Generates test stubs and criteria aligned to repository patterns, enabling the RED → GREEN → REFACTOR cycle.
  • Supports proptest guidance and backpressure integration to track coverage and iteration speed.

Quick Start

Provide a spec, task, or description input to trigger automatic test stub generation and immediate guidance for the TDD cycle.

Frequently Asked Questions about test-driven-development

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

FAQPage Schema
How do I generate Rust test stubs from a spec file?

To generate Rust test stubs from a spec file, you provide the .spec.md file as input to trigger automatic Given/When/Then criteria scaffolding. This creates concrete test structures aligned to repository patterns, enabling immediate iteration on the RED -> GREEN -> REFACTOR cycle.

What is the best way to enforce test-first development in Rust?

Enforcing test-first development in Rust requires generating concrete test scaffolds from specs, tasks, or descriptions before writing implementation code. This approach validates requirements upfront, enforces cargo test preflight checks, and reduces downstream rework by ensuring test coverage drives the development cycle.

Can I use TDD with ad-hoc task descriptions instead of formal specs?

Yes, you can use TDD with ad-hoc task descriptions instead of formal specs. The skill supports three input modes: spec-based files, task-driven .code-task.md requirements, and description-driven scenarios, allowing flexible test stub generation regardless of your documentation format.

Does this TDD workflow integrate proptest and cargo test preflight checks?

Yes, this TDD workflow integrates proptest guidance and enforces cargo test preflight checks. It compiles generated test stubs automatically and incorporates backpressure concepts to track coverage and iteration speed during the test-first development cycle.

Why should I generate test stubs before writing implementation code?

Generating test stubs before implementation code ensures test-first development by validating requirements prior to coding. This unified TDD workflow reduces downstream rework, provides immediate guidance for the RED -> GREEN -> REFACTOR cycle, and helps teams catch specification gaps early.