tdd-substrate

Guide red-green-refactor TDD cycles for TypeScript (Vitest) and Python (pytest) stacks.

31|20|Updated Apr 9, 2026
One-click install
npx skills add https://github.com/mycelium-hq/ai-brain-starter --skill tdd-substrate
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: tdd-substrate
Source: https://github.com/mycelium-hq/ai-brain-starter/tree/main/skills/tdd-substrate
Command: npx skills add https://github.com/mycelium-hq/ai-brain-starter --skill tdd-substrate

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Iron-law Test-Driven Development substrate that consolidates best practices into a single, repeatable workflow for solos and small teams, enabling disciplined TDD cycles across dual-runtime stacks.

Core Features & Use Cases

  • Iron-law TDD: red-green-refactor with verify-fails-correctly, one-assertion-per-test discipline, and regression-test-for-every-bug patterns.
  • Dual-runtime examples: TypeScript (Vitest) and Python (pytest) cover frontend and backend workflows.
  • Structural guidance: bilingual test-fixture handling and cross-source integration to standardize testing discipline.

Quick Start

Begin by writing a failing test for a feature, then implement the minimal code to pass and refactor while keeping the suite green.

Frequently Asked Questions about tdd-substrate

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

FAQPage Schema
How do I practice strict TDD red-green-refactor cycles in both Python and TypeScript?▼

Strict TDD red-green-refactor cycles in Python and TypeScript require writing a failing test first, implementing minimal code to pass, and refactoring while keeping the suite green. This discipline uses pytest and Vitest to verify failures correctly.

What is the best way to add regression tests for bugs across dual-runtime stacks?▼

The best way to add regression tests for bugs across dual-runtime stacks is enforcing a regression-test-for-every-bug pattern. This ensures every bug fix includes a new test in Vitest or pytest before implementation.

Does this TDD workflow support both Vitest and pytest for frontend and backend environments?▼

Yes, this TDD workflow supports both Vitest and pytest for frontend and backend environments. It provides dual-runtime examples and bilingual test-fixture handling to standardize testing discipline across JavaScript, TypeScript, and Python.

How do I manage bilingual test fixtures when testing across JS and Python?▼

Managing bilingual test fixtures across JS and Python involves structural guidance for cross-source integration. This standardizes testing discipline by providing dual-runtime examples that handle fixtures consistently across Vitest and pytest.

Can a solo developer or small team adopt disciplined TDD with property-based testing patterns?▼

Yes, solo developers or small teams can adopt disciplined TDD with property-based testing patterns. The workflow consolidates best practices into a single repeatable process, ensuring one-assertion-per-test discipline across dual-runtime stacks.

Why should I verify that a test fails correctly before writing implementation code?▼

You should verify that a test fails correctly before writing implementation code to ensure the test actually targets the intended logic. This iron-law TDD practice prevents false positives and maintains strict red-green-refactor discipline across your stack.