docs: initialize MoAI roadmap (6 phases)

Multi-AI collaborative brainstorming platform - Telegram POC

Phases:
1. Foundation: Project scaffolding, tooling, database models
2. Bot Core: Telegram bot setup, /help, /status
3. Project CRUD: Project management commands
4. Single Model Q&A: AI client abstraction, basic queries
5. Multi-Model Discussions: Open mode, discuss mode, @mentions
6. Consensus & Export: Consensus generation, markdown export

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

.planning/ROADMAP.md

@@ -0,0 +1,76 @@
+# 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 | 0/TBD | Not started | - |
+| 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 | - |

.planning/STATE.md

@@ -0,0 +1,57 @@
+# Project State
+
+## Project Reference
+
+See: .planning/PROJECT.md (updated 2026-01-16)
+
+**Core value:** Get richer, more diverse AI insights through structured multi-model discussions—ask a team of AIs instead of just one.
+**Current focus:** Phase 1 — Foundation
+
+## Current Position
+
+Phase: 1 of 6 (Foundation)
+Plan: Not started
+Status: Ready to plan
+Last activity: 2026-01-16 — Project initialized
+
+Progress: ░░░░░░░░░░ 0%
+
+## Performance Metrics
+
+**Velocity:**
+- Total plans completed: 0
+- Average duration: —
+- Total execution time: 0 hours
+
+**By Phase:**
+
+| Phase | Plans | Total | Avg/Plan |
+|-------|-------|-------|----------|
+| — | — | — | — |
+
+**Recent Trend:**
+- Last 5 plans: —
+- Trend: —
+
+## Accumulated Context
+
+### Decisions
+
+Decisions are logged in PROJECT.md Key Decisions table.
+Recent decisions affecting current work:
+
+(None yet)
+
+### Deferred Issues
+
+None yet.
+
+### Blockers/Concerns
+
+None yet.
+
+## Session Continuity
+
+Last session: 2026-01-16
+Stopped at: Project initialization complete
+Resume file: None