# Roadmap: MoAI

## Overview

Build a Telegram bot where multiple AI models (Claude, GPT, Gemini) collaborate on discussions. Start with project scaffolding and tooling, add bot infrastructure, then layer in project management, single-model queries, multi-model discussions, and finally consensus/export features.

## Domain Expertise

None

## Phases

**Phase Numbering:**
- Integer phases (1, 2, 3): Planned milestone work
- Decimal phases (2.1, 2.2): Urgent insertions (marked with INSERTED)

- [ ] **Phase 1: Foundation** - Project scaffolding, tooling, database models
- [ ] **Phase 2: Bot Core** - Telegram bot setup, /help, /status (M1)
- [ ] **Phase 3: Project CRUD** - Project management commands (M2)
- [ ] **Phase 4: Single Model Q&A** - AI client abstraction, basic queries (M3)
- [ ] **Phase 5: Multi-Model Discussions** - Open mode, discuss mode, @mentions (M4, M5, M8)
- [ ] **Phase 6: Consensus & Export** - Consensus generation, markdown export (M6, M7)

## Phase Details

### Phase 1: Foundation
**Goal**: Complete project scaffolding with pyproject.toml, ruff, pre-commit, src layout, and SQLAlchemy models
**Depends on**: Nothing (first phase)
**Research**: Unlikely (established patterns)
**Plans**: TBD

### Phase 2: Bot Core
**Goal**: Working Telegram bot responding to /help and /status commands
**Depends on**: Phase 1
**Research**: Likely (python-telegram-bot async patterns)
**Research topics**: python-telegram-bot v20+ async API, Application builder, handler registration
**Plans**: TBD

### Phase 3: Project CRUD
**Goal**: Full project management via Telegram (/projects, /project new/select/delete/models/info)
**Depends on**: Phase 2
**Research**: Unlikely (standard CRUD with established patterns)
**Plans**: TBD

### Phase 4: Single Model Q&A
**Goal**: Query a single AI model through the bot with abstracted AI client layer
**Depends on**: Phase 3
**Research**: Likely (external AI API integration)
**Research topics**: Requesty API documentation, OpenRouter API, async HTTP patterns with httpx/aiohttp
**Plans**: TBD

### Phase 5: Multi-Model Discussions
**Goal**: Open mode (parallel), discuss mode (sequential rounds), and @mention direct messages
**Depends on**: Phase 4
**Research**: Unlikely (builds on Phase 4 AI client patterns)
**Plans**: TBD

### Phase 6: Consensus & Export
**Goal**: Consensus generation from discussions and markdown export
**Depends on**: Phase 5
**Research**: Unlikely (internal patterns, markdown generation)
**Plans**: TBD

## Progress

**Execution Order:**
Phases execute in numeric order: 1 → 2 → 3 → 4 → 5 → 6

| Phase | Plans Complete | Status | Completed |
|-------|----------------|--------|-----------|
| 1. Foundation | 2/TBD | In progress | - |
| 2. Bot Core | 0/TBD | Not started | - |
| 3. Project CRUD | 0/TBD | Not started | - |
| 4. Single Model Q&A | 0/TBD | Not started | - |
| 5. Multi-Model Discussions | 0/TBD | Not started | - |
| 6. Consensus & Export | 0/TBD | Not started | - |