An agent-first TypeScript foundation
A small stack with clear doors.
Public pages in Next.js. Product work behind auth. Business rules behind one typed Hono API. Every boundary is easy for an agent to find and hard to cross by accident.
Repository map / 001
- 01SitePublic story + published articles
- 02AppSigned-in product surface
- 03APIAuth, policy + business behavior
Typed end to end
Postgres is the only local service
One command proves the checkout
02 / Working agreement
The repository explains itself.
Agents do not need a perfect memory when the code has a strong shape. Every deployable app has one job. Shared packages have one owner. Provider details stop at the boundary.
Traceable
Follow the request
UI to typed client. Typed client to API. API to policy and data.
Replaceable
Keep vendors at the edge
Authentication and PostHog sit behind small adapters instead of spreading.
Provable
Leave evidence
Focused tests answer local questions. One root gate checks the whole.
From the build notes
Decisions stay close to the code.
The first build note is being prepared.