Architecture

How aut-o is structured, from packages to production.

Three Layers

Framework (@aut-o/framework) — The intellectual core. Tenets, skills, scoring rubrics, quality gates, grounding generators. Available on npm; the platform runs on aut-o.com.

CLI + SDK (@aut-o/cli, @aut-o/sdk) — The runtime engine. CLI orchestrates the 9-stage pipeline. SDK embeds self-aware agents into applications.

SaaS Platform (@aut-o/web, @aut-o/api) — The business layer. Dashboard, AI assistants, billing, monitoring.

Package Dependency Graph

shared ← framework ← sdk ← cli
                  ↑         ↑
shared ← ────────┤    api ──┘
                  ↑
            web ──┘

shared has zero internal dependencies — build it first. Everything else depends on shared + framework.

Tech Stack

Monorepo	Turborepo + pnpm
Language	TypeScript (strict)
Frontend	Next.js, React, Tailwind CSS, shadcn/ui
Backend	Hono
Database	PostgreSQL 16 + Drizzle ORM
Cache	Redis 7
AI	Anthropic + OpenAI + Google AI SDKs
Auth	Better Auth
Payments	Stripe
Monitoring	Prometheus + Grafana
Testing	Vitest + Playwright
Formatting	Biome (not ESLint)
Deployment	Docker Compose + Traefik v3

Deployment

Self-hosted on a VPS with Docker Compose:

Traefik v3 — reverse proxy, SSL (Let's Encrypt), routing
PostgreSQL 16 — primary database with pgvector
Redis 7 — cache, sessions, rate limiting
Prometheus + Grafana — metrics and dashboards
Infisical — secrets management