Skip to content

# DAARION Documentation Index

Quick navigation for all documentation

## 🚀 Quick Start

### For New Developers

1. PROJECT_CONTEXT.md — Project overview
2. INFRASTRUCTURE.md — Servers, ports, services
3. docs/cursor/README.md — Cursor AI documentation (72 docs)

### For Implementation

1. docs/tasks/README.md — Cursor-ready tasks ⭐
2. MESSAGING_ARCHITECTURE.md — Complete tech spec
3. MESSENGER_TESTING_GUIDE.md — Testing guide

## 📋 Cursor Tasks (New!)

Ready-to-use tasks for Cursor AI:

### Priority 1: Agent Integration

- TASK_PHASE2_AGENT_INTEGRATION.md
- 4 weeks, High priority
- agent_filter + DAGI Router + agent-runtime
- Makes Messenger agent-aware

### Priority 2: Agent Hub

- TASK_AGENT_HUB_MVP.md
- 2 weeks, High priority
- Main interface for working with agents
- Reuses Messenger components

## 🏗️ Architecture

### Core Specs

- MESSAGING_ARCHITECTURE.md — Messenger + Matrix + Agents (110+ KB)
- MESSENGER_COMPLETE_SPECIFICATION.md — Master doc
- messaging-erd.dbml — Database ERD (dbdiagram.io format)

### Technical Docs

- INFRASTRUCTURE.md — Servers, nodes, ports, services
- infrastructure_quick_ref.ipynb — Quick reference notebook

## 📚 Cursor AI Documentation (72 docs)

See: docs/cursor/README.md

### Key Documents

1. MVP & Architecture (00-07)
2. `00_overview_microdao.md` — System overview
3. `01_product_brief_mvp.md` — Product requirements
4. `02_architecture_basics.md` — Technical architecture
5. `03_api_core_snapshot.md` — API contracts

6. `MVP_VERTICAL_SLICE.md` — Implementation plan

7. Agent System (08-24)

8. `12_agent_runtime_core.md` — Agent Runtime Core
9. `13_agent_memory_system.md` — Memory system
10. `21_agent_only_interface.md` — Agent-Only Interface

11. `22_operator_modes_and_system_agents.md` — System agents

12. Infrastructure (25-50)

13. `25_deployment_infrastructure.md` — Deployment
14. `27_database_schema_migrations.md` — Database schema
15. `34_internal_services_architecture.md` — 17 services
16. `42_nats_event_streams_and_event_catalog.md` — NATS events

## 🔧 Implementation Guides

### Completed Modules

- MESSENGER_MODULE_COMPLETE.md — Phase 1 summary
- Database schema
- messaging-service
- Frontend UI
- WebSocket real-time

### In Progress

- tasks/TASK_PHASE2_AGENT_INTEGRATION.md — Agent integration
- tasks/TASK_AGENT_HUB_MVP.md — Agent Hub UI

## 🧪 Testing

### Messenger Testing

- MESSENGER_TESTING_GUIDE.md — 13 test scenarios
- Basic messaging
- Element compatibility
- Agent posting
- WebSocket
- E2EE channels

### General Testing

- cursor/07_testing_checklist_mvp.md — MVP checklist

## 📊 Data Models

### Database

- messaging-erd.dbml — Messenger ERD (paste to dbdiagram.io)
- cursor/27_database_schema_migrations.md — Full schema

### API

- cursor/03_api_core_snapshot.md — Core API
- services/matrix-gateway/API_SPEC.md — Matrix Gateway

## 🎯 Roadmap & Plans

### Current Phase

- ✅ Phase 1: Messenger Core (Complete)
- 📋 Phase 2: Agent Integration (Next)
- 📋 Phase 2.5: Agent Hub (Parallel)

### Planning Docs

- MVP_VERTICAL_SLICE.md — MVP plan
- PLAN_MODULES.md — Module plans
- ACTION_PLAN.md — Action plan

## 🔐 Security & Infrastructure

### Security

- cursor/26_security_audit.md — Security checklist
- cursor/33_api_gateway_security_and_pep.md — API security

### Infrastructure

- cursor/25_deployment_infrastructure.md — Deployment
- cursor/29_scaling_and_high_availability.md — Scaling

## 🌐 Integration Guides

### DAARION.city

- DAARION_city_integration.md — City integration
- DAARION_city_platforms_catalog.md — Platforms

### External Systems

- cursor/20_integrations_bridges_agent.md — Bridges
- cursor/40_rwa_energy_food_water_flow_specs.md — RWA

## 💰 Tokenomics

### Core Docs

- tokenomics/city-tokenomics.md — ⭐ CANONICAL
- cursor/30_cost_optimization_and_token_economics_infrastructure.md

## 📝 Quick Reference

### Files by Type

#### Configuration

- `../package.json` — Frontend dependencies
- `../vite.config.ts` — Vite config
- `../docker-compose.messenger.yml` — Messenger stack
- `../docker-compose.agents.yml` — Agent services (to be created)

#### Migrations

- `../migrations/001_create_messenger_schema.sql` — Messenger DB

#### Services

- `../services/messaging-service/` — Messaging API
- `../services/matrix-gateway/` — Matrix adapter
- `../services/city-service/` — City API
- `../services/space-service/` — Space API

#### Frontend

- `../src/features/messenger/` — Messenger UI
- `../src/features/city/` — City Dashboard
- `../src/features/space-dashboard/` — Space Dashboard
- `../src/features/onboarding/` — Onboarding

## 🔍 Search Tips

### Find by Topic

- Messenger: Search for "messaging", "Matrix", "channels"
- Agents: Search for "agent", "runtime", "LLM"
- Infrastructure: Search for "deployment", "docker", "NATS"
- Security: Search for "security", "PDP", "capabilities"

### Find by File Type

- `.md` — Documentation
- `.dbml` — Database models
- `.sql` — Migrations
- `.ipynb` — Jupyter notebooks
- `.yml` — Docker configs

## 📞 Support

### Documentation Issues

- Check cursor/README.md for navigation
- Use PROJECT_CONTEXT.md for quick context

### Implementation Help

- Start with tasks/README.md
- Review MESSAGING_ARCHITECTURE.md for technical details

Last Updated: 2025-11-24
Version: 1.1.0
Maintainer: DAARION Platform Team