Overview

llmbestpractices.com is an opinionated reference vault of best practices for software development, writing, AI agent work, SEO, file organization, and adjacent crafts. Pages are short, atomic, YAML-fronted, and designed to be cited inside an agent prompt or a developer’s working notes.

The site is maintained as a public knowledge vault. Every page is licensed CC BY 4.0; quote freely with attribution.

Maintainers

The vault is maintained by LLM Best Practices Maintainers. The canonical source of truth is the git repository at github.com/AXIA-Enterprises/llmbestpractices. All page revisions go through pull requests with the lint, build, JSON-LD, link, spell, accessibility, and Lighthouse CI checks.

This is not a community wiki. Contributions are welcome via GitHub issues; substantive changes go through PR review.

Production process

Pages are produced under the voice rules in voice and the structural rules in articles. Banned constructions are listed in anti-slop. A linter at scripts/lint-content.mjs enforces the schema, voice, tag density, and wikilink density on every PR.

Claude Code is used as a writing assistant; see for-ai-agents for the agent-facing schema and claude-code for the workflow. Every page is reviewed by a human before merge. Voice and structure deviations are caught by the linter or by a self-audit pass.

What you can do with this site

  • Cite pages in agent prompts, code reviews, design docs.
  • Fork the repository.
  • Embed the corpus from /llms-full.txt into your own retrieval index.
  • Suggest a page via a GitHub issue.

How to cite

See how-to-cite for the citation format. The short form: title, canonical URL, and last_updated when the rule is time-sensitive.