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