microdao-daarion/docs/INDEX.md

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)

   • 00_overview_microdao.md — System overview
   • 01_product_brief_mvp.md — Product requirements
   • 02_architecture_basics.md — Technical architecture
   • 03_api_core_snapshot.md — API contracts
   • MVP_VERTICAL_SLICE.md — Implementation plan

2. Agent System (08-24)

   • 12_agent_runtime_core.md — Agent Runtime Core
   • 13_agent_memory_system.md — Memory system
   • 21_agent_only_interface.md — Agent-Only Interface
   • 22_operator_modes_and_system_agents.md — System agents

3. Infrastructure (25-50)

   • 25_deployment_infrastructure.md — Deployment
   • 27_database_schema_migrations.md — Database schema
   • 34_internal_services_architecture.md — 17 services
   • 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