SPipe Test Writing Skill

What problem does it solve?

Writing reliable test specifications for the Simple BDD framework can be slow and inconsistent, especially when teams need consistent docstrings, matchers, and coverage annotations.

Core Features & Use Cases

• Baked-in BDD primitives: Provides a consistent way to write specs using built-in describe/context/it/expect without imports.
• Documentation-first spec structure: Enforces a required module-level docstring format and supports docstring-driven doc generation.
• Coverage guardrails for system tests: Requires # @cover annotations for system tests so the test runner can verify layer coverage.

Use it when you need to create or standardize feature specs (including docstrings and matcher usage) for a Simple project, such as adding a new calculator feature with scenarios and assertions that document behavior.

Quick Start

Use the SPipe test writing instructions to create your spec file at test/my_spec.spl and then run bin/simple test test/my_spec.spl.