# 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)

- [x] **Phase 1: Foundation** - Project scaffolding, tooling, database models
- [x] **Phase 2: Bot Core** - Telegram bot setup, /help, /status (M1)
- [x] **Phase 3: Project CRUD** - Project management commands (M2)
- [x] **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**: 3 (01-01 scaffolding, 01-02 models, 01-03 database & tests)
**Completed**: 2026-01-16

### 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**: 2 (02-01 infrastructure, 02-02 help/status commands)
**Completed**: 2026-01-16

### 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**: 3 (03-01 service & list/create, 03-02 select/info, 03-03 delete/models)
**Completed**: 2026-01-16

### 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**: 2 (04-01 AI client, 04-02 /ask command)
**Completed**: 2026-01-16

### 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**: 4 (05-01 discussion service, 05-02 open mode, 05-03 discuss mode, 05-04 mentions)

### 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 | 3/3 | Complete | 2026-01-16 |
| 2. Bot Core | 2/2 | Complete | 2026-01-16 |
| 3. Project CRUD | 3/3 | Complete | 2026-01-16 |
| 4. Single Model Q&A | 2/2 | Complete | 2026-01-16 |
| 5. Multi-Model Discussions | 2/4 | In progress | - |
| 6. Consensus & Export | 0/TBD | Not started | - |