Docs
›
Reference
›
Platform Gates
🚦 Reference
Platform Gates
Every platform has a specific set of required libraries, quality gate commands, and
Verifier checks. The Planner reads the active template's .agent/ config
to know which gates apply. The Builder must pass all platform gates before marking any
task DONE.
Next.js / Web Platform
| Category | Requirement |
|---|
| Framework | Next.js 15 (App Router) |
| Runtime | Node.js 22 LTS |
| Language | TypeScript strict mode |
| Styling | Tailwind CSS v4 (or MUI v6 for admin templates) |
| Testing | Vitest (unit/integration) + Playwright (E2E + visual) |
| Gate command | pnpm agent:check (lint + types + test + build) |
| E2E gate | pnpm agent:e2e |
| Visual gate | pnpm agent:visual |
| Perf gate | pnpm test:perf |
Required Next.js Libraries (by category)
| Category | Libraries |
|---|
| Auth | next-auth v5 (beta) with Prisma adapter |
| Database ORM | Prisma 6 + PostgreSQL (production) / SQLite (dev) |
| Validation | Zod ^3.23 (runtime + schema) |
| UI Components | shadcn/ui (Radix primitives + Tailwind) |
| State | Zustand ^5 (client) + React Query (server state) |
| Email | Resend + React Email |
| Payments | Stripe v16 (webhooks required) |
| Animation | Framer Motion ^11 |
| AI | Anthropic SDK ^0.26 / Vercel AI SDK ^3 |
Tauri (Linux Desktop)
| Category | Requirement |
|---|
| Framework | Tauri v2 |
| Frontend | React + Vite + TypeScript |
| Styling | Tailwind CSS v4 |
| Backend | Rust (2021 edition) |
| Database | better-sqlite3 in WAL mode (PATTERN-004) |
| Rust test gate | cargo test |
| Frontend test gate | pnpm agent:check |
| Build gate | cargo tauri build |
Python Desktop (ML/Audio)
| Category | Requirement |
|---|
| GUI | PySide6 ^6.7 |
| ML | PyTorch ^2.3 (CUDA/MPS/CPU auto-detection) |
| Package manager | Poetry (pyproject.toml) |
| Config | pydantic-settings (env-driven) |
| Test gate | pytest |
| Lint gate | ruff check . |
| Type gate | mypy . |
Rust GTK4 (Linux Native)
| Category | Requirement |
|---|
| GUI | gtk4 ^0.9 + libadwaita ^0.7 |
| Design | Adwaita HIG (human interface guidelines) |
| Async | Tokio full runtime |
| Config | serde_json + directories ^5.0 |
| Error handling | thiserror (structured errors) |
| Test gate | cargo test |
| Lint gate | cargo clippy -- -D warnings |
| Build gate | cargo build --release |
Python CLI
| Category | Requirement |
|---|
| CLI framework | Typer[all] ^0.12 |
| Output | Rich ^13.7 |
| HTTP | httpx |
| Secrets | keyring (OS keychain integration) |
| Config | platformdirs (user_config_dir) |
| Test gate | pytest |
| Lint gate | ruff check . |
Node.js CLI (AI-Powered)
| Category | Requirement |
|---|
| CLI framework | Commander ^12 |
| TUI | Ink ^5 (React-based terminal UI) |
| AI | Anthropic SDK ^0.26 |
| Secrets | Keytar (OS keychain) |
| Test gate | pnpm test (Vitest) |
| Build gate | pnpm build (tsup) |
Verifier Platform Checks
In addition to the standard QA phases, the Verifier performs platform-specific checks:
| Platform | Verifier checks |
|---|
| Next.js web | Bundle size, Core Web Vitals, CSP headers, HTTPS enforcement |
| Tauri desktop | App signing, permissions manifest, auto-update config |
| Python desktop | Packaging with PyInstaller/cx_Freeze, dependency isolation |
| Rust GTK4 | Release build size, AppImage packaging, .desktop entry |
| CLI (any) | Binary size, help text completeness, exit code correctness |