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 (как и весь репозиторий).
|