​
CLAUDE.md

This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.

​
Project Overview

This is the documentation site for Atlas by Tempest - a Distributed Multi-Agent Runtime that serves as an operating system for AI agents. The documentation is built using Mintlify, a documentation framework that renders MDX files.

​
About Atlas

Atlas is an enterprise-ready platform for orchestrating multiple AI agents to collaborate on complex tasks. Key features include:
  • Hierarchical agent supervision with LLM-enabled analysis
  • Protocol abstraction (MCP, REST, future: ACP, GraphQL, gRPC)
  • Worker isolation for security and stability
  • Comprehensive memory management (episodic, semantic, procedural)
  • Signal-driven workflows triggered by CLI, webhooks, timers, or schedules
The main Atlas codebase is located at /Users/kenneth/tempest/atlas.

​
Common Development Commands

Since this is a Mintlify project, use these commands: 
# Install Mintlify CLI globally (if not already installed)
npm i -g mintlify

# Start local development server
mintlify dev

# Deploy to production
mintlify deploy

​
High-Level Architecture

This is a Mintlify documentation site with a simple structure:
  • docs.json: Main configuration file controlling navigation, theming, and integrations
  • MDX files: Documentation content written in MDX format with frontmatter metadata
  • logo/: Brand assets for light and dark themes
  • style.css: Custom CSS overrides for Mintlify’s default styling

​
Key Configuration Points

  1. Navigation Structure (docs.json:11-26): The site uses an anchor-based navigation with groups. Currently only has “Documentation” anchor with a “User Guide” group.
  2. Theming (docs.json:3-10): Uses “mint” theme with primary color #1A53CC and supports dark/light modes.
  3. Versioning (docs.json:57-69): Configured for alpha/beta versions, both pointing to the same production URL.

​
Content Development Patterns

When creating or editing documentation:
  1. MDX Files: Use frontmatter for metadata (title, description, mode). The mode: wide option provides more content width.
  2. Components: Mintlify provides built-in components like <CardGroup> and <Card> for creating interactive layouts.
  3. Images: Place images in a dedicated images folder and reference them with standard markdown/MDX syntax.

​
Current State Notes

  • The site is in early development with placeholder content
  • index.mdx still contains Mintlify’s default template content
  • quickstart.mdx has minimal content
  • Two empty pages exist: contact-us.mdx and download.mdx

​
Atlas Codebase Context

When documenting Atlas features, refer to the main codebase at /Users/kenneth/tempest/atlas for understanding only. IMPORTANT: Do NOT edit any files in the Atlas codebase - only use it as reference for creating documentation. Key concepts to document:
  1. Architecture: WorkspaceRuntime → WorkspaceSupervisor → SessionSupervisor → Agents
  2. Core Components: Daemon (atlasd), CLI, TUI, REST API, MCP Gateway
  3. Configuration: workspace.yml, jobs, signals, agents
  4. Memory Model: Hierarchical memory with episodic, semantic, and procedural types
  5. Protocol Support: MCP (current), REST API, future protocols via adapters