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.
- package/.agents/skills/design_patterns_reference/agents/gemini.json +19 -0
- package/.agents/skills/design_patterns_reference/agents/skill.yaml +23 -0
- package/.agents/workflows/bugfix.md +90 -0
- package/.agents/workflows/hotfix.md +74 -0
- package/.agents/workflows/pipeline-rules.md +163 -137
- package/.agents/workflows/start-task.md +129 -120
- package/AGENTS.md +136 -135
- package/dist/platforms/adapters.js +3 -3
- package/locales/en/.agents/workflows/bugfix.md +90 -0
- package/locales/en/.agents/workflows/hotfix.md +74 -0
- package/locales/en/.agents/workflows/pipeline-rules.md +157 -18
- package/locales/en/.agents/workflows/start-task.md +120 -17
- package/locales/en/AGENTS.md +1 -0
- package/locales/en/agents/senior_full_stack.md +3 -1
- package/locales/en/prompt-examples.md +152 -0
- package/package.json +8 -8
|
@@ -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
|
-
## Пайплайн
|
|
10
|
-
|
|
11
|
-
|
|
12
|
-
|
|
13
|
-
|
|
14
|
-
|
|
15
|
-
|
|
16
|
-
|
|
17
|
-
|
|
18
|
-
|
|
19
|
-
|
|
20
|
-
|
|
21
|
-
|
|
22
|
-
|
|
23
|
-
|
|
24
|
-
|
|
25
|
-
|
|
26
|
-
|
|
27
|
-
|
|
28
|
-
|
|
29
|
-
|
|
30
|
-
|
|
31
|
-
|
|
32
|
-
|
|
33
|
-
|
|
34
|
-
|
|
35
|
-
|
|
36
|
-
|
|
37
|
-
|
|
38
|
-
|
|
39
|
-
|
|
40
|
-
|
|
41
|
-
|
|
42
|
-
1.
|
|
43
|
-
2.
|
|
44
|
-
3.
|
|
45
|
-
4.
|
|
46
|
-
|
|
47
|
-
|
|
48
|
-
|
|
49
|
-
|
|
50
|
-
|
|
51
|
-
|
|
52
|
-
|
|
53
|
-
|
|
54
|
-
|
|
55
|
-
|
|
56
|
-
|
|
57
|
-
|
|
58
|
-
|
|
59
|
-
- ❌
|
|
60
|
-
-
|
|
61
|
-
|
|
62
|
-
|
|
63
|
-
-
|
|
64
|
-
-
|
|
65
|
-
-
|
|
66
|
-
|
|
67
|
-
|
|
68
|
-
|
|
69
|
-
|
|
70
|
-
|
|
71
|
-
|
|
72
|
-
|
|
73
|
-
|
|
74
|
-
|
|
75
|
-
|
|
76
|
-
|
|
77
|
-
|
|
78
|
-
|
|
79
|
-
|
|
80
|
-
|
|
81
|
-
|
|
82
|
-
|
|
83
|
-
|
|
84
|
-
|
|
85
|
-
|
|
86
|
-
|
|
87
|
-
|
|
88
|
-
|
|
89
|
-
|
|
90
|
-
|
|
91
|
-
|
|
92
|
-
|
|
93
|
-
|
|
94
|
-
|
|
95
|
-
|
|
96
|
-
|
|
97
|
-
|
|
98
|
-
|
|
99
|
-
|
|
100
|
-
|
|
101
|
-
|
|
102
|
-
|
|
103
|
-
|
|
104
|
-
### Блок
|
|
105
|
-
|
|
106
|
-
|
|
107
|
-
|
|
108
|
-
|
|
109
|
-
|
|
110
|
-
|
|
111
|
-
|
|
112
|
-
|
|
113
|
-
|
|
114
|
-
|
|
115
|
-
|
|
116
|
-
|
|
117
|
-
|
|
118
|
-
|
|
119
|
-
|
|
120
|
-
|
|
121
|
-
|
|
122
|
-
|
|
123
|
-
|
|
124
|
-
|
|
125
|
-
|
|
126
|
-
|
|
127
|
-
|
|
128
|
-
|
|
129
|
-
|
|
130
|
-
|
|
131
|
-
|
|
132
|
-
|
|
133
|
-
|
|
134
|
-
|
|
135
|
-
-
|
|
136
|
-
|
|
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 обновляется при изменении стека, паттернов или ограничений
|