Agentic Site — Project Notes

A frontend-first website platform where users edit live on the page via an AI agent, with no traditional CMS UI. Next.js + Vercel + TypeScript.

Build

The working V1 codebase lives at ~/Projects/agentic-site/. This directory is planning artifacts and provenance only — all code, commits, and the canonical in-repo PRD copy live in the build directory.

Location	What's there
`~/Projects/agentic-site/`	Next.js build. 4 commits on `main`. Runs end-to-end in mock mode. `docs/PRD.md` is the canonical spec, `QUESTIONS.md` tracks open credentials/decisions.
GitHub	grainandmortar/agentic-site (private)
`~/.claude/project-notes/agentic-site/` (this dir)	Planning artifacts: original ChatGPT draft, refined V1 PRD, timeline below.

Files

File	Purpose
AGENTIC-SITE-V1-PRD.md	Working V1 PRD. Refined 2026-04-08. Supersedes the ChatGPT draft. Also copied to `~/Projects/agentic-site/docs/PRD.md` as the canonical in-repo spec.
agentic_website_system_v_1_prd.md	Original ChatGPT draft. Kept for provenance. Do not edit.

Status

2026-04-08 — ChatGPT draft reviewed, challenged, and rewritten into AGENTIC-SITE-V1-PRD.md. Three-pillar structure (Talk / Ask / Ship). MCP deferred to v1.1 but architecture built MCP-ready from day one.
2026-04-08 — All planning-phase decisions ratified. Pilot is Tailwind Cellars, a fictional winery derived from the Soaring Wings WordPress theme. Full stack locked: Next.js App Router + TS strict + Tailwind v4 + Vercel Postgres + Drizzle + Auth.js + Claude + PostHog. Cost metering built into V1 data model, billing is a V2 feature. PRD is ready for implementation planning.
2026-04-08 — V1 scaffold built and shipped in 4 atomic commits to ~/Projects/agentic-site/. Editor (click-to-edit + chat-first), 7 module components + dispatcher, Zod schemas, patch protocol, scoped AI context assembler, Claude wrapper with smart mock mode, /setup Site Brain wizard, Drizzle migration, in-memory + DB-backed content store with runtime switch, 25 unit tests passing, clean production build. Runs end-to-end without Postgres or an Anthropic key via mock/dev bypass. Open blockers (credentials + decisions) tracked in the build's QUESTIONS.md.