category: index
tags: [meta]
last_updated: 2026-03-20
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.

Platform Design

Architecture

• Design/VPS_Architecture — Architecture, auth, data model, deployment (Debian 12, Caddy, SQLite, ATProto OAuth)
• Design/Platform_Overview — Multi-tenancy model, routing, handler types, semantic search
• Design/Resolver — TenantResolver WSGI middleware: request flow, storage/DB swap, auth, access restrictions
• Design/Per_Wiki_Database — Per-wiki SQLite databases: isolation, migration, backup
• Design/Data_Model — Data model: tables, filesystem layout, URL structure
• Design/Server_Consolidation — Consolidating platform services

Auth

• Design/Auth — ATProto OAuth, MCP OAuth 2.1, bearer tokens, ACL model
• Design/Admin_Panel_Reenablement — Re-enabling Otterwiki admin panel under multi-tenancy

Operations

• Design/Operations — Bootstrap template, attachments, git remote, backups, rate limiting
• Design/Git_HTTP_Access — Git HTTP access: auth, security
• Design/Wiki_Stats_Plugin — Disk usage / quota tracking plugin
• Design/E2E_Testing — Playwright E2E testing infrastructure
• Design/Custom_Domains — Custom domain support via Caddy

Frontend

• Design/Frontend — Management SPA: URL scheme, cross-subdomain auth, screens
• Design/Landing_Page — Landing page spec: content, structure, tone
• Design/Dashboard_Visibility_Toggle — Wiki visibility toggle UX

Semantic Search

• Design/Semantic_Search_V2 — Current design: section-aware chunking, FAISS + MiniLM, lifecycle hooks
• Tasks/Semantic_Search_Architecture — Architecture decisions (implemented)
• Tasks/Semantic_Search_Multi_Tenant — Multi-tenant FAISS via BackendRegistry (implemented)

Future / Deferred

• Design/E-3_Encryption_Spike — Client-side encryption spike: feasibility, tradeoffs
• Tasks/Disk_Usage_Cap — Per-wiki disk usage limits

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

Minsky (Multi-Agent Coordination)

• Minsky/Agent_IRC_Architecture — Multi-agent coordination over IRC: transport, conversational IPC, agent naming
• Minsky/Directed_Message_Routing — Supervisor-directed message routing
• Minsky/IRC_MCP_Bridge — FastMCP server wrapping IRC as MCP tools

Tasks

• Tasks/VPS_Phases — Implementation phases V0–V7 (V0–V6 complete, V7 partial)
• Tasks/Emergent — Emergent tasks arising during development
• Tasks/MCP_Wiki_Routing — MCP wiki routing bug

Dev Tracking (VPS)

• Dev/VPS_Deployment_Progress — Overall VPS deployment progress
• Dev/V3_V5_Risk_Research — ATProto OAuth + MCP OAuth AS: library assessment, risk
• Dev/V3_ATProto_Auth_Summary — V3 ATProto auth implementation
• Dev/VS-1_ATProto_Spike — ATProto OAuth spike results
• Dev/VS-2_MCP_OAuth_Summary — MCP OAuth AS spike results
• Dev/V1_SQLite_Port_Summary — V1 SQLite port from DynamoDB
• Dev/V1-3_Deployment_Summary — V1 deployment summary
• Dev/V6-1_Landing_Page_Summary — V6 landing page implementation
• Dev/V7_Ops_Hardening — V7 ops hardening notes
• Dev/2026-03-16_Beta_User_TLS_Fix — Beta user TLS certificate fix
• Dev/Proxmox_CPU_Type — Proxmox CPU type for numpy/ONNX
• Dev/Underscore_Filenames — Otterwiki fork: underscore filename convention

Process

• Design/Implementation_Workflow — Design/implementation pipeline: orchestrator, managers, agents
• Security/OWASP_2025_Audit — OWASP Top 10 security audit

Archive

AWS Design (wikibot.io — Lambda/EFS/DynamoDB)

Preserved at Archive/AWS_Design/ — 9 pages covering the original serverless architecture, cold start benchmarks, CDN caching, and phase gates.

AWS Tasks (wikibot.io phases)

Preserved at Archive/AWS_Tasks/ — 11 pages covering Phases 0–4, prerequisites, launch checklist, and MCP OAuth routing fixes.

AWS-era Dev Summaries

Phase 1–2 implementation summaries (Dev/P1-, Dev/P2-, Dev/Phase_1_*) remain in Dev/ for git history context but are not actively maintained.

Archived Design (still in Design/)

• Design/Semantic_Search — Original Chroma plugin design (superseded by V2)
• Design/Async_Embedding_Pipeline — DynamoDB Streams embedding pipeline (AWS-specific)
• Design/P2-Username_Summary — Phase 2 username routing (AWS-era)

Meta

• Meta/Wiki_Usage_Guide — How agents use this wiki
• Dev/Claude_Code_Memory_Backup — Canonical memory snapshot