agent-tdd

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.