montana/Монтана-Протокол/Агенты/README.md

4.4 KiB
Raw Permalink Blame History

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