waypoint-md

<!-- polaris:start -->
## Polaris

> Auto-generated by Polaris (stacks: nextjs). Do not edit between these markers.

Polaris skills are installed under `.claude/skills/` and discovered automatically — Claude loads a skill when its description or file scope matches the task, so you don't need to reference them by hand.

### Project Structure

pnpm workspace monorepo (no Turborepo — three packages). Node 22 is pinned via
`.nvmrc` / `engines`; the local dev shell runs Node 20.x, which is compatible —
do not rely on `nvm use`. Root scripts recurse over the workspace: `pnpm typecheck`,
`pnpm lint`, `pnpm build` (all `pnpm -r ...`) and `pnpm test` (vitest at root).

#### Frontend: Next.js

- **Location**: `apps/web/`
- **Stack**: TypeScript 5, Next.js 15 (App Router), React 19, Tailwind CSS v4 + shadcn/ui (dark theme default, light available), Drizzle ORM + better-sqlite3 (WAL). API routes under `apps/web/app/api/`.
- **Key patterns**: follow the conventions already in `apps/web` — API routes under `app/api/*` (zod-validated, covered by the central auth middleware), Drizzle ORM + better-sqlite3 for data, TanStack Query v5 for client fetching, and server components for reads. The generic `nextjs-patterns` skill predates this stack (it assumes a single `lib/api.ts`, trailing-slash endpoints, dayjs) — prefer the real code where they differ.
- **API consumption**: Check integration summaries in `docs/integration/` for endpoint contracts
- **On-demand references**: Use `/react` for React best practices, `/tailwind` for Tailwind v4 patterns

#### Packages

- `packages/spec/` — `@waypoint/spec`: the review-convention parser, splice writer, types, and golden fixtures. The byte-fidelity and round-trip invariants live here.
- `packages/cli/` — the `waypoint` CLI (published to npm as `waypoint-md`): commander, zero heavy deps.

### Agents

- `agents/executor.md` — Agent: Executor

### Command-only skills

These do not auto-trigger — invoke them explicitly as slash commands:
- `/verify-nextjs`
- `/react`
- `/tailwind`
- `/nextjs-bootstrap`
- `/visual-feedback`
<!-- polaris:end -->

More agent context in theyoungastronauts/waypoint-md

8 other files this repository gives its agents.