124 lines
4.9 KiB
Markdown
124 lines
4.9 KiB
Markdown
|
# Карта ролей Montana
|
|||
|
|
|
|||
|
|
**Версия:** v1.0.0
|
|||
|
|
**Аудитория:** ИИ-агент. Помогает выбрать правильную роль для задачи.
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
## Дерево решений
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
Какая у тебя задача?
|
|||
|
|
│
|
|||
|
|
├── Изменить спецификацию протокола (Montana v35.23.0.md)?
|
|||
|
|
│ ├── Дизайн нового механизма / расширение → 01-АРХИТЕКТОР-СПЕКИ.md
|
|||
|
|
│ └── Найти проблемы в существующем дизайне → 02-КРИТИК-СПЕКИ.md
|
|||
|
|
│
|
|||
|
|
├── Изменить Rust код (Код/crates/)?
|
|||
|
|
│ ├── Реализация / новый крейт / новая фича → 03-АРХИТЕКТОР-КОДА.md
|
|||
|
|
│ └── Code review / security audit → 04-КРИТИК-КОДА.md
|
|||
|
|
│
|
|||
|
|
├── Реализовать Montana на другом языке (Go/TS/Swift)?
|
|||
|
|
│ └── Green-field implementation → 05-РЕАЛИЗАТОР-ПОРТА.md
|
|||
|
|
│
|
|||
|
|
├── Внешний security audit perspective (NCC Group / ToB / Cure53)?
|
|||
|
|
│ └── External auditor mindset → 06-АУДИТОР-ВНЕШНИЙ.md
|
|||
|
|
│
|
|||
|
|
└── Координация нескольких агентов?
|
|||
|
|
└── КООРДИНАТОР.md (метароль)
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
## Цепочка работ (стандартный workflow)
|
|||
|
|
|
|||
|
|
### Изменение спеки
|
|||
|
|
```
|
|||
|
|
01-АРХИТЕКТОР-СПЕКИ изменяет спеку
|
|||
|
|
↓
|
|||
|
|
02-КРИТИК-СПЕКИ ищет проблемы (≥3 prowls: cumulative, regression, premise)
|
|||
|
|
↓
|
|||
|
|
01-АРХИТЕКТОР-СПЕКИ закрывает findings
|
|||
|
|
↓
|
|||
|
|
bump версии (v35.X.0 → v35.Y.0)
|
|||
|
|
↓
|
|||
|
|
переименование файла (Montana v35.X.0.md → Montana v35.Y.0.md)
|
|||
|
|
↓
|
|||
|
|
git commit (формат: "Протокол: spec bump v35.X.0 → v35.Y.0 — описание")
|
|||
|
|
↓
|
|||
|
|
03-АРХИТЕКТОР-КОДА реализует (если breaking)
|
|||
|
|
↓
|
|||
|
|
04-КРИТИК-КОДА ревьюит
|
|||
|
|
↓
|
|||
|
|
git commit + push
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
### Изменение кода (без спеки)
|
|||
|
|
```
|
|||
|
|
03-АРХИТЕКТОР-КОДА изменяет крейт
|
|||
|
|
↓
|
|||
|
|
cargo test / clippy / fmt — local
|
|||
|
|
↓
|
|||
|
|
04-КРИТИК-КОДА ревьюит
|
|||
|
|
↓
|
|||
|
|
03-АРХИТЕКТОР-КОДА fixes
|
|||
|
|
↓
|
|||
|
|
git commit (формат: "<crate>: описание")
|
|||
|
|
↓
|
|||
|
|
post-commit test block (markdown ссылки + cargo test + git log)
|
|||
|
|
↓
|
|||
|
|
push
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
### Green-field implementation на новом языке
|
|||
|
|
```
|
|||
|
|
05-РЕАЛИЗАТОР-ПОРТА читает спеку + KAT vectors из mt-conformance
|
|||
|
|
↓
|
|||
|
|
реализует byte-exact на target языке
|
|||
|
|
↓
|
|||
|
|
запускает все KAT vectors против своей реализации
|
|||
|
|
↓
|
|||
|
|
если хоть один KAT fails — STOP, обращение к 02-КРИТИК-СПЕКИ для уточнения
|
|||
|
|
↓
|
|||
|
|
external test против Rust mt-conformance (cross-implementation)
|
|||
|
|
↓
|
|||
|
|
PR в новый repo (например, montana-go)
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
### External audit
|
|||
|
|
```
|
|||
|
|
06-АУДИТОР-ВНЕШНИЙ читает спеку + audit-checklist + код
|
|||
|
|
↓
|
|||
|
|
формализует findings в формате audit firm
|
|||
|
|
↓
|
|||
|
|
готовит scope для NCC Group / ToB / Cure53
|
|||
|
|
↓
|
|||
|
|
докладывает координатору / автору
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
## Когда какую роль НЕ использовать
|
|||
|
|
|
|||
|
|
- **01-АРХИТЕКТОР-СПЕКИ** — НЕ для code changes (используй 03)
|
|||
|
|
- **02-КРИТИК-СПЕКИ** — НЕ для code review (используй 04)
|
|||
|
|
- **03-АРХИТЕКТОР-КОДА** — НЕ меняет спеку (только реализует)
|
|||
|
|
- **04-КРИТИК-КОДА** — НЕ для дизайн-вопросов (это к критику спеки)
|
|||
|
|
- **05-РЕАЛИЗАТОР-ПОРТА** — НЕ для модификаций Rust кода (используй 03)
|
|||
|
|
- **06-АУДИТОР-ВНЕШНИЙ** — НЕ для internal review (используй 02 + 04)
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
## Параллельная работа
|
|||
|
|
|
|||
|
|
Несколько агентов могут работать параллельно если:
|
|||
|
|
- ✅ они в разных файлах (например, 01 правит спеку, 03 правит крейт mt-net независимо)
|
|||
|
|
- ❌ они в одном файле (race condition по тексту — координация обязательна)
|
|||
|
|
- ❌ один агент редактирует, второй ревьюит — критик ждёт завершения архитектора
|
|||
|
|
|
|||
|
|
См. `КООРДИНАТОР.md` для подробного протокола взаимодействия.
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
**Следующий шаг:** загрузи нужную роль (`01-..` — `06-..`) как системный промпт.
|