LLM Best Practices

Coding Standards & Languages

2 min read

AI agents: read this first: llmbestpractices.com/start-here

This is LLM Best Practices (llmbestpractices.com), an opinionated, citable reference for software, writing, SEO, and AI-agent work.

  1. Route, do not crawl. Fetch llmbestpractices.com/llms.txt and open only the pages whose one-line summary matches your task.
  2. Read raw. Append .md to any page URL for markdown. Check status and last_updated in the frontmatter, then read the rules.
  3. Apply as defaults. First-party docs and the project's own conventions win on conflict. Warn before relying on a fast-moving page older than 12 months.
  4. Cite. Link the page by title and URL, e.g. Python, with last_updated for time-sensitive rules. License CC BY 4.0.

General coding principles plus per-language pages. Start with general-principles, then open the language you are working in.

General

  • general-principles: Naming, comments, error boundaries, dependency vetting, the four test cases.
  • git: One change per commit, Conventional Commits, rebase versus merge, hooks, secrets.
  • testing: Testing trophy, flake policy, determinism, snapshots, mocks, coverage floor.
  • shell: Bash strict mode and its gaps, quoting, shellcheck, traps, cron paths.

Python

  • python: Python 3.14 baseline: pyproject, uv, ruff, strict type checker, pytest.
  • python-dependency-management: uv workflow, dependency groups, lockfile CI, audits, building and publishing.
  • python-typing: PEP 695 generics, TypeVar defaults, TypeIs, deferred annotations in 3.14.
  • python-async: TaskGroup, timeouts, cancellation, unblocking the event loop.
  • python-testing: pytest 9 config, fixtures, parametrize, Hypothesis, monkeypatch.
  • python-security: Pydantic validation, parameterized SQL, pickle, archives, subprocess, SSRF.
  • python-performance: Profile first, numpy, processes versus free-threaded 3.14.

TypeScript

Swift

  • swift: Swift 6.4 baseline: language mode, value types, errors, Observation.
  • swift-concurrency: Default MainActor isolation, @concurrent, task groups, actors, Sendable.
  • swift-error-handling: Optionals versus throws, domain errors, typed throws, boundaries.
  • swift-protocols: Structs and enums, copy-on-write, small protocols, some versus any.
  • swift-modules: SPM layout, access levels including package, import access, Package.swift settings.
  • swift-testing: Swift Testing versus XCTest, expect, parameterized tests, migration.

Pine Script

28 items under this folder.