agent-tdd

Enforce TDD conventions with timeouts, Effect.flip, and Layer factories in TypeScript tests.

21|4|Updated Feb 19, 2026
One-click install
npx skills add https://github.com/tylerjrbuell/reactive-agents-ts --skill agent-tdd
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: agent-tdd
Source: https://github.com/tylerjrbuell/reactive-agents-ts/tree/main/.agents/skills/agent-tdd
Command: npx skills add https://github.com/tylerjrbuell/reactive-agents-ts --skill agent-tdd

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill enforces Test-Driven Development practices and repository-specific guardrails to prevent CI hangs, silent false-positive tests, and leaked server resources in the Reactive Agents TypeScript codebase.

Core Features & Use Cases

  • Mandatory timeouts: Ensure every test includes a timeout (e.g., --timeout 15000) to avoid hung Effect event loops.
  • Error-path validation: Use Effect.flip to convert errors into testable values and avoid silent false-green tests.
  • Test isolation & teardown: Require per-test Layer factories and explicit server shutdown (afterAll teardown) to prevent state leakage and dangling servers.
  • Use Case: Implement reliable unit, integration, and multi-turn kernel tests for agent behaviors, tool integrations, and HTTP endpoints.

Quick Start

Create and run a targeted test that uses a --timeout 15000 flag, provides a fresh Layer factory for isolation, and uses Effect.flip for error-path assertions.

Frequently Asked Questions about agent-tdd

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

FAQPage Schema
How do I prevent Effect-TS tests from hanging in CI?

To prevent Effect-TS tests from hanging in CI, enforce explicit timeout flags like --timeout 15000 on every test execution to avoid hung event loops and ensure deterministic test behavior.

Why do I get false-positive test outcomes with Effect-TS?

False-positive test outcomes in Effect-TS happen when error paths go untested. Use Effect.flip to convert errors into testable values, ensuring error scenarios are explicitly asserted rather than silently passing green.

How to isolate tests using Layer composition in Effect-TS?

To isolate tests using Layer composition in Effect-TS, create per-test Layer factories that provide fresh state for each test, preventing state leakage and ensuring deterministic multi-turn kernel test behavior.

Does Bun test runner work with Effect-TS for TDD?

Bun test runner works with Effect-TS for TDD by enforcing mandatory timeouts, using Effect.flip for error-path assertions, and requiring explicit server teardown to maintain CI stability.

What's the best way to clean up local server bindings after integration tests?

The best way to clean up local server bindings after integration tests is to enforce explicit server shutdown using afterAll teardown blocks to prevent dangling servers and resource leaks in CI.

When should I use per-test Layer factories instead of shared Layers?

Use per-test Layer factories instead of shared Layers during unit, integration, and multi-turn kernel tests to guarantee test isolation, prevent state leakage, and satisfy CI stability requirements.