Files
2026-11-01 17:24:44 +07:00

2.2 KiB

Data layer — start here

This file plus drizzle/crud-action-example.ts is all you need to add a table and wire CRUD. You do not need the storing-data, actions, or agent-native-docs skills for standard CRUD, and you do not need to search node_modules or read any dist/*.d.ts to discover the API — the pattern is already stubbed in the files below.

The files are already here

What Path State
App tables drizzle/schema.ts Stub — add tables here
DB client server/db.ts → getDb(), schema Stub — uncomment to enable
CRUD pattern drizzle/crud-action-example.ts Copy into actions/<name>.ts
Migrate pnpm db:generate → pnpm db:migrate drizzle.config.ts ships
Actions actions/<name>.ts You create these

Open server/db.ts and drizzle/schema.ts and edit them in place. Do not find / cat over node_modules/@agent-native or drizzle-orm, and do not read dist/*.d.ts — everything you need is in the two stub files.

Enable the data layer (once)

drizzle-orm, drizzle-kit, drizzle.config.ts, and the pnpm db:generate / pnpm db:migrate scripts already ship — do not re-add them.

  1. Add a table to drizzle/schema.ts (an example is commented in the file).
  2. Uncomment the wiring in server/db.ts.
  3. Run pnpm db:generate to create the migration, then pnpm db:migrate to apply it.
  4. Copy the CRUD pattern from drizzle/crud-action-example.ts into actions/<name>.ts. One action per file, default-exported — the four export const ...Example blocks in that reference each become their own actions/<name>.ts (e.g. listNotesExample → actions/list-notes.ts with export default); the kebab-case filename is the action name. Don't paste them into one file as named exports.

After a batch of schema/action edits

One smoke path (create + list), then one pnpm typecheck. See Verification in DEVELOPING.md.