Infrastructure Registry¶
Single source of truth for all Dashecorp/Invotek infrastructure. Every host, agent, credential, and service documented in one place.
Owner: Claude-3 (orchestrator). Executors submit PRs to update.
Files¶
| File | What it covers |
|---|---|
| hosts.md | Every physical/virtual host: IP, OS, location, role, how to SSH/VNC |
| agents.md | Every AI agent: where it runs, runtime, model, auth, capabilities |
| networking.md | Tailscale mesh, SSH keys, VNC, Cloudflare domains, Workers, DNS |
| github.md | 3 orgs, all repos, runners, GitHub Apps, Dependabot |
| apps.md | iOS/Android apps: store status, bundle IDs, versions, subscriptions |
| mcp-servers.md | All MCP servers: custom, third-party, cloud, restart procedures |
| kubernetes.md | GCP k3s cluster, FluxCD, rig-conductor + rig-planner + agent pods (ARC k3s runners retired 2026-05-20) |
| ci-cd.md | Workflows, runner routing, Discord notifications, auto-merge, releases |
| xcode-cloud.md | iOS build & distribution — GitHub Actions (build-and-upload); Xcode Cloud retired |
| websites.md | Cloudflare Pages projects, domains, deployment commands |
| credentials.md | Credential inventory (Bitwarden names only), expiry, rotation |
| diagram.md | ASCII architecture diagram — the big picture |
| approved-tools.md | Security-reviewed tools that agents can install without additional approval |
| devops-flow.md | Full CI/CD pipeline, PR lifecycle, and notification architecture |
| discord-bots.md | Discord bot configuration, intents, permissions, Bitwarden entries, recreation guide |
| issue-workflow.md | GitHub issue workflow, agent assignment, rig-conductor / rig-planner coordination |
| mac-fleet.md | macOS runner fleet management (iBuild-E, OpenTofu, SOPS, drift detection) |
| troubleshooting.md | Common errors, fixes, and escalation paths for agent infrastructure |
How to Use¶
Agents: Read the relevant file when you need infrastructure context. At session start, diagram.md gives the overview; drill into specific files as needed.
When to update: If you change infrastructure (add a host, deploy a worker, rotate a credential), update the relevant file on your feature branch. This is mandatory, same as updating CLAUDE.md.
Last Updated¶
See git log for per-file update history.