This directory keeps project documentation grouped by purpose. Keep runtime and API references in the numbered root docs, and put product-specific material under product/.

• 00 Architecture Overview
• 25 Technical Architecture
• 01 Agent Loop
• 03 Tools System
• 06 Store Data Model
• 23 Multi-tenant Architecture
• 24 Knowledge Vault

• 18 HTTP API
• 19 WebSocket RPC
• OpenAPI for Apifox

• Closy

• Packages and GitHub Releases
• TTS Provider Capabilities
• Agent Hooks
• Agent Identity Conventions

• cmd/: CLI entrypoints and gateway startup wiring.
• internal/: private Go packages for runtime, stores, HTTP, WebSocket, tools, memory, channels, and providers.
• pkg/: public Go packages.
• ui/web/: React management UI.
• ui/desktop/: desktop shell and frontend.
• migrations/: database migrations.
• deploy/compose/: Docker Compose base files, overlays, modules, and selectable options.
• deploy/docker/: Dockerfiles, entrypoint, and image dependency manifests.
• deploy/options/: deployment tuning snippets that are not part of the default compose set.
• scripts/: install, setup, and maintenance scripts.
• skills/: bundled skill packages.
• tests/: contract, integration, invariant, and scenario tests.

When reorganizing code directories, move one boundary at a time and update imports, Docker/compose paths, scripts, docs, and tests in the same change.