spurpower-writing-skills

To apply TDD to process documentation, you write failing baseline pressure scenarios that expose agent rationalizations, then draft documentation rules to close those loopholes. This ensures your workflow guides are testable and robust against shortcuts.

A pressure scenario is a baseline test case designed to trigger AI agent rationalizations and shortcuts. Running it before finalizing documentation helps identify workflow loopholes so you can systematically close them in your reference guides.

You stop agent rationalizations by executing baseline pressure scenarios to observe failure modes, then systematically adding rules to your documentation that block those specific shortcuts. This enforces strict adherence to the defined workflow.

Use a test-driven approach for creating agent skills when you need strict adherence to a complex workflow. It ensures your reusable techniques and reference guides are robust, testable, and resistant to agent rationalizations under pressure.

No external testing frameworks or dependencies are required. The test-driven documentation process runs baseline pressure scenarios directly against the agent to identify rationalizations and mitigate them before finalizing your reference guides.