59 lines
4.4 KiB
Markdown
59 lines
4.4 KiB
Markdown
# Агенты Montana
|
||
|
||
Папка с **самодостаточными промптами-ролями** для ИИ-агентов (Claude, GPT, Gemini, локальные модели), которые подключаются к работе над протоколом Montana.
|
||
|
||
## Зачем эта папка
|
||
|
||
Спека Montana v35.23.0 (~700 KB) и Rust workspace (16 крейтов) — большая система. Чтобы новый ИИ-агент не тратил часы на reverse-engineering контекста, роли в этой папке формализуют:
|
||
|
||
- **что такое Montana** (см. `ВВЕДЕНИЕ.md`)
|
||
- **как читать спеку** (термины — `ГЛОССАРИЙ.md`)
|
||
- **какую роль когда применять** (`КАРТА-РОЛЕЙ.md`)
|
||
- **как взаимодействуют агенты между собой** (`КООРДИНАТОР.md`)
|
||
- **6 конкретных ролей** (файлы `01-..` — `06-..`)
|
||
|
||
Каждая роль — отдельный файл, читается как системный промпт. Self-contained — не требует прошлого контекста, кроме явных ссылок на файлы спеки/кода.
|
||
|
||
## Как использовать
|
||
|
||
### Сценарий A — быстрый онбординг нового агента
|
||
1. Прочитать `ВВЕДЕНИЕ.md` (10 минут)
|
||
2. Прочитать `ГЛОССАРИЙ.md` (5 минут)
|
||
3. Открыть `КАРТА-РОЛЕЙ.md` → выбрать роль → загрузить файл роли как системный промпт
|
||
4. Начать работу
|
||
|
||
### Сценарий B — координация нескольких агентов
|
||
1. Прочитать `КООРДИНАТОР.md` — там описано как роли передают работу друг другу (архитектор → критик → архитектор-fix → коммит)
|
||
2. Запускать роли последовательно или параллельно по правилам координатора
|
||
|
||
### Сценарий C — green-field реализация на другом языке
|
||
1. Загрузить `05-РЕАЛИЗАТОР-ПОРТА.md`
|
||
2. Этот промпт даст ссылки на критические разделы спеки (KAT vectors, wire format, crypto primitives), которые нужны для byte-exact реализации
|
||
|
||
## Список ролей
|
||
|
||
| # | Файл | Что делает |
|
||
|---|---|---|
|
||
| — | `КООРДИНАТОР.md` | Метаpromпт: как роли взаимодействуют, цепочки передачи работы |
|
||
| — | `ВВЕДЕНИЕ.md` | Montana за 10 минут для AI-newcomer |
|
||
| — | `ГЛОССАРИЙ.md` | Термины (TimeChain, VDF, gates, invariants, Pre-mainnet, SSOT и др.) |
|
||
| — | `КАРТА-РОЛЕЙ.md` | Какую роль когда использовать |
|
||
| 01 | `01-АРХИТЕКТОР-СПЕКИ.md` | Дизайн протокола — изменения в `Montana v35.23.0.md` |
|
||
| 02 | `02-КРИТИК-СПЕКИ.md` | Adversarial review спеки — поиск дыр |
|
||
| 03 | `03-АРХИТЕКТОР-КОДА.md` | Реализация на Rust — изменения в `Код/crates/` |
|
||
| 04 | `04-КРИТИК-КОДА.md` | Code review, security audit прохода |
|
||
| 05 | `05-РЕАЛИЗАТОР-ПОРТА.md` | Реализация Montana на других языках (Go/TS/Swift) |
|
||
| 06 | `06-АУДИТОР-ВНЕШНИЙ.md` | Перспектива внешнего security firm (NCC Group / ToB / Cure53) |
|
||
|
||
## Координация
|
||
|
||
Главный координатор — модель Claude Opus 4.7 (1M context), работающая с автором (Alejandro Montana). См. `КООРДИНАТОР.md`. Другие агенты подключаются через эти промпты и докладывают результат координатору либо автору напрямую.
|
||
|
||
## Версионирование
|
||
|
||
Каждый файл роли имеет version-header в начале (`v1.0.0` и т.п.). При значимых изменениях — bump версии. SSOT для версии — сам файл (не VERSION.md).
|
||
|
||
## Лицензия
|
||
|
||
Apache-2.0 (как и весь репозиторий).
|