Documentation Index
Fetch the complete documentation index at: https://docs.jacobpevans.com/llms.txt
Use this file to discover all available pages before exploring further.
Three standards that apply to every repo, public or private, regardless of language or tool.These conventions are the human-readable form of policies that AI assistants enforce automatically. Every contributor — human or model — works inside the same envelope, so PRs land consistently no matter who authored them.
What this section covers
Commit conventions
No emoji in commit subjects, Conventional Commits, branch hygiene, the autonomy rules that decide when to ship vs ask.
No scripts in non-script files
Scripts live in dedicated files. YAML, Markdown, and heredocs never carry control flow.
Diagramming
Every repo with non-trivial architecture ships diagrams. Inline Mermaid where GitHub renders, standalone
.mmd + SVG otherwise.Related standards elsewhere in the site
- Golden laws — the 15 non-negotiable security rules
- Repo boundaries — how rules, plugins, and docs split across the three AI repos
- CI/CD policy — release-please, dependency pinning, runner choice
- Terraform check placement — static checks in pre-commit, credentialed ops in CI
ai-assistant-instructions and are loaded as agent context. Anything humans need to read lives here.