Ground Prose

Prose patterns. Tests read like specifications.

attac-t 3cb9460 2 files · 2.7 KB Updated

File contents

Skill: Ground Prose

"Tests are specifications, not code."

The Standard

  • Full Path as Sentence: File → describe → it forms readable prose.
  • Complete Names: Test names are sentences, not fragments.
  • Two-Line Setup: Dense inline chains obscure intent. Breathe.

The Check

Ask yourself:

  • Can I read the test name aloud as English?
  • Does the full path (file + describe + it) tell a story?
  • Is setup skimmable in 2 seconds?

Real-World Examples

See examples.md.

attac-t/the-foundry/tree/main/plugins/pest/skills/ground-prose commit 3cb9460175

Frequently asked questions

npx skillmds@latest add attac-t/ground-prose