mikkel/moai
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions
moai/.planning/ROADMAP.md
Mikkel Georgsen 4d8c66ee07 docs(03-01): complete project service & list/create plan 
Tasks completed: 2/2
- Create project service module
- Implement /projects and /project new handlers

SUMMARY: .planning/phases/03-project-crud/03-01-SUMMARY.md

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-16 18:39:29 +00:00

3.1 KiB
Raw Blame History

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

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