Initial commit: VoIdeaAI - voice-first AI idea assistant

2026-05-13 12:51:42 +03:00
commit 688d043dad
421 changed files with 47915 additions and 0 deletions
@@ -0,0 +1,141 @@
+# Поэтапный план взросления проекта
+
+Проект не строится сразу целиком. Он проходит этапы — от прототипа до саморазвивающейся системы.
+Агенты живут с первого коммита. Новые агенты добавляются когда возникает потребность.
+
+---
+
+## Stage 0: Foundation — Ядро
+
+**Начинаем здесь.** Проект только родился.
+
+### Код
+- FastAPI + SQLite + базовая auth
+- Минимальный набор правил (00-rules.md)
+- Базовые CRUD endpoints
+- Pydantic схемы на все входы
+
+### Агенты (создаются в первую очередь)
+- **DocAgent** — пишет документацию параллельно с кодом
+- **AuditAgent** — проверяет каждый коммит на правила
+- **EvolutionAgent** — версионирует агентов
+- **SupervisorAgent** — следит за всеми агентами
+
+### Инфраструктура
+- SQLite (aiosqlite)
+- Прямой вызов фоновых задач (без Celery)
+
+### До Stage 1
+Сразу после того, как есть первый endpoint и auth.
+
+---
+
+## Stage 1: Growth — Рост
+
+Проект обрастает функциональностью.
+
+### Добавляемый код
+- Полноценные сервисы
+- Интеграции (AI провайдеры)
+- Фронтенд (если нужен)
+- Тесты
+
+### Добавляемые агенты
+- **QATesterAgent** — когда появились тесты (авто-проверка покрытия)
+- **FixAgent** — когда пойман первый баг (анализ ошибок)
+- **BacklogAgent** — когда появился техдолг (управление TODO/FIXME)
+
+### Инфраструктура
+- Те же SQLite + прямой вызов
+- Тестовое покрытие > 50%
+
+### До Stage 2
+Перед первым production-релизом.
+
+---
+
+## Stage 2: Production-ready
+
+Проект готов к реальным пользователям.
+
+### Добавляемый код
+- PostgreSQL + asyncpg
+- Redis + Celery для фоновых задач
+- Мониторинг (health + метрики)
+- Полная документация
+
+### Добавляемые агенты
+- **SecurityAgent** — проверка конфигов, зависимостей
+- **SpecAgent** — управление версией проекта, CHANGELOG
+- **RolloutAgent** — постепенное развёртывание
+
+### Инфраструктура
+- PostgreSQL
+- Redis + Celery worker
+- CI/CD (lint → test → build → deploy)
+- SSL (Let's Encrypt)
+- .env для production + staging
+
+### До Stage 3
+После запуска, когда появились первые пользователи и метрики.
+
+---
+
+## Stage 3: Autonomous — Саморазвитие
+
+Проект начинает развиваться самостоятельно.
+
+### Добавляемый код
+- Metrics middleware
+- Prometheus/Grafana (или встроенные метрики)
+- Agent report dashboard
+- Self-healing механизмы
+
+### Добавляемые агенты
+- **ObserverAgent** — сбор метрик использования
+- **UITestAgent** — визуальное тестирование (если есть UI)
+
+### Инфраструктура
+- A/B тестирование
+- Auto-scaling (при необходимости)
+- Автоматический откат при росте ошибок
+
+### До Stage 4
+Когда > 1000 пользователей или > 3 разработчиков.
+
+---
+
+## Stage 4: Evolution — Эволюция
+
+Проект развивается автономно.
+
+### Уровень саморазвития
+- Агенты не только предлагают, но и применяют изменения
+- EvolutionAgent принимает решения о рефакторинге
+- FixAgent применяет исправления (с PR на ревью)
+- ObserverAgent на основе метрик предлагает roadmap
+
+### Инфраструктура
+- Полный мониторинг с алертами
+- Автоматическое масштабирование
+- Disaster recovery plan
+- Postmortem культура
+
+---
+
+## Сводная таблица
+
+| Stage | БД | Задачи | Агентов | Тесты | Мониторинг | Саморазвитие |
+|-------|----|--------|---------|-------|-----------|-------------|
+| 0 | SQLite | Прямой | 4 | > 20% | Нет | Reactive |
+| 1 | SQLite | Прямой | 7 | > 50% | Нет | Reactive |
+| 2 | PostgreSQL | Celery | 9 | > 80% | Базовый | Reactive |
+| 3 | PostgreSQL | Celery | 11 | > 80% | Prometheus | Proactive |
+| 4 | PostgreSQL | Celery | 11+ | > 90% | Full | Autonomous |
+
+---
+
+## [ASK] На каком вы этапе?
+
+Оцените текущее состояние проекта и выберите целевой этап.
+Рекомендация: начинайте со Stage 0, не прыгайте через этапы.