From 048278e46b33e488bd3498dda52d1480c88cd025 Mon Sep 17 00:00:00 2001 From: Mikkel Georgsen Date: Fri, 16 Jan 2026 14:54:30 +0000 Subject: [PATCH] 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 --- .planning/ROADMAP.md | 76 ++++++++++++++++++++++++++++++++++++++++++++ .planning/STATE.md | 57 +++++++++++++++++++++++++++++++++ 2 files changed, 133 insertions(+) create mode 100644 .planning/ROADMAP.md create mode 100644 .planning/STATE.md diff --git a/.planning/ROADMAP.md b/.planning/ROADMAP.md new file mode 100644 index 0000000..494ec09 --- /dev/null +++ b/.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 | - | diff --git a/.planning/STATE.md b/.planning/STATE.md new file mode 100644 index 0000000..2c15c3b --- /dev/null +++ b/.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