data-model-changes
Installation
SKILL.md
Data Model Change Guide
Comprehensive guidance for making changes to the data model (database schema, validation, types, and data access layer) in the Inkeep Agent Framework.
Database Architecture
The framework uses two separate PostgreSQL databases:
| Database | Config File | Schema File | Purpose |
|---|---|---|---|
| Manage (Doltgres) | drizzle.manage.config.ts |
src/db/manage/manage-schema.ts |
Versioned config: projects, agents, tools, triggers, evaluators |
| Runtime (Postgres) | drizzle.run.config.ts |
src/db/runtime/runtime-schema.ts |
Transactional data: conversations, messages, tasks, API keys |
Key Distinction:
- Manage DB: Configuration that changes infrequently (agent definitions, tool configs). Supports Dolt versioning.
- Runtime DB: High-frequency transactional data (conversations, messages). No cross-DB foreign keys to manage tables.