Architecture decision records

Why CentraKit differs from the shared repo standard, and which migrations are deferred.

Architecture decision records (ADRs) capture choices that a future contributor could otherwise mistake for drift. Each record states the context, the decision, and the consequences.

When to add a record

Add a record when you:

Keep a deliberate deviation from the shared repo standard.
Replace a library in the one-library-per-concern list.
Add a vendor that is not a first-party Vercel product, a Vercel Marketplace integration, or a Vercel Connect connector.
Defer a standard item to a later plan.

Copy 0000-template.md, take the next free number, and add the file to meta.json.

Records

Number	Title	Status
0001	Next.js route handlers for the API and MCP	Accepted
0002	Bounded package topology	Accepted
0003	The `apps/saas` name and host-based routing	Accepted
0004	Zod until the API layer migration	Accepted
0005	Audit log naming	Accepted
0006	Env file layout	Accepted
0007	Deferred better-supabase and PermDock	Accepted
0008	CLI on citty, clack and c12	Accepted

Architecture decision records (ADRs) capture choices that a future contributor could otherwise mistake for drift. Each record states the context, the decision, and the consequences.

When to add a record

Add a record when you:

Keep a deliberate deviation from the shared repo standard.
Replace a library in the one-library-per-concern list.
Add a vendor that is not a first-party Vercel product, a Vercel Marketplace integration, or a Vercel Connect connector.
Defer a standard item to a later plan.

Copy 0000-template.md, take the next free number, and add the file to meta.json.

Records

Number	Title	Status
0001	Next.js route handlers for the API and MCP	Accepted
0002	Bounded package topology	Accepted
0003	The `apps/saas` name and host-based routing	Accepted
0004	Zod until the API layer migration	Accepted
0005	Audit log naming	Accepted
0006	Env file layout	Accepted
0007	Deferred better-supabase and PermDock	Accepted
0008	CLI on citty, clack and c12	Accepted

Architecture decision records

When to add a record

Records

On this page

Architecture decision records

When to add a record

Records

On this page

Architecture decision records

When to add a recordCopy Anchor Link

RecordsCopy Anchor Link

On this page

Architecture decision records

When to add a recordCopy Anchor Link

RecordsCopy Anchor Link

On this page

When to add a record

Records

When to add a record

Records