writing-skills

Test-driven documentation applies the RED-GREEN-REFACTOR cycle to skill creation by first writing failing test scenarios with subagents to identify agent deviation, then writing documentation to pass those tests.

Agents deviate from instructions due to documentation ambiguity and rationalization loopholes. Identifying these failure modes through rigorous baseline testing before writing documentation ensures compliance and closes loopholes.

The RED-GREEN-REFACTOR cycle for skill development involves writing failing baseline tests to identify agent failure modes, creating documentation to make tests pass, and refactoring to close loopholes and ensure compliance.

Bulletproofing against rationalization involves identifying agent deviation through baseline subagent testing, then iteratively refactoring skill documentation to explicitly address and counter common excuses agents use to ignore instructions.

Yes, baseline subagent testing is required to identify failure modes and documentation ambiguity before writing skill documentation, ensuring the final instructions are rigorously tested and reliable.