ARC // OS Documentation
Last Updated: 2026-08-18
Documentation Structure
This documentation is organized into three main categories:
📖 User Documentation
Documentation for end users of ARC // OS:
- Getting Started - User guide plus Public API, webhooks, and MCP
- Admin Guide - Guide for platform administrators
- Introduction - Welcome and overview
👨💻 Developer Documentation
Documentation for developers working on ARC // OS:
- Developer README - Coding standards, architecture, and development guide
- Architecture - System architecture and design decisions
- Testing - Testing requirements and standards
- Deployment - Production deployment guides
- Security - Security documentation
- Project Management - TODO list and project management
🔌 API Documentation
- API reference — session, public, Brain, webhooks, MCP
- Endpoint catalog — every HTTP method + path
- Public API + Brain forms — integrator guide
📢 Marketing
Marketing and SEO documentation
📚 Features
Feature documentation (implementation details)
Quick Links
For Users:
For Developers:
- Developer README - START HERE - Coding standards, architecture, testing requirements
- Architecture
- Testing Requirements
- Deployment Guide
For API Integrations:
- Public API (user guide)
- Outgoing webhooks (user guide)
- MCP (user guide)
- API reference
- HTTP endpoint catalog
- Claude MCP internals
- Brain
Documentation Visibility
Public (Visible to All)
user/- All user-facing documentationapi/API_DOCUMENTATION.mdandapi/ENDPOINTS.md- API reference and catalogmarketing/- Marketing contentfeatures/- Feature descriptions
Developer Only (Hidden from Public)
developer/- All developer-facing documentation
Note: In production, developer documentation should be hidden from the global public, except for the public API and webhook documentation which should remain accessible.
Contributing to Documentation
When updating documentation:
- User docs → Update files in
user/ - Developer docs → Update files in
developer/ - API docs → Update
api/API_DOCUMENTATION.mdand regenerateapi/ENDPOINTS.mdwhen routes change - Features → Update files in
features/