---
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/]] — 11 pages covering the original serverless architecture, cold start benchmarks, CDN caching, phase gates, and superseded designs.

### 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.

### Other
- [[Design/P2-Username_Summary]] — Phase 2 username routing (portable; kept for routing pattern reference)

## Meta
- [[Meta/Wiki_Usage_Guide]] — How agents use this wiki
- [[Dev/Claude_Code_Memory_Backup]] — Canonical memory snapshot
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