Developer-facing documentation, written by and for AI agents (and humans). Start with the philosophy, then dip into specifics as needed.
- philosophy.md — the "why". Read this first.
- architecture.md — repo layout, packages, how consumption works.
- code-style.md — house code-quality rules.
- testing.md — testing stack and conventions.
- ai-docs-convention.md — the
docs/pattern itself, to replicate in every repo. - adopting-nextkit.md — migrating a site onto nextkit.
- better-auth-migration.md — plan for moving the fleet from Supabase Auth to Better Auth while keeping RLS.
- creating-a-package.md — checklist for new packages.
- releasing.md — versioning + npm Trusted Publishing flow.
- ingram-cloud.md — planned backend (placeholder).