⚑ Claude Code CLIβ€’Next.js 16 + React 19 + TypeScript

Claude Code CLI Harness Spec for Next.js 16 App Router

Production operating guidelines for Anthropic Claude Code CLI with automated build verification, strict TypeScript typing, and CSS Module patterns.

πŸ“„ CLAUDE.md
# CLAUDE.md β€” Repository Operating Guidelines for Next.js 16 App Router

> Generated via Vibe Coding Codex Harness Generator (https://vibecodingcodex.com)
> Inspired by Ryan Lopopolo's Harness Engineering (https://github.com/lopopolo/harness-engineering)

## 1. Core Architecture Principles
- **Vibe Coding Philosophy**: Never ask the user to type code manually. Produce complete, runnable code files.
- **Framework Target**: Next.js 16 App Router + React 19.
- **Strict Typing**: All code must pass `npx tsc --noEmit` without implicit any types.
- **CSS Architecture**: Use Vanilla CSS Modules or custom CSS variables (`var(--color-bg)`). Avoid inline styles.

## 2. Directory Structure Map
- `app/`: Pages, layouts, and API route handlers.
- `app/components/`: Reusable atomic React UI components.
- `app/lib/`: Business logic, database clients, and helper utilities.
- `public/`: Static assets, brand icons, and images.

## 3. Mandatory Error & Exception Handling
- All API handlers MUST return standardized JSON responses: `{ success: boolean, data?: any, error?: string }`.
- Wrap all async database operations in try/catch blocks and log tracebacks silently.

## 4. Verification Protocol
Before submitting code changes, execute:
1. Build verification: `npm run build`
2. Automated test suite: `npm test`