forge-tests

What problem does it solve?

The forge-tests skill prevents teams from shipping brittle, misleading, or flaky test suites by enforcing test hygiene rules that make failures actionable and CI runs dependable.

Core Features & Use Cases

• Disciplined test structure: Enforces unit vs integration boundaries, behavior-driven assertions, and one-concept-per-test design.
• Determinism by construction: Prohibits sleeps, wall-clock reads, randomness, and shared mutable state that cause nondeterministic outcomes.
• Real integration testing: Encourages real databases for integration tests (e.g., Postgres in CI) and deterministic per-test isolation with clean resets.
• Clear failure semantics: Prioritizes descriptive assertions and setup that makes the reason for failure obvious.
• Verifier support: Provides a CI-runnable verifier that flags common anti-patterns like tautological assertions and prohibited test markers.

Quick Start

Instruct your AI to write a CI-runnable unit and integration test suite for your feature, following isolation, determinism, and real-DB integration rules, then verify the tests with the provided check script.