montana/Montana-Protocol/Agents/README.md

# Агенты 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 — изменения в `Code/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 (как и весь репозиторий).