Docs

Agentic Development

How agents should work inside this core repo.

1

AGENTS.md is the shared source of truth for coding agents.

2

Claude, Gemini, Cursor, and Copilot instructions should point back to AGENTS.md.

3

Run pnpm varel impact "<task>" --json to get affected-provider hints before open-ended provider, env, domain, auth, billing, email, analytics, deploy, or agent-guidance work.

4

Run pnpm varel setup plan --json before provider setup work.

5

Keep agents aware of local sandbox, Vercel preview, and Vercel production env readiness.

6

Run pnpm varel doctor --json and pnpm agent:preflight before broad handoff.

7

Use Hyperdrive MCP tools for task impact, setup plans, next steps, provider handoffs, domain plans, Computer Use checkpoints, setup validation, UI review, and SEO review.

8

Core owns bootstrap guidance, local checks, env ownership, integration starting points, and generic provider reminders; Hyperdrive owns deeper provider sequencing and external-system orchestration when installed.

9

For Sanity provider work, use Sanity MCP, Sanity CLI, and official global Sanity skills; do not vendor official Sanity skills into this repo.

10

Keep docs, env, billing, data boundaries, and tests aligned when product behavior changes.