1 min read · 247 words
Guides
How-to recipes for the three most common extensions. Each one walks the full stack and calls out the contracts you must not break.
[Add an Endpoint](add-an-endpoint.md)Schema → handler → observability logging → frontend proxy — a new API route end to end, using the house patterns.Add an Endpoint
[Add a Tool](add-a-tool.md)A fifth agent tool from ID to UI checkbox, with gating, logging, and both enforcement styles explained.Add a Tool
[Add a Migration](add-a-migration.md)Adding a column to an existing table without breaking every existing dev database.Add a Migration
The contracts every extension must respect
- Observability — every automated step logs a
ToolCall; pipelines trace withWorkflowRun/WorkflowStep. - Tool gating — tool-bearing endpoints check
agent_has_tooland 403. - Migration rule — new columns on existing tables get a startup-migration entry.
- Frontend proxy — browser-initiated calls go through
app/api/**/route.ts. - Design tokens — new UI uses the token classes.
Prerequisites
You can run both servers (Installation) and you've skimmed the Backend Overview layering rules. For deeper learning paths, see Tutorials — guides assume you want to ship something, tutorials assume you want to understand something.