Instructions
- Determine whether the user wants an app deployment, local development, data-backup operation, or read-only architecture guidance. Inspect the pinned release/source and deployed config path before acting.
- The README documents
docker compose --profile app up -d; it exposes the app on localhost:1516 and initializes a public knowledge base on first account registration. This is an example only. Do not deploy, start services, register accounts, or change database/config state without explicit approval. - Treat ingestion, extraction, model calls, database mounts, MCP writes, migrations, backup/restore, and public deployment as separate approval gates. Confirm data classification, target base/database, provider, cost, and destination before any external transfer or mutation.
- Preserve the app's review boundary: uncertain facts and agent write proposals require human adjudication. Do not claim an MCP connection can write directly unless source/docs for the exact operation support it.
Examples
- “Explain Utopia's bitemporal model and what its audit ledger retains.”
- “Plan a local Docker deployment, but do not start it.”
- “Configure a read-only MCP client for one knowledge base.”
Best practices
- The first registered account becomes system administrator, and the initial knowledge base is public in the documented quick start; flag this before signup and verify current deployment settings.
- Keep secrets out of chat and reports. Utopia reads
UTOPIA_environment configuration;secret.keyprotects stored credentials and must not be bundled casually with data backups. - Read
references/upstream.mdfor backup/restore caveats, exact commands and deployment scope. Exampledown -vis destructive and must never be run without explicit approval.
References
references/upstream.md- app setup, config, CLI/backups, limits, license and approval gates.references/source.json- selected pinned file SHA256s; not a whole-revision attestation.evals/evals.json- authored routing and boundary scenarios, not executed model-quality tests.