Skip to content

# DAARION Cursor Tasks

Готові таски для Cursor AI / інженерів

Ця директорія містить структуровані задачі для імплементації функцій DAARION.

## 📋 Available Tasks

### 🔥 MASTER TASK: PHASE2_MASTER_TASK.md

Status: 🚀 READY TO COPY TO CURSOR
Priority: Critical
Estimated Time: 4 weeks

The complete, copy-paste-ready task for Cursor AI!

Full implementation with code examples: - agent_filter (complete Python code) - Router extension (complete code) - agent-runtime (complete code) - Docker integration

How to use:

    # Copy entire file and paste into Cursor
    cat docs/tasks/PHASE2_MASTER_TASK.md | pbcopy

### 1. TASK_PHASE2_AGENT_INTEGRATION.md

Status: 📋 Ready to implement
Priority: High
Estimated Time: 4 weeks

Goal: Повна інтеграція агентів у Messenger: - `agent_filter` service — Security & routing layer - DAGI Router extension — Message routing - `agent-runtime-service` — LLM + Memory + Posting

Deliverables: - 3 нові сервіси (agent-filter, router extension, agent-runtime) - NATS event integration (actual publishing) - Full flow: Human → agent_filter → Router → Agent Runtime → Reply

Dependencies: - Messenger Module (✅ Complete) - NATS JetStream (✅ Running) - Matrix Synapse (✅ Running)

How to use:

    # Copy entire task into Cursor
    cat docs/tasks/TASK_PHASE2_AGENT_INTEGRATION.md

    # Or work step-by-step:
    # 1) Implement agent_filter
    # 2) Extend DAGI Router
    # 3) Implement agent-runtime
    # 4) Docker-compose integration

### 2. TASK_AGENT_HUB_MVP.md

Status: 📋 Ready to implement
Priority: High
Estimated Time: 2 weeks

Goal: Створити Agent Hub — головний інтерфейс для роботи з агентами: - 3-колонковий layout (Agents | Chat | Context) - Direct channels з агентами - Reuse Messenger components - Context panel (projects, capabilities)

Deliverables: - Frontend: `/hub` route з 6 компонентами - Backend: Agent Hub API (4 endpoints) - Navigation links (Onboarding → Hub, City → Hub)

Dependencies: - Messenger Module (✅ Complete) - TASK_PHASE2_AGENT_INTEGRATION (⚠️ Recommended but not blocking for UI)

How to use:

    # Copy entire task into Cursor
    cat docs/tasks/TASK_AGENT_HUB_MVP.md

    # Or implement incrementally:
    # 1) Backend API (agents-service)
    # 2) Frontend structure
    # 3) Messenger integration
    # 4) Context panel

## 🔄 Task Workflow

### Step 1: Choose Task

Select based on priority and dependencies.

### Step 2: Review

- Read task completely
- Check dependencies
- Review acceptance criteria

### Step 3: Implement

- Copy task to Cursor
- Follow structure step-by-step
- Test each component

### Step 4: Validate

- Run acceptance criteria tests
- Update documentation
- Mark task as complete

## 📚 Related Documentation

### Core Docs

- MESSAGING_ARCHITECTURE.md — Complete technical spec
- MESSENGER_COMPLETE_SPECIFICATION.md — Master navigation
- messaging-erd.dbml — Database ERD

### Implementation Guides

- MESSENGER_MODULE_COMPLETE.md — Phase 1 summary
- MESSENGER_TESTING_GUIDE.md — Testing scenarios

## 🎯 Roadmap

    ✅ Phase 1: Messenger Core (Complete)
       - Database schema
       - messaging-service
       - matrix-gateway spec
       - Frontend UI
       - WebSocket real-time

    📋 Phase 2: Agent Integration (Next - TASK_PHASE2)
       - agent_filter service
       - DAGI Router extension
       - agent-runtime-service
       - NATS events

    📋 Phase 2.5: Agent Hub (Parallel - TASK_AGENT_HUB)
       - Agent Hub UI
       - Direct channels
       - Context panel
       - Navigation

    🔜 Phase 3: Advanced Features
       - Multi-agent coordination
       - Scheduled messages
       - Voice messages
       - Analytics

## 💡 Tips for Using Tasks

### For Cursor AI:

1. Copy entire task file
2. Paste as single prompt
3. Let Cursor work through incrementally
4. Review generated code
5. Test acceptance criteria

### For Human Developers:

1. Read task thoroughly
2. Break into sub-tasks if needed
3. Implement step-by-step
4. Cross-reference with architecture docs
5. Write tests

### For Team Leads:

1. Assign tasks based on expertise
2. Track progress via acceptance criteria
3. Review deliverables
4. Update roadmap

## 🚀 Quick Start

### To start Phase 2:

    # 1. Read task
    cat docs/tasks/TASK_PHASE2_AGENT_INTEGRATION.md

    # 2. Start with agent_filter
    cd services
    mkdir agent-filter
    cd agent-filter
    # Follow task instructions...

    # 3. Test
    docker-compose -f docker-compose.agents.yml up -d

### To start Agent Hub:

    # 1. Read task
    cat docs/tasks/TASK_AGENT_HUB_MVP.md

    # 2. Create feature structure
    mkdir -p src/features/agent-hub/{components,hooks,api}
    # Follow task instructions...

    # 3. Test
    npm run dev
    # Navigate to http://localhost:8899/hub

## 📊 Task Status

Task | Status | Progress | ETA
--- | --- | --- | ---
Messenger Core (Phase 1) | ✅ Complete | 100% | Done
Phase 2: Agent Integration | 🚀 READY | 0% | 4 weeks
Agent Hub MVP | 📋 Ready | 0% | 2 weeks
Phase 3: Core Services | 📋 Roadmap | 0% | 6-8 weeks
Projects Module | 🔜 Planned | 0% | TBD
Follow-ups Module | 🔜 Planned | 0% | TBD

## 🤝 Contributing

When adding new tasks: 1. Use existing task format 2. Include all sections (Goal, Dependencies, Deliverables, Acceptance Criteria) 3. Add to this README 4. Link to related docs 5. Update roadmap

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