0b901cf2f9
Generic Constructor-Pattern agent kit for Claude Code. Zero personal data, fully English, MIT-licensed. Contents: - 34 reusable blocks (baseline, rules, stack/deploy/domain/api/scraper) - 14 cross-project agent manifests (code/ml/infra/researcher/critic/...) - 6 portable skills (/new-agent, /research, /test-gen, /debug-deep, /pr-review, /refactor) - Rust assembler (single binary, ~500 KB) - 3 hooks (auto-reassemble, pre-commit validate, no-hand-edit) - install.sh (idempotent, cargo-builds on first run) - MIT LICENSE All 6 sanity greps pass: 0 Russian text, 0 specific project names, 0 incident numbers, 0 user paths, 0 hardcoded IPs, 0 API keys. cargo check + assemble --validate: both pass on 14 manifests. Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
21 lines
1.6 KiB
Markdown
21 lines
1.6 KiB
Markdown
# STACK — Next.js 15/16 (App Router + TS + Server Components)
|
|
|
|
Use for browser/DOM work. TypeScript is the default for this stack; consider Rust→wasm where viable.
|
|
|
|
**Routing:** App Router (`app/`) — NOT Pages Router (`pages/`). Server Components by default; `"use client"` directive ONLY on components that need `useState` / `useEffect` / event handlers / browser APIs.
|
|
|
|
**Data flow:**
|
|
- Read: Server Components call DB/API directly. No client-side fetching for initial render.
|
|
- Mutate: Server Actions (`"use server"` functions) — NOT ad-hoc API routes unless a third party needs to call them.
|
|
- Cache: `fetch()` in Server Components uses Next's fetch cache; opt out with `cache: "no-store"` or `revalidate: N`.
|
|
|
|
**ORM:** Drizzle OR Prisma — pick ONE per project, never both. Drizzle preferred for edge-runtime compatibility (Cloudflare Workers).
|
|
|
|
**Env vars:**
|
|
- Server-only: `process.env.FOO` (never leaks to client bundle).
|
|
- Client-visible: `process.env.NEXT_PUBLIC_FOO` — everything else is redacted in the browser.
|
|
- Secrets: platform vars (Vercel / Cloudflare), `.env.local` locally, NEVER in `next.config.js` (ships to client).
|
|
|
|
**Typical paid-AI stack:** Next.js 16 + TypeScript + Drizzle/SQLite + Tailwind 4 + shadcn. Files > 200 LOC get split on-the-spot (Constructor Pattern). For paid AI calls, track cost in integer microdollars (1 USD = 1e6 μ$) — floats forbidden for money.
|
|
|
|
**Forbidden:** Pages Router for new routes, `"use client"` at the top of pages that don't need interactivity (ships 30-100kb extra JS), Drizzle + Prisma together, secrets in `next.config.js` or inside `NEXT_PUBLIC_*`.
|