Agentic App

Multi-agent development template — clone for new projects.

Stack

• Framework: Next.js 15 (App Router)
• Language: TypeScript 5.7 (strict mode)
• Styling: Tailwind CSS v4
• Package Manager: pnpm
• Linting: ESLint 9 (flat config) + next/core-web-vitals
• Formatting: Prettier 3 + tailwindcss plugin

Quick Start

# Install dependencies
pnpm install

# Run dev server
pnpm dev

# Build for production
pnpm build

# Run type check
pnpm typecheck

# Lint + format
pnpm lint
pnpm format

Multi-Agent Workflow

See AGENTS.md for the full multi-agent development rules.

Project Structure

src/
├── app/              # Next.js App Router (file-based routing)
│   ├── (site)/       # Site route group
│   └── layout.tsx    # Root layout + metadata
├── components/
│   ├── ui/           # Reusable UI primitives
│   └── layout/       # Layout components (header, footer, etc.)
├── lib/
│   ├── config/       # Site configuration
│   ├── hooks/        # Custom React hooks
│   ├── utils/        # Utility functions
│   └── api/          # API client / server actions
├── styles/
│   └── globals.css   # Tailwind + design tokens
└── types/            # Shared type definitions

docs/                 # System of record (progressive disclosure)
AGENTS.md             # Agent workflow TOC

Design Tokens

Edit src/styles/globals.css @theme block to customize per-project colors, fonts, and spacing.

Deployment

Deployed to Vercel. Connect this repo and push to main. See docs/infrastructure/deployment.md for details.