code-ai-installer 1.5.0 → 1.5.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -0,0 +1,19 @@
1
+ {
2
+ "name": "design_patterns_reference",
3
+ "display_name": "Справочник паттернов проектирования",
4
+ "description": "Справочник паттернов проектирования с DO/DON'T примерами — SOLID, DRY/KISS/YAGNI, GoF (Strategy, Observer, Factory, Adapter, Facade, Decorator, Command, State, Template Method), архитектурные (Repository, Service Layer, DI, Event-Driven, CQRS), микросервисные (Saga, Circuit Breaker). Language-agnostic псевдокод. Используй при проектировании модулей, ревью архитектуры, или при вопросах «какой паттерн применить».",
5
+ "default_prompt": "Используй $design_patterns_reference, когда задача относится к навыку \"Справочник паттернов проектирования\".",
6
+ "triggers": [
7
+ "design_patterns_reference",
8
+ "design patterns reference",
9
+ "Справочник паттернов проектирования",
10
+ "Справочник паттернов проектирования с DO/DON'T примерами — SOLID, DRY/KISS/YAGNI, GoF (Strategy, Observer, Factory, Adapter, Facade, Decorator, Command, State, Template Method), архитектурные (Repository, Service Layer, DI, Event-Driven, CQRS), микросервисные (Saga, Circuit Breaker). Language-agnostic псевдокод. Используй при проектировании модулей, ревью архитектуры, или при вопросах «какой паттерн применить»."
11
+ ],
12
+ "capabilities": [
13
+ "architecture",
14
+ "design",
15
+ "patterns"
16
+ ],
17
+ "tools": [],
18
+ "implicit_invocation": true
19
+ }
@@ -0,0 +1,23 @@
1
+ version: 1
2
+ name: "design_patterns_reference"
3
+ display_name: "Справочник паттернов проектирования"
4
+ description: "Справочник паттернов проектирования с DO/DON'T примерами — SOLID, DRY/KISS/YAGNI, GoF (Strategy, Observer, Factory, Adapter, Facade, Decorator, Command, State, Template Method), архитектурные (Repository, Service Layer, DI, Event-Driven, CQRS), микросервисные (Saga, Circuit Breaker). Language-agnostic псевдокод. Используй при проектировании модулей, ревью архитектуры, или при вопросах «какой паттерн применить»."
5
+ default_prompt: "Используй $design_patterns_reference, когда задача относится к навыку \"Справочник паттернов проектирования\"."
6
+ triggers:
7
+ - "design_patterns_reference"
8
+ - "design patterns reference"
9
+ - "Справочник паттернов проектирования"
10
+ - "Справочник паттернов проектирования с DO/DON'T примерами — SOLID, DRY/KISS/YAGNI, GoF (Strategy, Observer, Factory, Adapter, Facade, Decorator, Command, State, Template Method), архитектурные (Repository, Service Layer, DI, Event-Driven, CQRS), микросервисные (Saga, Circuit Breaker). Language-agnostic псевдокод. Используй при проектировании модулей, ревью архитектуры, или при вопросах «какой паттерн применить»."
11
+ capabilities:
12
+ - "architecture"
13
+ - "design"
14
+ - "patterns"
15
+ tools: []
16
+ invocation:
17
+ explicit: true
18
+ implicit: true
19
+ localization:
20
+ default_locale: "ru"
21
+ available_locales:
22
+ - "ru"
23
+ - "en"
@@ -0,0 +1,90 @@
1
+ ---
2
+ description: Запуск сокращённого 4-гейтового пайплайна для исправления багов. Используй вместо /start-task для bugfix-задач.
3
+ ---
4
+
5
+ # /bugfix — Запуск Bugfix Pipeline (4 гейта)
6
+
7
+ > 🟢 **Режим:** Bugfix — для исправления багов в существующем функционале.
8
+ > Полный пайплайн: `/start-task`. Hotfix (мелочи): `/hotfix`.
9
+
10
+ ## Когда использовать
11
+
12
+ - Баг в логике, API ошибки, сломанная валидация, проблемы с данными
13
+ - Затрагивает > 2 файлов или нетривиальный blast radius
14
+ - НЕ меняет UI layout, НЕ добавляет новый API, НЕ меняет схему данных (иначе → `/start-task`)
15
+
16
+ ## Шаг 0: Загрузить правила
17
+
18
+ Выполни `/pipeline-rules` — прочитай правила ПЕРЕД началом работы.
19
+
20
+ ## Шаг 1: CONDUCTOR — Классификация
21
+
22
+ 1. Выполни `view_file` на `agents/conductor.md`
23
+ 2. Подтверди что задача = bugfix (по Decision Tree)
24
+ 3. Создай Mini Checklist:
25
+ ```
26
+ [ ] BF-DEV-01 Fix + TDD + Handoff Envelope
27
+ [ ] BF-REV-01 Code review + regression check + Handoff Envelope
28
+ [ ] BF-TEST-01 Verification + regression smoke + GO/NO-GO
29
+ ```
30
+ 4. `notify_user` → ждать **Approved**
31
+
32
+ ## Шаг 2: DEV — TDD-фикс
33
+
34
+ 1. Выполни `view_file` на `agents/senior_full_stack.md`
35
+ 2. Пройди протокол (пропуская §1 UX review и §6 DEMO):
36
+ - §0: Context + read skills
37
+ - §2: Analyze bug + root cause
38
+ - §3: RED — написать падающий тест, воспроизводящий баг
39
+ - §4: GREEN — минимальный код для прохождения теста
40
+ - §5: REFACTOR — улучшить без изменения поведения
41
+ - §7: JSDoc на изменённых функциях
42
+ 3. Перезапустить затронутые сервисы (если применимо)
43
+ 4. Сформировать Handoff Envelope → REV
44
+ 5. `notify_user` → ждать **Approved**
45
+
46
+ ## Шаг 3: REV — Code Review
47
+
48
+ 1. Выполни `view_file` на `agents/reviewer.md`
49
+ 2. Фокус ревью:
50
+ - Тест действительно воспроизводит баг (RED-фаза)?
51
+ - Фикс не создаёт побочных эффектов?
52
+ - Regression risk оценён?
53
+ - JSDoc на месте?
54
+ 3. Сформировать Handoff Envelope → TEST
55
+ 4. `notify_user` → ждать **Approved**
56
+
57
+ ## Шаг 4: TEST — Верификация
58
+
59
+ 1. Выполни `view_file` на `agents/tester.md`
60
+ 2. Проверить:
61
+ - Баг исправлен (по шагам воспроизведения)
62
+ - Регрессии нет (smoke по затронутым модулям)
63
+ - Тесты проходят (CI green)
64
+ 3. Вынести вердикт: **GO ✅ / NO-GO ❌**
65
+ 4. `notify_user` → ждать **Approved**
66
+
67
+ ---
68
+
69
+ ## При FAIL на REV или TEST
70
+
71
+ 1. Агент выдаёт FAIL Report + Handoff → DEV
72
+ 2. DEV исправляет → Handoff → REV → TEST (повтор цикла)
73
+ 3. Approved на каждом гейте обязателен
74
+
75
+ ---
76
+
77
+ ## Шаблон промпта
78
+
79
+ ```
80
+ @AGENTS.md /bugfix
81
+
82
+ Баг: [описание бага, 1-2 предложения].
83
+ Воспроизведение: [шаги, если известны].
84
+ Файлы: [затронутые файлы, если известны].
85
+
86
+ Правила:
87
+ 1. Bugfix Pipeline: CONDUCTOR → DEV → REV → TEST
88
+ 2. TDD обязательно (RED → GREEN → REFACTOR)
89
+ 3. Approved на каждом гейте
90
+ ```
@@ -0,0 +1,74 @@
1
+ ---
2
+ description: Запуск минимального 2-гейтового пайплайна для мелких правок (hotfix). Используй для тривиальных фиксов с blast radius ≈ 0.
3
+ ---
4
+
5
+ # /hotfix — Запуск Hotfix Pipeline (2 гейта)
6
+
7
+ > 🟡 **Режим:** Hotfix — для тривиальных правок с минимальным риском.
8
+ > Полный пайплайн: `/start-task`. Bugfix (серьёзнее): `/bugfix`.
9
+
10
+ ## Когда использовать
11
+
12
+ - Опечатки в тексте/коде
13
+ - CSS-правки (цвет, отступ, размер)
14
+ - Правка одной строки логики
15
+ - Копипаст-ошибка
16
+ - Blast radius ≈ 0 (затрагивает 1–2 файла, не меняет контракты)
17
+
18
+ ## НЕ использовать если
19
+
20
+ - Затрагивает > 2 файлов → `/bugfix`
21
+ - Меняет API контракт → `/bugfix` или `/start-task`
22
+ - Меняет UI layout / добавляет экраны → `/start-task`
23
+ - Не уверен → спросить пользователя
24
+
25
+ ## Шаг 0: Загрузить правила
26
+
27
+ Выполни `/pipeline-rules` — прочитай правила ПЕРЕД началом работы.
28
+
29
+ ## Шаг 1: CONDUCTOR — Классификация
30
+
31
+ 1. Выполни `view_file` на `agents/conductor.md`
32
+ 2. Подтверди что задача = hotfix (по Decision Tree: blast radius ≈ 0, 1–2 файла)
33
+ 3. Создай Mini Checklist:
34
+ ```
35
+ [ ] HF-DEV-01 Fix + test + перезапуск сервиса (если применимо)
36
+ [ ] HF-VERIFY Self-check + GO/NO-GO
37
+ ```
38
+ 4. `notify_user` → ждать **Approved**
39
+
40
+ ## Шаг 2: DEV+TEST — Фикс и самопроверка
41
+
42
+ 1. Выполни `view_file` на `agents/senior_full_stack.md`
43
+ 2. TDD:
44
+ - RED: тест, воспроизводящий проблему (если применимо)
45
+ - GREEN: минимальный фикс
46
+ - REFACTOR: при необходимости
47
+ 3. JSDoc на изменённых функциях
48
+ 4. Перезапустить затронутые сервисы (если применимо)
49
+ 5. Самопроверка:
50
+ - Фикс работает?
51
+ - Тесты проходят?
52
+ - Регрессий нет?
53
+ 6. Вердикт: **GO ✅ / NO-GO ❌**
54
+ 7. `notify_user` → ждать **Approved**
55
+
56
+ ---
57
+
58
+ ## При сомнениях
59
+
60
+ Если во время работы стало ясно, что задача сложнее чем hotfix:
61
+ > ⚠️ «Задача оказалась сложнее hotfix. Рекомендую переключиться на /bugfix.»
62
+
63
+ Переключение — только с Approved пользователя.
64
+
65
+ ---
66
+
67
+ ## Шаблон промпта
68
+
69
+ ```
70
+ @AGENTS.md /hotfix
71
+
72
+ Что исправить: [описание, 1 предложение].
73
+ Файл: [конкретный файл].
74
+ ```
@@ -1,137 +1,163 @@
1
- ---
2
- description: Абсолютные правила пайплайна разработки. ЗАПРЕЩЕНО НАРУШАТЬ.
3
- ---
4
-
5
- # 🔴 АБСОЛЮТНОЕ ПРАВИЛО: Пайплайн запрещено пропускать
6
-
7
- **Это правило не имеет исключений. Нарушение = блокер.**
8
-
9
- ## Пайплайн (8 гейтов)
10
-
11
- TEST PM UX ARCH → DEV → REV → OPS → TEST
12
-
13
- ## Обязательные действия на КАЖДОМ гейте
14
-
15
- 1. `view_file` на `agents/<role>.md` прочитать протокол агента
16
- 2. Следовать **его** инструкциям, использовать **его** skills
17
- 3. Сформировать deliverable + Handoff Envelope
18
- 4. Представить результат пользователю через `notify_user`
19
- 5. **Ждать явный "Approved" от пользователя** перед переходом к следующему гейту
20
-
21
- ---
22
-
23
- ## 🛑 СТОП-ПРАВИЛА (перед каждым действием с кодом)
24
-
25
- ### Правило 1: Протокол агента — пошагово, не «схлопывая»
26
- Каждый параграф (§) в файле агента = **отдельный шаг**.
27
- - Агент ОБЯЗАН пройти ВСЕ параграфы в порядке, указанном в файле
28
- - Запрещено «схлопывать» несколько §§ в один ответ
29
- - Если агент пропускает §, он ОБЯЗАН указать причину: «§X пропущен: [причина]»
30
-
31
- ### Правило 2: Код применяется ТОЛЬКО после полного прохода протокола
32
- - Нельзя: сначала написать код потом написать отчёт
33
- - ✅ Нужно: пройти все §§ протокола → представить план → Approved → применить код
34
-
35
- ### Правило 3: Полный формат ответа — без сокращений
36
- - Использовать **«Формат ответа агента (строго)»** из файла агента
37
- - Каждая секция формата ОБЯЗАТЕЛЬНА — пропуск = нарушение
38
- - Если секция не применима, явно написать: «N/A [причина]»
39
-
40
- ### Правило 4: Fix Cycle полный проход через агентов
41
- При FAIL на любом гейте:
42
- 1. Текущий агент (напр. Tester) выдаёт FAIL Report + HANDOFF Envelope → DEV
43
- 2. DEV читает `agents/senior_full_stack.md` и проходит ПОЛНЫЙ протокол (§0–§7)
44
- 3. DEV HANDOFF → REV → OPS → TEST (каждый гейт с view_file + протокол + Approved)
45
- 4. Никаких «быстрых фиксов» без прохода через агентов
46
-
47
- ### Правило 5: Самопроверка перед notify_user
48
- Перед каждым `notify_user` агент ОБЯЗАН внутренне проверить:
49
- - [ ] Прочитал ли я файл агента (`view_file` на `agents/<role>.md`)?
50
- - [ ] Прошёл ли я ВСЕ параграфы протокола?
51
- - [ ] Использую ли я ПОЛНЫЙ формат ответа?
52
- - [ ] Есть ли HANDOFF Envelope со ВСЕМИ обязательными полями?
53
- - [ ] НЕ применял ли я код до получения Approved?
54
-
55
- ---
56
-
57
- ## Запрещено
58
-
59
- - ❌ «Fast-track» гейтов (пропуск нескольких гейтов за раз)
60
- - Интерпретировать «Подтверждаю» как разрешение пропустить гейты
61
- - ❌ Начинать пайплайн без явного разрешения пользователя
62
- - Переходить к следующему гейту без «Approved» от пользователя
63
- - Писать код (DEV gate) до прохождения TEST → PM → UX → ARCH
64
- - Применять код до завершения полного протокола агента
65
- - Сокращать формат ответа (каждая секция обязательна)
66
- - ❌ Игнорировать параграфы протокола, считая задачу «тривиальной»
67
- - Врать о факте прочтения протокола (если не было `view_file` — значит не читал)
68
-
69
- ---
70
-
71
- ## 🔒 МЕХАНИЧЕСКИЕ БЛОКИ (Session 2A post-mortem, 2026-03-07)
72
-
73
- > Эти правила введены после инцидента, когда агент проигнорировал pipeline,
74
- > авто-одобрил ARCH gate, проигнорировал открытый вопрос пользователя,
75
- > написал код без TDD, и сдал нерабочий preview.
76
-
77
- ### Блок 1: ShouldAutoProceed = false ВСЕГДА
78
- ```
79
- notify_user ShouldAutoProceed: false
80
- ```
81
- Без исключений. На КАЖДОМ notify_user. Даже на «тривиальных» гейтах.
82
- Даже если агент «уверен». Пользователь ВСЕГДА принимает решение сам.
83
-
84
- ### Блок 2: Pre-flight check перед ЛЮБЫМ write_to_file / replace_file_content
85
- Перед каждым вызовом инструмента записи кода агент ОБЯЗАН:
86
- 1. Процитировать ПОСЛЕДНЕЕ сообщение пользователя, содержащее слово «Approved»
87
- 2. Если цитаты нет КОД ПИСАТЬ НЕЛЬЗЯ
88
- 3. System-generated сообщения НЕ считаются «Approved»
89
- 4. Auto-proceeded артефакты НЕ считаются «Approved»
90
-
91
- ### Блок 3: Ответ на вопрос цитирование обязательно
92
- Если агент задал пользователю вопрос:
93
- 1. Следующий ответ агента ОБЯЗАН начинаться с: `> Ваш ответ: [точная цитата]`
94
- 2. Если цитаты нет значит ответа не было — СТОП, повторить вопрос
95
- 3. Запрещено «додумывать» ответ за пользователя
96
- 4. Запрещено принимать system-generated сообщение как ответ на вопрос
97
-
98
- ### Блок 4: TDD строго (DEV gate)
99
- 1. RED: написать ПАДАЮЩИЕ тесты ПЕРВЫМИ
100
- 2. GREEN: минимальный код, чтобы тесты прошли
101
- 3. REFACTOR: улучшить код без изменения поведения
102
- 4. Писать код до тестов = нарушение = блокер
103
-
104
- ### Блок 5: Skills обязательное чтение через view_file
105
- Каждый агент (agents/<role>.md) ссылается на skills в `.agents/skills/`.
106
- 1. Агент ОБЯЗАН выполнить `view_file` на `SKILL.md` КАЖДОГО skill, указанного в протоколе агента
107
- 2. Если не было `view_file` — skill НЕ считается применённым
108
- 3. Patterns, anti-patterns, code examples, best practices из skills — обязательны к применению
109
- 4. В deliverable агент ОБЯЗАН указать: `Skills applied: [список]` с подтверждением `view_file`
110
- 5. Формальные галочки без реального чтения = нарушение = блокер
111
-
112
- ---
113
-
114
- ## Обязательные артефакты
115
-
116
- ### task.md (Antigravity brain автоматически)
117
- - **Создаёт:** Conductor на Gate 0
118
- - **Обновляет:** КАЖДЫЙ агент после завершения своего гейта
119
- - **Содержит:** Master Checklist + Handoff Envelopes Status + Fix Cycle tracking
120
- - **Правило:** Если task.md не обновлён после гейта гейт не считается завершённым
121
-
122
- ### implementation_plan.md
123
- - **Создаёт:** Architect на Gate 3 (ARCH) или Conductor, если задача не требует ARCH
124
- - **Сохраняет:** `docs/reports/architect/plan-<task-name>.md` (в проекте)
125
- - **Содержит:** Proposed Changes + файлы + Verification Plan
126
- - **Правило:** DEV обязан прочитать plan перед началом реализации. Reviewer сверяется при code review.
127
-
128
- ### walkthrough.md (Antigravity brain автоматически)
129
- - **Создаёт:** Tester на Gate 7 (TEST) или Release Gate
130
- - **Содержит:** что сделано, что проверено, результаты валидации
131
- - **Правило:** обновлять при каждом Fix Cycle и перед Release Gate
132
-
133
- ### docs/architecture.md + docs/ADR-log.md (в проекте)
134
- - **Обновляет:** Architect при любом архитектурном решении
135
- - **Сверяются:** Reviewer и Architect на каждом гейте
136
- - **Правило:** Новые ADR добавляются в ADR-log.md. Architecture.md обновляется при изменении стека, паттернов или ограничений
137
-
1
+ ---
2
+ description: Абсолютные правила пайплайна разработки. ЗАПРЕЩЕНО НАРУШАТЬ.
3
+ ---
4
+
5
+ # 🔴 АБСОЛЮТНОЕ ПРАВИЛО: Пайплайн запрещено пропускать
6
+
7
+ **Это правило не имеет исключений. Нарушение = блокер.**
8
+
9
+ ## Пайплайн 3 режима
10
+
11
+ ### 🔵 Full Pipeline (8 гейтов) `/start-task`
12
+ CONDUCTOR → PM → UX → ARCH → DEV → REV → OPS → TEST → RG
13
+
14
+ ### 🟢 Bugfix Pipeline (4 гейта) — `/bugfix`
15
+ CONDUCTOR DEV REV TEST
16
+
17
+ ### 🟡 Hotfix Pipeline (2 гейта) — `/hotfix`
18
+ CONDUCTOR DEV+TEST
19
+
20
+ ### Decision Tree (выбор режима)
21
+ ```
22
+ Задача от пользователя
23
+
24
+ ├─ Новая фича / рефакторинг / новый API / новый экран?
25
+ │ └─ 🔵 Full Pipeline
26
+
27
+ ├─ Баг в существующем функционале?
28
+ │ ├─ Затрагивает > 2 файлов или меняет контракт API?
29
+ │ │ └─ 🟢 Bugfix (4 гейта)
30
+ │ ├─ Затрагивает 1–2 файла, blast radius ≈ 0?
31
+ │ │ └─ 🟡 Hotfix (2 гейта)
32
+ │ └─ Не уверенспросить пользователя
33
+
34
+ └─ Пользователь явно указал режим (/bugfix, /hotfix)?
35
+ └─ Использовать указанный
36
+ ```
37
+
38
+ > Conductor **не получает новых skills** использует существующие `$board`, `$handoff`, `$gates`.
39
+
40
+ ## Обязательные действия на КАЖДОМ гейте (все режимы)
41
+
42
+ 1. `view_file` на `agents/<role>.md` прочитать протокол агента
43
+ 2. Следовать **его** инструкциям, использовать **его** skills
44
+ 3. Сформировать deliverable + Handoff Envelope
45
+ 4. Представить результат пользователю через `notify_user`
46
+ 5. **Ждать явный "Approved" от пользователя** перед переходом к следующему гейту
47
+
48
+ ---
49
+
50
+ ## 🛑 СТОП-ПРАВИЛА (перед каждым действием с кодом)
51
+
52
+ ### Правило 1: Протокол агента пошагово, не «схлопывая»
53
+ Каждый параграф (§) в файле агента = **отдельный шаг**.
54
+ - Агент ОБЯЗАН пройти ВСЕ параграфы в порядке, указанном в файле
55
+ - Запрещено «схлопывать» несколько §§ в один ответ
56
+ - Если агент пропускает §, он ОБЯЗАН указать причину: «§X пропущен: [причина]»
57
+
58
+ ### Правило 2: Код применяется ТОЛЬКО после полного прохода протокола
59
+ - ❌ Нельзя: сначала написать код потом написать отчёт
60
+ - Нужно: пройти все §§ протокола → представить план → Approved → применить код
61
+
62
+ ### Правило 3: Полный формат ответа без сокращений
63
+ - Использовать **«Формат ответа агента (строго)»** из файла агента
64
+ - Каждая секция формата ОБЯЗАТЕЛЬНА пропуск = нарушение
65
+ - Если секция не применима, явно написать: «N/A — [причина]»
66
+
67
+ ### Правило 4: Fix Cycle полный проход через агентов
68
+ При FAIL на любом гейте:
69
+ 1. Текущий агент (напр. Tester) выдаёт FAIL Report + HANDOFF Envelope → DEV
70
+ 2. DEV читает `agents/senior_full_stack.md` и проходит ПОЛНЫЙ протокол (§0–§7)
71
+ 3. DEV HANDOFF REV → OPS → TEST (каждый гейт с view_file + протокол + Approved)
72
+ 4. Никаких «быстрых фиксов» без прохода через агентов
73
+
74
+ ### Правило 5: Самопроверка перед notify_user
75
+ Перед каждым `notify_user` агент ОБЯЗАН внутренне проверить:
76
+ - [ ] Прочитал ли я файл агента (`view_file` на `agents/<role>.md`)?
77
+ - [ ] Прошёл ли я ВСЕ параграфы протокола?
78
+ - [ ] Использую ли я ПОЛНЫЙ формат ответа?
79
+ - [ ] Есть ли HANDOFF Envelope со ВСЕМИ обязательными полями?
80
+ - [ ] НЕ применял ли я код до получения Approved?
81
+
82
+ ---
83
+
84
+ ## Запрещено
85
+
86
+ - «Fast-track» гейтов (пропуск нескольких гейтов за раз)
87
+ - Интерпретировать «Подтверждаю» как разрешение пропустить гейты
88
+ - Начинать пайплайн без явного разрешения пользователя
89
+ - Переходить к следующему гейту без «Approved» от пользователя
90
+ - ❌ Писать код (DEV gate) до прохождения предыдущих гейтов
91
+ - Применять код до завершения полного протокола агента
92
+ - Сокращать формат ответа (каждая секция обязательна)
93
+ - Игнорировать параграфы протокола, считая задачу «тривиальной»
94
+ - Врать о факте прочтения протокола (если не было `view_file` значит не читал)
95
+
96
+ ---
97
+
98
+ ## 🔒 МЕХАНИЧЕСКИЕ БЛОКИ
99
+
100
+ > Эти правила введены после инцидента, когда агент проигнорировал pipeline,
101
+ > авто-одобрил ARCH gate, проигнорировал открытый вопрос пользователя,
102
+ > написал код без TDD, и сдал нерабочий preview.
103
+
104
+ ### Блок 1: ShouldAutoProceed = false ВСЕГДА
105
+ ```
106
+ notify_user ShouldAutoProceed: false
107
+ ```
108
+ Без исключений. На КАЖДОМ notify_user. Даже на «тривиальных» гейтах.
109
+ Даже если агент «уверен». Пользователь ВСЕГДА принимает решение сам.
110
+
111
+ ### Блок 2: Pre-flight check перед ЛЮБЫМ write_to_file / replace_file_content
112
+ Перед каждым вызовом инструмента записи кода агент ОБЯЗАН:
113
+ 1. Процитировать ПОСЛЕДНЕЕ сообщение пользователя, содержащее слово «Approved»
114
+ 2. Если цитаты нет — КОД ПИСАТЬ НЕЛЬЗЯ
115
+ 3. System-generated сообщения НЕ считаются «Approved»
116
+ 4. Auto-proceeded артефакты НЕ считаются «Approved»
117
+
118
+ ### Блок 3: Ответ на вопрос цитирование обязательно
119
+ Если агент задал пользователю вопрос:
120
+ 1. Следующий ответ агента ОБЯЗАН начинаться с: `> Ваш ответ: [точная цитата]`
121
+ 2. Если цитаты нет — значит ответа не было — СТОП, повторить вопрос
122
+ 3. Запрещено «додумывать» ответ за пользователя
123
+ 4. Запрещено принимать system-generated сообщение как ответ на вопрос
124
+
125
+ ### Блок 4: TDD строго (DEV gate)
126
+ 1. RED: написать ПАДАЮЩИЕ тесты ПЕРВЫМИ
127
+ 2. GREEN: минимальный код, чтобы тесты прошли
128
+ 3. REFACTOR: улучшить код без изменения поведения
129
+ 4. Писать код до тестов = нарушение = блокер
130
+
131
+ ### Блок 5: Skills обязательное чтение через view_file
132
+ Каждый агент (agents/<role>.md) ссылается на skills в `.agents/skills/`.
133
+ 1. Агент ОБЯЗАН выполнить `view_file` на `SKILL.md` КАЖДОГО skill, указанного в протоколе агента
134
+ 2. Если не было `view_file` skill НЕ считается применённым
135
+ 3. Patterns, anti-patterns, code examples, best practices из skills — обязательны к применению
136
+ 4. В deliverable агент ОБЯЗАН указать: `Skills applied: [список]` с подтверждением `view_file`
137
+ 5. Формальные галочки без реального чтения = нарушение = блокер
138
+
139
+ ---
140
+
141
+ ## Обязательные артефакты
142
+
143
+ ### task.md (Antigravity brain — автоматически)
144
+ - **Создаёт:** Conductor на Gate 0
145
+ - **Обновляет:** КАЖДЫЙ агент после завершения своего гейта
146
+ - **Содержит:** Master Checklist + Handoff Envelopes Status + Fix Cycle tracking
147
+ - **Правило:** Если task.md не обновлён после гейта — гейт не считается завершённым
148
+
149
+ ### implementation_plan.md
150
+ - **Создаёт:** Architect на Gate 3 (ARCH) — или Conductor, если задача не требует ARCH
151
+ - **Сохраняет:** `docs/reports/architect/plan-<task-name>.md` (в проекте)
152
+ - **Содержит:** Proposed Changes + файлы + Verification Plan
153
+ - **Правило:** DEV обязан прочитать plan перед началом реализации. Reviewer сверяется при code review.
154
+
155
+ ### walkthrough.md (Antigravity brain — автоматически)
156
+ - **Создаёт:** Tester на Gate 7 (TEST) — или Release Gate
157
+ - **Содержит:** что сделано, что проверено, результаты валидации
158
+ - **Правило:** обновлять при каждом Fix Cycle и перед Release Gate
159
+
160
+ ### docs/architecture.md + docs/ADR-log.md (в проекте)
161
+ - **Обновляет:** Architect при любом архитектурном решении
162
+ - **Сверяются:** Reviewer и Architect на каждом гейте
163
+ - **Правило:** Новые ADR добавляются в ADR-log.md. Architecture.md обновляется при изменении стека, паттернов или ограничений