---
category: index
tags: [meta]
last_updated: 2026-03-14
confidence: pretty_good
---

# robot.wtf Development Wiki

Development tracking and documentation for robot.wtf — a free, volunteer-run MCP wiki service for the ATProto community.

## Active Design (robot.wtf — VPS + ATProto)

### Platform
- [[Design/VPS_Architecture]] — Architecture, auth, data model, deployment (Debian 12, Caddy, SQLite, ATProto OAuth)
- [[Tasks/VPS_Phases]] — Implementation phases V0–V7: infrastructure, port, ATProto auth, MCP OAuth, frontend, launch

### Research Wiki (single-tenant system — still current)
- [[Design/Research_Wiki]] — Overview, architecture, deployment
- [[Design/REST_API]] — Endpoints, auth, WikiLink parsing, examples
- [[Design/MCP_Server]] — Tools, configuration, return format, error handling
- [[Design/Note_Schema]] — Frontmatter schema, master index, session protocol

### Process
- [[Design/Agent_Workflow]] — Delegation model: orchestrator, managers, Groucho/Chico/Zeppo
- [[Design/Phase_Gates]] — Exit criteria and validation procedures per phase

### Dev Tracking (VPS)
- [[Dev/V3_V5_Risk_Research]] — ATProto OAuth client + MCP OAuth AS: library assessment, scope resolution, implementation sketch

---

## Archived Design (wikibot.io — AWS Serverless + Commercial)

These pages document the original AWS serverless architecture with WorkOS auth and freemium billing. The designs are superseded by [[Design/VPS_Architecture]] but preserved in full — the application logic (ACL model, middleware, MCP tools, semantic search) carries forward, and the commercial design work (pricing, Stripe integration, tier enforcement) can be revived if the project ever needs it.

### Platform
- [[Design/Platform_Overview]] — AWS Lambda + EFS + DynamoDB architecture
- [[Design/Data_Model]] — DynamoDB tables, EFS layout, URL structure
- [[Design/Auth]] — WorkOS AuthKit, OAuth, ACL model, MCP auth
- [[Design/Implementation_Phases]] — Phases 0–7, frontend screens, API surface, pricing
- [[Design/Operations]] — AWS cost model, backups, CI/CD, rate limiting
- [[Design/Frontend]] — Management SPA: URL scheme, cross-subdomain auth, framework, screens, hosting

### Optimizations (Lambda-specific)
- [[Design/CDN_Read_Path]] — Read path decoupling: fragment caching, assembly options, performance
- [[Design/Lambda_Library_Mode]] — Write path optimization: lazy loading via `sys.modules` injection

### Semantic Search (AWS pipeline)
- [[Design/Async_Embedding_Pipeline]] — DynamoDB Streams + MiniLM embedding pipeline
- [[Design/Semantic_Search]] — Original Chroma plugin design: chunking, index maintenance

### Content (still relevant for robot.wtf — tone and structure carry over)
- [[Design/Landing_Page]] — Landing page spec: content, structure, tone, logo, deliverables

### Tasks (AWS phases)
- [[Tasks/Prerequisites]] — Human setup before Phase 0
- [[Tasks/Phase_0]] — Proof of Concept (EFS + Lambda, WorkOS + MCP)
- [[Tasks/Phase_1]] — Single-User Serverless Wiki
- [[Tasks/Phase_2]] — Multi-Tenancy and Auth
- [[Tasks/Phase_3]] — Frontend
- [[Tasks/Phase_4]] — Launch Readiness
- [[Tasks/Launch_Checklist]] — Human actions required before going live
- [[Tasks/Emergent]] — Tasks arising during development
- [[Tasks/E-2_CDN_Read_Path]] — CDN read path: Option A (assembly Lambda)
- [[Tasks/E-2_CDN_Read_Path_ClientSide]] — CDN read path: Option B (client-side assembly)

### Dev Tracking (AWS implementation)
- [[Dev/Phase 0 — EFS Benchmarks]] — Track A results: cold start, read/write latency, concurrency
- [[Dev/Phase_1_Gate_Results]] — Phase 1 acceptance test results (2026-03-13)
- [[Tasks/P1-9_MCP_OAuth_Routing]] — Fix MCP OAuth discovery routing (completed)

---

## Meta
- [[Meta/Wiki_Usage_Guide]] — How agents use this wiki
0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9