Guide to all documentation in the REPLOID project.
- /README.md - Project overview, quick start, RSI concepts
- docs/QUICK-START.md - Detailed setup and first run
- docs/CONFIGURATION.md - Connection modes and boot configuration
- docs/system-architecture.md - Complete system design
- ./self/blueprints/ - Architectural specifications (216+ files)
Key Blueprints:
- 0x000002 - Application Orchestration - Boot and DI
- 0x000008 - Agent Cognitive Cycle - Core loop
- 0x000040 - Verification Manager - Safety checks
- 0x000049 - HITL Controller - Human oversight
- 0x00003C - Genesis Snapshot - Rollback system
- 0x000031 - Swarm Orchestration - Multi-agent
- 0x000112 - RGR - Recursive GEPA Ring with validator quarantine, audit anchors, Pareto archive, and gated self-improvement
- docs/substrate.md - Substrate + Ouroboros contract
- docs/API.md - Module API documentation
- docs/browser-inference-pool.md - Poolday docs/internal contract for the public Reploid browser inference surface
- docs/poolday/claims-and-nonclaims.md - Poolday claim boundary
- docs/poolday/threat-model.md - Poolday adversaries, trust boundaries, and evidence
- docs/poolday/receipt-schema.md - Provider receipts and requester acceptances
- docs/poolday/receipt-backed-retrieval.md - Target strategy for receipt-backed embeddings, retrieval, reranking, and vector memory
- docs/poolday/p2p-envelope-protocol.md - Signed peer envelope contract
- docs/poolday/reputation-ledger.md - Event-sourced reputation reducer contract
- docs/multi-model-evaluation.md - Multi-model evaluation harness
- docs/intent-bundle-lora.md - Intent bundle LoRA workflow
- docs/CONFIGURATION.md - Boot UI settings and localStorage keys
- docs/local-models.md - WebLLM and Ollama setup
- docs/style-guide.md - Code and UI conventions
- docs/SECURITY.md - Security model and containment layers
reploid/
├── self/ # Browser application and public root
│ ├── index.html # Entry point
│ ├── entry/seed-vfs.js # VFS hydration compatibility shim
│ ├── entry/start-app.js # Bootstrapper compatibility shim
│ ├── sw-module-loader.js # Service worker for VFS modules
│ │
│ ├── host/ # VFS seeding and runtime handoff
│ ├── kernel/ # Immutable boot shell
│ ├── capsule/ # Capsule UI
│ │
│ ├── core/ # Core substrate
│ │ ├── agent-loop.js # Cognitive cycle (Think -> Act -> Observe)
│ │ ├── vfs.js # Virtual filesystem (IndexedDB)
│ │ ├── llm-client.js # Multi-provider LLM abstraction
│ │ ├── tool-runner.js # Dynamic tool loading/execution
│ │ └── verification-manager.js # Pre-flight safety checks
│ │
│ ├── infrastructure/ # Support services
│ │ ├── event-bus.js # Pub/sub event system
│ │ ├── di-container.js # Dependency injection
│ │ ├── hitl-controller.js # Human-in-the-loop oversight
│ │ └── audit-logger.js # Execution logging
│ │
│ ├── capabilities/ # Extended capabilities
│ │ └── communication/ # Swarm sync, WebRTC transport
│ │
│ ├── tools/ # Agent tools (CamelCase)
│ │
│ ├── config/ # Configuration
│ │ └── genesis-levels.json # Module/worker/role definitions
│ │
│ ├── blueprints/ # Architectural specifications
│ │ └── (216+ design docs)
│ │
├── tests/ # Test suites
│
├── docs/ # Human-facing documentation
└── server/ # Proxy server
- README.md - Understand REPLOID
- QUICK-START.md - Get running
- CONFIGURATION.md - Configure connections
- system-architecture.md - Understand architecture
- blueprints/README.md - Study specifications
- API.md - Learn module APIs
- tools/README.md - Tool development
- README.md - Core RSI thesis
- blueprints/0x000015-dynamic-tool-creation.md - Tool creation
- blueprints/0x00005B-recursive-goal-decomposition.md - Recursive goal decomposition
- blueprints/0x000112-recursive-gepa-ring.md - Recursive GEPA Ring whole-system recursive improvement blueprint
- SECURITY.md - Security model and containment
- blueprints/0x000040-verification-manager.md - Verification and sandbox design
- blueprints/0x00005C-circuit-breaker-pattern.md - Failure containment
Key Files:
./self/config/genesis-levels.json- Module registry and worker types./self/entry/seed-vfs.js- VFS hydration compatibility shim./self/entry/start-app.js- Application bootstrap compatibility shim./self/index.html- Entry point
Key Directories:
./self/- Agent substrate modules and public web root./self/tools/- Dynamic agent tools./self/infrastructure/- Support services./self/ui/- Proto UI./self/blueprints/- Architectural specificationsdocs/- Human-facing documentation. Internal module system invariants and migration checklist live in the private wrapper repo.
External Links:
- DOPPLER - WebGPU inference engine (separate repo)
Last updated: March 2026