Spec.md files are specification documents, typically in markdown, that describe what you’re building, and how — your rules, your patterns, your way of doing things.