Quick-Start Guides
This series walks operators and developers through the most common Mnemose journeys, from a green-field GCP project to a fully functional platform with enrolled tenants and remote kernels.
Each guide is self-contained but assumes the previous ones have been completed where dependencies are stated. Pick the entry point that matches your role.
For platform operators
| # | Guide | Goal |
|---|---|---|
| 1 | Prerequisites | Verify host machine + GCP account readiness |
| 2 | Deploy the platform | One-shot install into a GCP project via install.sh |
| 3 | Onboard your first tenant | Register a tenant, delegate a customer cloud project |
| 4 | Provision the platform core | Verify CoreManifest health, provision missing kernels |
| 5 | Enroll a remote kernel | Install agent-kernel on a host and connect it to the broker |
For developers
| # | Guide | Goal |
|---|---|---|
| 6 | Local development | Run the full stack on your workstation |
| 7 | Add a command flow | Schema → handler → GraphQL → tests, end-to-end |
| 8 | Add a cloud adapter | Implement a port for a new cloud provider |
Reference
- Architecture — CQRS spine, ports, multi-tenancy, IAM JIT
- Cloudflare Access — Zero Trust apps, JWT verification, custom claims
- API — GraphQL schema, MCP tools, command/event catalog
- Integration — Tenant onboarding, customer cloud prerequisites
- Agent-kernel — Remote host execution substrate
- Contributing — Test strategy, commit discipline, infra changes
PROJECT.md— Full project orientation- Cloudflare-native local dev — Current-state local runtime (D1 + wrangler), bootstrap, failure modes