FormicOS Documentation

For Users

• Quick Start — local-first setup, first colony in minutes
• Operator's Guide — day-to-day operation, knowledge management
• Deployment — Docker Compose production deployment
• Runbook — operational procedures and troubleshooting

Architecture

• Architecture Overview — four-layer architecture, event sourcing
• Knowledge Pipeline — extraction, scoring, retrieval
• Knowledge Lifecycle — entry lifecycle, operator controls
• Replay Safety — event replay guarantees
• API Surface Integration — MCP, HTTP, WebSocket, A2A, AG-UI

Findings

• Key Findings -- measurement results and discoveries

Specifications (current state)

• Knowledge System
• Colony Execution
• Extraction Pipeline
• Context Assembly
• Cost Tracking
• Proactive Intelligence

Development

• Contributing
• Development Workflow -- wave cadence, delivery loop
• ADRs -- 49 architectural decision records
• GitHub Admin -- repo settings, branch protection

Reference

• Architecture Map — code-anchored architecture reference
• Knowledge Dynamics Audit
• Knowledge Curation Audit
• Knowledge Flow Audit
• Tool Dispatch Reference

Research

• Stigmergy Knowledge Substrate — knowledge-as-pheromone thesis
• OpenClaw Research Briefing
• Coordination Math Map

Wave History

The waves/ directory contains 60 wave planning documents, dispatch prompts, and decision logs. Each wave directory is self-contained project history. See waves/PROGRESS.md for the progress tracker.

Archived

• archive/ — stale documents preserved for history (handoffs, unimplemented integrations)
• internal/ — development-only artifacts (session logs, research prompts)