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,97 @@
+# Версионирование
+
+## Формат: SemVer
+
+```
+MAJOR.MINOR.PATCH
+```
+
+- **MAJOR**: несовместимые изменения API
+- **MINOR**: новая функциональность (обратно совместимо)
+- **PATCH**: исправления багов
+
+## CHANGELOG
+
+**Где хранить:** `CHANGELOG/`
+
+**Правила:**
+- Каждая MAJOR версия → новый файл: `CHANGELOG/v1.0.md`
+- Каждая MINOR версия → новый файл: `CHANGELOG/v1.1.md`
+- PATCH дописывается в существующий файл
+
+```
+CHANGELOG/
+├── v1.0.md   # 1.0.0 → 1.0.5
+├── v1.1.md   # 1.1.0 → 1.1.3
+└── v2.0.md   # 2.0.0 → ...
+```
+
+## Conventional Commits
+
+Каждый коммит должен соответствовать формату:
+
+```
+<тип>[optional scope]: <описание>
+
+[optional body]
+[optional footer]
+```
+
+| Тип | Действие | Влияние на версию |
+|-----|----------|-------------------|
+| `feat` | Новая функция | MINOR |
+| `fix` | Исправление | PATCH |
+| `BREAKING` | В теле или `!` после типа | MAJOR |
+| `docs` | Документация | — |
+| `refactor` | Рефакторинг | — |
+| `test` | Тесты | — |
+| `chore` | Обслуживание | — |
+
+## Agent Versioning (если используются агенты)
+
+Каждый агент версионируется **независимо** от проекта по A.B.C.
+
+### Правила бампа
+
+| Компонент | Когда меняется | Кто меняет |
+|-----------|---------------|------------|
+| **A (major)** | Breaking change в публичном интерфейсе | EvolutionAgent |
+| **B (minor)** | Новая capability (метод, роль, prompt) | EvolutionAgent |
+| **C (patch)** | Внутренние правки, без изменения поведения | Сам агент (авто) |
+
+### Механика
+
+1. Агент запускается → вычисляет SHA256 checksum своего `__file__`
+2. Сравнивает с хранимым checksum (в БД или в changelog файле)
+3. Не совпал → авто-бамп patch → запись в changelog → обновление checksum
+4. EvolutionAgent управляет minor/major бампами
+
+### Хранение
+
+```
+CHANGELOG/agents/<agent_name>.md
+```
+
+Формат:
+```markdown
+# audit_agent Changelog
+<!-- checksum: sha256hash -->
+
+## 1.0.2 (2026-05-10)
+- Fixed: описание исправления
+
+## 1.0.1 (2026-05-09)
+- Fixed: ещё одно исправление
+
+## 1.0.0 (2026-05-08)
+- Initial version
+```
+
+### Разделение ответственности
+
+| Аспект | Владелец | Где хранится |
+|--------|----------|--------------|
+| Версия проекта | SpecAgent (или человек) | `project.yaml`, `CHANGELOG/v*.md` |
+| Версия агента | EvolutionAgent | `AgentConfig.version` (БД) |
+| Changelog проекта | SpecAgent (или человек) | `CHANGELOG/v*.md` |
+| Changelog агента | EvolutionAgent | `CHANGELOG/agents/<name>.md` |