ground-prose

Prose patterns. Tests read like specifications.

SKILL.md

GitHub

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.