Tests As Spec

The unit suite written as the teaching document for the next fresh-context agent, carrying names that state behaviour, arrangement that shows the module's shape, one behaviour per test, and the paths a newcomer guesses wrong. Reach for it when the reader of your tests is an agent that will not open the implementation, when a suite has to survive being handed to a context that never met its author, or when someone says "tests as documentation", "my test names say nothing", "make this suite readable for the next agent", "the tests should explain the system". Differentiator - this island owns the unit suite as a document for a reader; the story-level acceptance contract and the proof that the suite bites belong to neighbouring islands.

Island-Dev-Crew Updated 4 repo stars
Uncle Bob Skills — human intent, agent work, evidence, and human decision

File contents

Island-Dev-Crew/uncle-bob-skills commit edd11d9e6b

Frequently asked questions

npx get-skill add island-dev-crew/tests-as-spec