Build your repo
- Drizzle ORM came with Supabase. Supabase needs an ORM.
Database
ORM
- Supabase works best with Supabase Auth.
- Supabase works best with Supabase Storage.
Vercel AI SDK with a streaming chat route, structured output and tool calling.
Users, bans, impersonation and an audit log at /admin. Needs sign in.
Analytics
Error tracking
Support chat
- PostHog works best with error tracking.
Mode
The plan loop without the gate. Best when you work alone.
AI tools
Every repo ships AGENTS.md and .agents/, so any agent that reads AGENTS.md works. A tick adds that tool's own config.
What your agent gets
105 items. 60 written for your 6 batteries.
Guard hooks
3 run before a tool call. 3 run after.
2 more hooks run in team mode.
- hooks.json
- mcp_config.json
- AGENTS.md
- proxy.ts
- .env.example
- .gitignore
- .mcp.json
- AGENTS.md
- DESIGN.md
- README.md
- SETUP.md
- agentic.config.json
- biome.jsonc
- components.json
- drizzle.config.ts
- next.config.ts
- opencode.json
- package.json
- playwright.config.ts
- postcss.config.mjs
- sanity.cli.ts
- sanity.config.ts
- tsconfig.json
- vitest.config.ts
AGENTS.md
Structure preview. Where a line gives a rule's length, the real file has the rule in full. Plus 28 AGENTS.md files in rule folders.
# my-app Generated by [Agentic Boilerplate](https://github.com/agentic-studio/agentic-boilerplate) from [Agentic Studio](https://theagentic.studio). Same `agentic.config.json`, same repo: regenerate and diff any time. - **Stack:** Next.js on Vercel (`nextjs-vercel`)- **Services:** Drizzle ORM (`drizzle`), Supabase (`supabase`), Clerk (`clerk`), Resend (`resend`), PostHog (`posthog`), Sanity blog (`blog-sanity`)- **Design:** Paper (`paper`). Every UI change follows [DESIGN.md](DESIGN.md).- **Package manager:** bun- **Mode:** solo ## Start here On a fresh clone, run the `setup` skill: `/setup` in most agents, `$setup` in Codex.It reads [SETUP.md](SETUP.md), which lists every environment variable, where to getit, and the order to set the services up. ```shbun installbun run setup:env -- --check # what .env.local still needsbun run verifybun run dev``` ## How this repo is set up for agents This file is the instruction file every agent reads. It holds the rules for the whole repo. - A folder with its own `AGENTS.md` adds the rules for the files under it. Before you edit a file, read every `AGENTS.md` from the repo root down to its folder. Most agents load them for you.- `.agents/rules/`: all 22 rules in full, one file each.- `.agents/skills/`: 22 skills, listed below.- `.agents/agents/`: 6 subagents, listed below. Agents with their own folder get a copy: `.claude/agents/`, `.codex/agents/`, `.cursor/agents/`, `.github/agents/`, `.gemini/agents/`, `.opencode/agents/`.- `.agents/hooks/`: 6 guard hooks. They block destructive commands and keep secrets out of the chat. Wired for Claude Code, Codex, Cursor, GitHub Copilot, Antigravity, Gemini CLI and Windsurf. `bun run verify:hooks` proves they still block.- MCP servers: `posthog`, `supabase`. [SETUP.md](SETUP.md) says how to connect them in each agent.- `docs/solutions/`: 47 solved problems. Read the relevant one before you re-solve anything.- `docs/plans/`: one plan per unit of work.- The `system-manager` subagent owns this agent setup: `AGENTS.md`, `.agents/` and each agent's own folder. ## Workflow The Compound Engineering plugin adds the loop: `/ce-brainstorm`, `/ce-plan`, `/ce-work`, `/ce-code-review`, `/ce-compound`.In Codex they start with `$`. [SETUP.md](SETUP.md) has the install line for each agent. ## Repo-wide rules ### Code style and file conventions Source: `nextjs-vercel` 84 lines of rule text here, the same as .agents/rules/code-style.md. ### Git and change hygiene Source: `nextjs-vercel` 53 lines of rule text here, the same as .agents/rules/git.md. ### Security rules Source: `nextjs-vercel` 81 lines of rule text here, the same as .agents/rules/security.md. ## Scoped rules - `drizzle/AGENTS.md` (1 rule)- `sanity/AGENTS.md` (1 rule)- `sanity/lib/AGENTS.md` (1 rule)- `src/AGENTS.md` (2 rules)- `src/app/AGENTS.md` (7 rules)- `src/app/(app)/AGENTS.md` (1 rule)- `src/app/(auth)/AGENTS.md` (1 rule)- `src/app/(sanity)/AGENTS.md` (1 rule)- `src/app/api/draft-mode/AGENTS.md` (1 rule)- `src/app/api/sanity/AGENTS.md` (1 rule)- `src/app/api/webhooks/clerk/AGENTS.md` (1 rule)- `src/app/api/webhooks/resend/AGENTS.md` (1 rule)- `src/app/studio/AGENTS.md` (1 rule)- `src/components/AGENTS.md` (6 rules)- `src/components/app/AGENTS.md` (1 rule)- `src/components/auth/AGENTS.md` (1 rule)- `src/components/marketing/AGENTS.md` (1 rule)- `src/components/sanity/AGENTS.md` (1 rule)- `src/components/site/AGENTS.md` (2 rules)- `src/components/ui/AGENTS.md` (1 rule)- `src/db/AGENTS.md` (3 rules)- `src/lib/AGENTS.md` (2 rules)- `src/lib/analytics/AGENTS.md` (3 rules)- `src/lib/auth/AGENTS.md` (4 rules)- `src/lib/billing/AGENTS.md` (1 rule)- `src/lib/email/AGENTS.md` (1 rule)- `supabase/AGENTS.md` (1 rule)- `tests/AGENTS.md` (1 rule) These also cover files at the repo root. Read one before you edit a file it names: - `.agents/rules/deployment.md`: Deployment rules (`next.config.ts`, `vercel.json`, `package.json`, `src/proxy.ts`, `src/app/**/route.ts`, `.env.example`)- `.agents/rules/drizzle-migrations.md`: Every schema change ships with its generated migration (`src/db/**`, `drizzle/**`, `drizzle.config.ts`)- `.agents/rules/sanity-schema.md`: The schema is code, and every GROQ query lives in one file (`sanity/**`, `sanity.config.ts`) ## Skills Run one by name (`/name` in most agents, `$name` in Codex), or let the agent pick onefrom its description:`add-app-page`, `add-clerk-role`, `add-email-template`, `add-event`, `add-rls-policy`, `add-sanity-type`, `add-table`, `ask-product`, `deploy-to-vercel`, `help`, `landing-copy`, `local-supabase`, `migrate`, `new-component`, `preview-and-test-email`, `preview-draft`, `qa-feature`, `security-audit`, `setup`, `sync-clerk-user`, `verify`, `write-spec` ## Subagents Hand a task to one by name. What each one is for, and its prompt, is in`.agents/agents/<name>.md`:`designer`, `documentarian`, `pr-reviewer`, `product-analyst`, `security-auditor`, `system-manager`
Paper. Serif headlines on white paper, a grainy peach haze, black pill buttons and product sheets that float.
Your agents read this design’s DESIGN.md before they touch a colour.
