code-ai-installer 4.0.1-b → 4.0.1-c

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.
Files changed (128) hide show
  1. package/LICENSE +1 -1
  2. package/README.md +5 -5
  3. package/dist/catalog.js +1 -1
  4. package/dist/contentTransformer.d.ts +1 -1
  5. package/dist/contentTransformer.js +39 -0
  6. package/dist/index.js +10 -5
  7. package/dist/mcp/cli.js +4 -4
  8. package/dist/mcp/scorecard.d.ts +2 -2
  9. package/dist/mcp/task_state.d.ts +2 -2
  10. package/dist/mcp/tools/advance_gate.js +1 -1
  11. package/dist/mcp/tools/classify_gate.d.ts +2 -2
  12. package/dist/mcp/tools/classify_gate.js +2 -2
  13. package/dist/mcp/tools/load_role.d.ts +2 -2
  14. package/dist/mcp/tools/load_role.js +2 -2
  15. package/dist/mcp/tools/report_exception.d.ts +3 -3
  16. package/dist/mcp/tools/report_exception.js +4 -4
  17. package/dist/mcp/tools/request_decision.d.ts +3 -3
  18. package/dist/mcp/tools/request_decision.js +5 -5
  19. package/dist/mcp/tools/review_proposal.d.ts +1 -1
  20. package/dist/mcp/tools/review_proposal.js +6 -6
  21. package/dist/mcp/tools/sign_off.d.ts +2 -2
  22. package/dist/mcp/tools/sign_off.js +7 -7
  23. package/dist/mcp/tools/verify_claim.d.ts +1 -1
  24. package/dist/mcp/tools/verify_claim.js +1 -1
  25. package/dist/mcp_setup.d.ts +84 -31
  26. package/dist/mcp_setup.js +182 -66
  27. package/dist/platforms/adapters.js +54 -19
  28. package/dist/shared/frontmatter.js +1 -1
  29. package/dist/shared/persona.d.ts +1 -1
  30. package/dist/shared/persona.js +1 -1
  31. package/dist/shared/pipeline.d.ts +10 -10
  32. package/dist/shared/pipeline.js +7 -7
  33. package/dist/shared/tools.d.ts +15 -15
  34. package/dist/shared/tools.js +3 -3
  35. package/dist/shared/vocabulary.d.ts +4 -4
  36. package/dist/shared/vocabulary.js +4 -4
  37. package/dist/types.d.ts +1 -1
  38. package/domains/analytics/.agents/workflows/analytics-pipeline-rules.md +13 -3
  39. package/domains/analytics/.agents/workflows/analyze.md +1 -0
  40. package/domains/analytics/.agents/workflows/quick-insight.md +1 -0
  41. package/domains/analytics/locales/en/.agents/workflows/analytics-pipeline-rules.md +13 -3
  42. package/domains/analytics/locales/en/.agents/workflows/analyze.md +1 -0
  43. package/domains/analytics/locales/en/.agents/workflows/quick-insight.md +1 -0
  44. package/domains/analytics/locales/en/agents/interviewer.md +2 -1
  45. package/domains/analytics/locales/en/agents/layouter.md +2 -1
  46. package/domains/analytics/locales/en/agents/mediator.md +2 -1
  47. package/domains/analytics/locales/en/agents/researcher.md +2 -1
  48. package/domains/analytics/locales/en/agents/strategist.md +2 -1
  49. package/domains/analytics/pipeline.yaml +10 -10
  50. package/domains/content/.agents/skills/content-release-gate/SKILL.md +3 -5
  51. package/domains/content/.agents/workflows/content-pipeline-rules.md +14 -11
  52. package/domains/content/.agents/workflows/edit-content.md +0 -1
  53. package/domains/content/.agents/workflows/quick-post.md +0 -1
  54. package/domains/content/.agents/workflows/start-content.md +0 -1
  55. package/domains/content/agents/conductor.md +1 -2
  56. package/domains/content/locales/en/.agents/skills/content-release-gate/SKILL.md +3 -5
  57. package/domains/content/locales/en/.agents/workflows/content-pipeline-rules.md +14 -11
  58. package/domains/content/locales/en/.agents/workflows/edit-content.md +0 -1
  59. package/domains/content/locales/en/.agents/workflows/quick-post.md +0 -1
  60. package/domains/content/locales/en/.agents/workflows/start-content.md +0 -1
  61. package/domains/content/locales/en/agents/conductor.md +1 -2
  62. package/domains/content/pipeline.yaml +8 -8
  63. package/domains/development/.agents/skills/handoff/SKILL.md +276 -276
  64. package/domains/development/.agents/skills/lava-flow-legacy-detection/SKILL.md +197 -197
  65. package/domains/development/.agents/skills/mcp-integration/SKILL.md +211 -211
  66. package/domains/development/.agents/skills/qa-test-data-management/SKILL.md +250 -250
  67. package/domains/development/.agents/workflows/bugfix.md +16 -82
  68. package/domains/development/.agents/workflows/hotfix.md +16 -66
  69. package/domains/development/.agents/workflows/pipeline-rules.md +49 -132
  70. package/domains/development/.agents/workflows/start-task.md +17 -121
  71. package/domains/development/AGENTS.md +8 -3
  72. package/domains/development/agents/architect.md +247 -247
  73. package/domains/development/agents/conductor.md +363 -363
  74. package/domains/development/agents/devops.md +297 -297
  75. package/domains/development/agents/reviewer.md +293 -293
  76. package/domains/development/agents/senior_full_stack.md +295 -295
  77. package/domains/development/agents/tester.md +395 -395
  78. package/domains/development/locales/en/.agents/skills/handoff/SKILL.md +276 -276
  79. package/domains/development/locales/en/.agents/skills/lava-flow-legacy-detection/SKILL.md +197 -197
  80. package/domains/development/locales/en/.agents/skills/mcp-integration/SKILL.md +211 -211
  81. package/domains/development/locales/en/.agents/skills/qa-test-data-management/SKILL.md +250 -250
  82. package/domains/development/locales/en/.agents/workflows/bugfix.md +16 -82
  83. package/domains/development/locales/en/.agents/workflows/hotfix.md +15 -65
  84. package/domains/development/locales/en/.agents/workflows/pipeline-rules.md +48 -131
  85. package/domains/development/locales/en/.agents/workflows/start-task.md +17 -121
  86. package/domains/development/locales/en/AGENTS.md +15 -0
  87. package/domains/development/locales/en/agents/architect.md +247 -247
  88. package/domains/development/locales/en/agents/conductor.md +363 -363
  89. package/domains/development/locales/en/agents/devops.md +297 -297
  90. package/domains/development/locales/en/agents/reviewer.md +293 -293
  91. package/domains/development/locales/en/agents/senior_full_stack.md +295 -295
  92. package/domains/development/locales/en/agents/tester.md +395 -395
  93. package/domains/development/locales/en/prompt-examples.md +34 -120
  94. package/domains/development/pipeline.yaml +150 -135
  95. package/domains/development/prompt-examples.md +33 -119
  96. package/domains/product/.agents/workflows/product-pipeline-rules.md +13 -2
  97. package/domains/product/.agents/workflows/quick-pm.md +1 -1
  98. package/domains/product/.agents/workflows/shape-prioritize.md +1 -0
  99. package/domains/product/.agents/workflows/ship-right-thing.md +1 -0
  100. package/domains/product/.agents/workflows/spec.md +1 -0
  101. package/domains/product/agents/tech_lead.md +1 -1
  102. package/domains/product/locales/en/.agents/workflows/product-pipeline-rules.md +13 -2
  103. package/domains/product/locales/en/.agents/workflows/quick-pm.md +1 -1
  104. package/domains/product/locales/en/.agents/workflows/shape-prioritize.md +1 -0
  105. package/domains/product/locales/en/.agents/workflows/ship-right-thing.md +1 -0
  106. package/domains/product/locales/en/.agents/workflows/spec.md +1 -0
  107. package/domains/product/locales/en/agents/conductor.md +2 -2
  108. package/domains/product/locales/en/agents/data_analyst.md +2 -1
  109. package/domains/product/locales/en/agents/designer.md +2 -1
  110. package/domains/product/locales/en/agents/discovery.md +2 -1
  111. package/domains/product/locales/en/agents/layouter.md +2 -1
  112. package/domains/product/locales/en/agents/mediator.md +2 -1
  113. package/domains/product/locales/en/agents/pm.md +2 -1
  114. package/domains/product/locales/en/agents/product_strategist.md +2 -1
  115. package/domains/product/locales/en/agents/tech_lead.md +3 -2
  116. package/domains/product/locales/en/agents/ux_designer.md +2 -1
  117. package/domains/product/pipeline.yaml +12 -12
  118. package/package.json +5 -5
  119. package/domains/analytics/CONTEXT.md +0 -25
  120. package/domains/analytics/locales/en/CONTEXT.md +0 -25
  121. package/domains/content/CONTEXT.md +0 -19
  122. package/domains/content/locales/en/CONTEXT.md +0 -19
  123. package/domains/development/.agents/workflows/auto-restart-containers.md +0 -56
  124. package/domains/development/CONTEXT.md +0 -62
  125. package/domains/development/locales/en/.agents/workflows/auto-restart-containers.md +0 -24
  126. package/domains/development/locales/en/CONTEXT.md +0 -62
  127. package/domains/product/CONTEXT.md +0 -40
  128. package/domains/product/locales/en/CONTEXT.md +0 -40
@@ -1,152 +1,66 @@
1
- # Примеры промтов для запуска пайплайна
1
+ # Примеры промптов Development домен
2
2
 
3
- > Копируй нужный промт, подставляй свои данные, вставляй в чат.
3
+ > Скопируй нужный промт, подставь свои данные, отправь в чат.
4
4
 
5
- ---
5
+ ## Выбор режима
6
6
 
7
- ## 🔵 Полный пайплайн (`/start-task`) — новая фича / рефакторинг
7
+ | Задача | Команда |
8
+ |--------|---------|
9
+ | Новая фича / рефакторинг / новый API или экран | `/start-task` — Full (PM → UX → ARCH → DEV → REV → OPS → TEST → RG) |
10
+ | Баг в существующем функционале (> 2 файлов или меняет контракт API) | `/bugfix` (DEV → REV → TEST) |
11
+ | Мелкая правка, 1–2 файла, blast radius ≈ 0 | `/hotfix` (DEV → RG) |
12
+ | Не уверен в режиме | опиши задачу — Conductor классифицирует по Decision Tree |
13
+
14
+ ## Full Pipeline — `/start-task`
8
15
 
9
16
  ### Новая фича
10
17
  ```
11
- @AGENTS.md Задание:
12
- Реализовать [описание фичи].
13
- Полный пайплайн!
14
-
15
- ПРАВИЛА ЭТОЙ СЕССИИ:
16
- 1. Каждый гейт: view_file agents/<role>.md → view_file на КАЖДЫЙ SKILL.md из протокола skills → deliverable → notify_user → ждать "Approved"
17
- 2. Пропуск гейта или skill = БЛОКЕР
18
- 3. Без Approved — не продолжать
18
+ /start-task Реализовать [описание фичи]. Критерии приёмки: [что должно работать].
19
19
  ```
20
20
 
21
21
  ### Рефакторинг
22
22
  ```
23
- @AGENTS.md Задание:
24
- Провести рефакторинг [описание: что именно рефакторим и зачем].
25
- Полный пайплайн!
26
-
27
- ПРАВИЛА ЭТОЙ СЕССИИ:
28
- 1. Каждый гейт: view_file agents/<role>.md → view_file на КАЖДЫЙ SKILL.md из протокола skills → deliverable → notify_user → ждать "Approved"
29
- 2. Пропуск гейта или skill = БЛОКЕР
30
- 3. Без Approved — не продолжать
31
- ```
32
-
33
- ---
34
-
35
- ## 🟢 Bugfix (`/bugfix`) — исправление бага (4 гейта)
36
-
37
- ### Стандартный баг
38
- ```
39
- @AGENTS.md Задание:
40
- Исправить баг: [описание бага, шаги воспроизведения, ожидаемое vs фактическое поведение].
41
- Bugfix пайплайн!
42
-
43
- ПРАВИЛА ЭТОЙ СЕССИИ:
44
- 1. Каждый гейт: view_file agents/<role>.md → view_file на КАЖДЫЙ SKILL.md из протокола skills → deliverable → notify_user → ждать "Approved"
45
- 2. Пропуск гейта или skill = БЛОКЕР
46
- 3. Без Approved — не продолжать
47
- ```
48
-
49
- ### Баг с указанием файлов
50
- ```
51
- @AGENTS.md Задание:
52
- @[путь/к/файлу1] @[путь/к/файлу2]
53
- Баг: [описание]. Предполагаемая причина в указанных файлах.
54
- Bugfix пайплайн!
55
-
56
- ПРАВИЛА ЭТОЙ СЕССИИ:
57
- 1. Каждый гейт: view_file agents/<role>.md → view_file на КАЖДЫЙ SKILL.md → deliverable → notify_user → ждать "Approved"
58
- 2. Пропуск гейта = БЛОКЕР
59
- ```
60
-
61
- ---
62
-
63
- ## 🟡 Hotfix (`/hotfix`) — мелкая правка (2 гейта)
64
-
65
- ### Опечатка / CSS / одна строка
66
- ```
67
- @AGENTS.md Задание:
68
- Hotfix: [описание правки, например: "исправить опечатку в заголовке" или "изменить цвет кнопки с #333 на #555"].
69
- Hotfix пайплайн!
70
-
71
- ПРАВИЛА ЭТОЙ СЕССИИ:
72
- 1. Каждый гейт: view_file agents/<role>.md → view_file на КАЖДЫЙ SKILL.md → deliverable → notify_user → ждать "Approved"
73
- 2. Пропуск гейта = БЛОКЕР
23
+ /start-task Рефакторинг [что именно и зачем]. Целевое состояние: [...]. Не трогать: [...].
74
24
  ```
75
25
 
76
- ---
77
-
78
- ## 🎨 Только дизайн (Google Stitch)
79
-
80
- ### Генерация UI-экранов
26
+ ### Фича с UI
81
27
  ```
82
- @AGENTS.md Задание:
83
- Создать UI-экраны для [описание: какие экраны, какое приложение].
84
- Использовать Google Stitch через $stitch-prompting-guide (workflow) + $stitch-api-reference (MCP API).
85
-
86
- ПРАВИЛА ЭТОЙ СЕССИИ:
87
- 1. view_file agents/ux_ui_designer.md → view_file $stitch-prompting-guide → deliverable → notify_user → ждать "Approved"
28
+ /start-task [описание экрана/компонента]. UX: [требования к интерфейсу, a11y]. @[путь к макету или текущему компоненту]
88
29
  ```
89
30
 
90
- ---
91
-
92
- ## 📄 Только документация
93
-
94
- ### Адаптация / создание документов
31
+ ## Bugfix — `/bugfix`
95
32
  ```
96
- @AGENTS.md Задание:
97
- [Описание задачи с документацией, например: "адаптировать файлы X, Y, Z для глобального использования"].
98
- Bugfix пайплайн! (или Полный пайплайн — по сложности)
99
-
100
- ПРАВИЛА ЭТОЙ СЕССИИ:
101
- 1. Каждый гейт: view_file agents/<role>.md → view_file на КАЖДЫЙ SKILL.md → deliverable → notify_user → ждать "Approved"
102
- 2. Пропуск гейта = БЛОКЕР
33
+ /bugfix Баг: [описание]. Шаги воспроизведения: [...]. Ожидаемое vs фактическое: [...]. @[путь к файлу — если известно где]
103
34
  ```
104
35
 
105
- ---
106
-
107
- ## ⚡ Переход между гейтами (ответы пользователя)
108
-
109
- ### Одобрение и переход к следующему гейту
36
+ ## Hotfix — `/hotfix`
110
37
  ```
111
- Approved. Следующий гейт: agents/<role>.md. Skills: view_file обязателен. Полный формат.
38
+ /hotfix [мелкая правка: опечатка в заголовке / цвет кнопки #333 → #555 / одна строка].
112
39
  ```
113
40
 
114
- ### Одобрение с указанием триггера (Wix / Shopify)
115
- ```
116
- Approved. TEST gate. Wix.
117
- ```
41
+ ## Как идёт работа
118
42
 
119
- ### Отказ / возврат на доработку
120
- ```
121
- NO-GO. Исправь: [список замечаний]. Вернись на гейт [гейт].
122
- ```
43
+ - Пайплайн исполняет машина **code-ai MCP**. На каждом гейте: `current_gate` → `classify_gate` → роль через `load_role` + нужные скиллы через `get_skill` → deliverable + `submit_artifact` → `sign_off` → `advance_gate`.
44
+ - **Silent-by-default:** тебя спрашивают только на гейтах-суждениях — **PM / UX / ARCH / RG** — и при эскалации `fork` (через `request_decision`). DEV/REV/OPS/TEST машина проходит сама; OPS/TEST подписываются после зелёного авто-чека (`build` / `run_tests`).
45
+ - **Fix Cycle:** красный авто-чек или FAIL ревью/тестов → откат к DEV. 2 отката подряд на полосе DEV/OPS/REV/TEST → circuit breaker: аудит архитектора в свежей сессии.
123
46
 
124
- ---
47
+ > Полные правила — в `pipeline-rules.md`.
125
48
 
126
- ## 🔧 Утилитарные промты
49
+ ## Ответы на гейтах
127
50
 
128
- ### Проверка статуса
129
51
  ```
130
- Покажи текущий Master Checklist и статус всех гейтов.
52
+ Approved
131
53
  ```
132
-
133
- ### Запуск конкретного агента
134
54
  ```
135
- Запусти agents/<role>.md. Контекст: [краткое описание]. Skills: view_file обязателен.
55
+ Approved. [уточнение / условие]
136
56
  ```
137
-
138
- ### Обновление версии
139
57
  ```
140
- Обнови версию в package.json до X.Y.Z
58
+ NO-GO. Исправь: [список замечаний]. Вернись на гейт [PM/UX/ARCH/...].
141
59
  ```
142
60
 
143
- ---
144
-
145
- ## 📝 Советы по составлению промтов
61
+ ## Советы
146
62
 
147
- 1. **Всегда начинай с `@AGENTS.md`** это загружает систему агентов
148
- 2. **Указывай файлы через `@[путь]`** — агент сразу видит контекст
149
- 3. **Называй режим пайплайна**«Полный пайплайн!», «Bugfix пайплайн!», «Hotfix пайплайн!»
150
- 4. **Добавляй ПРАВИЛА СЕССИИ** это гарантирует соблюдение протокола
151
- 5. **Пиши «Approved»** явно — без этого слова агент не перейдёт к следующему гейту
152
- 6. **Будь конкретен** — чем точнее описание, тем лучше результат
63
+ 1. **Называй режим** явно (`/start-task` / `/bugfix` / `/hotfix`) или дай Conductor'у классифицировать.
64
+ 2. **Указывай файлы через `@путь`** — агент сразу видит контекст.
65
+ 3. **Чем точнее описание и критерии приёмки** тем меньше итераций Fix Cycle.
66
+ 4. **На гейтах-суждениях** (PM/UX/ARCH/RG) решение за тобой; рутину машина не дёргает.
@@ -13,6 +13,17 @@ description: Абсолютные правила продуктового пай
13
13
 
14
14
  ---
15
15
 
16
+ ## Машина гейтов (code-ai MCP)
17
+
18
+ Продуктовый пайплайн исполняется машиной состояний `code-ai` MCP; источник правды — `product/pipeline.yaml`. Каждый гейт проходится через MCP-поток: `current_gate` → `classify_gate` → `load_role` (роль гейта) + `get_skill` → deliverable + `submit_artifact` → `sign_off` → `advance_gate`.
19
+
20
+ - **Подпись:** в продукте **все гейты `user`** — каждый закрывается явным "Approved" пользователя (домен суждения; детерминированных авто-чеков, как тесты в разработке, здесь нет). Авто-пас на зелёном не применяется.
21
+ - **Circuit breaker отключён** (нет полосы откатов DEV/OPS/REV/TEST); возвраты идут через reverse `$handoff` (см. протокол ниже).
22
+ - Машина — линейная последовательность ролей; четыре режима (Full A/B, Spec, Quick) и состязательные камды (Customer/Business, Build/Cut) живут в промптах агентов и воркфлоу-файлах, а не в гейтах. **Camp Independence** (Правило №2) обеспечивается на уровне `$handoff` + camp-маркеров.
23
+ - Оркестрационные скиллы `$board` / `$handoff` / `$gates` — человекочитаемый слой поверх машины (доска статусов, передача, проверка готовности). Эскалация-развилка — `request_decision`; решения уровня ADR — `record_decision`.
24
+
25
+ ---
26
+
16
27
  ## Четыре режима пайплайна
17
28
 
18
29
  ### 🔵 Full Pipeline A — `/ship-right-thing` (6 сессий)
@@ -148,7 +159,7 @@ CONDUCTOR → DISCOVERY → product_strategist → PM → TECH_LEAD → DATA_ANA
148
159
  | # | Блок | Когда | Что проверяет | При провале |
149
160
  |---|------|-------|---------------|-------------|
150
161
  | 1 | **Pre-flight check** | Перед записью deliverable | Процитировать последний "Approved" пользователя | Остановиться, запросить Approved |
151
- | 2 | **Skill read check** | Перед применением скилла | Прочитать SKILL.md через `view_file` | Прочитать, затем применять |
162
+ | 2 | **Skill read check** | Перед применением скилла | Загрузить скилл через `get_skill` | Загрузить, затем применять |
152
163
  | 3 | **Camp marker check** | Full A/B Сессии 2-3 | Handoff содержит `team: alpha` или `team: beta` | Reverse Handoff к Conductor |
153
164
  | 4 | **Evidence pointer check** | Каждый deliverable Сессий 2-5 | Каждая позиция с source или `⚠️ assumed` | Пометить или удалить |
154
165
  | 5 | **Handoff file check** | Перед закрытием сессии (Full A/B) | `docs/product/session-N-handoff.md` сохранён, самодостаточен | Не закрывать сессию, сохранить файл |
@@ -192,7 +203,7 @@ CONDUCTOR → DISCOVERY → product_strategist → PM → TECH_LEAD → DATA_ANA
192
203
  1. Показать deliverable и запросить "Approved".
193
204
  2. Если нет ответа — **ожидать**. Не переходить к следующему гейту.
194
205
  3. Напомнить: «Ожидаю "Approved" для перехода к [следующий гейт]».
195
- 4. **Никогда** не auto-proceed. `ShouldAutoProceed = false` ВСЕГДА.
206
+ 4. **Никогда** не двигать гейт без `sign_off` (все гейты `user` — нужен явный "Approved").
196
207
 
197
208
  ### При повторных FAIL на `$gates`
198
209
  | Итерация | Действие |
@@ -2,6 +2,7 @@
2
2
 
3
3
  > **Используй для быстрых продуктовых ответов — 1-2 часа работы.**
4
4
  > 1 сессия, без adversarial, без handoff-файлов между шагами. Output — Short brief (markdown, 1-2 страницы).
5
+ > Исполняется машиной code-ai MCP: `current_gate` → `classify_gate` → `load_role`/`get_skill` → `submit_artifact` → `sign_off` → `advance_gate`; все гейты `user`. Правила и секция «Машина гейтов» — в `product-pipeline-rules.md`.
5
6
 
6
7
  ## Когда использовать
7
8
 
@@ -199,7 +200,6 @@ COND-01 → DISC-quick → STRAT-quick → PM-quick → TECH-quick → DATA-quic
199
200
  ## Output
200
201
 
201
202
  - `quick-brief-[slug].md` (1-2 pages) — финальный deliverable
202
- - Optional: CONTEXT.md update (если project использует CONTEXT.md)
203
203
  - Optional: добавление item в roadmap backlog (если recommendation = Yes)
204
204
 
205
205
  ## Пример — TeamFlow AI 1:1: Add emoji reactions в summary? (Quick)
@@ -2,6 +2,7 @@
2
2
 
3
3
  > **Используй, когда стратегия утверждена, а scope-дискуссия открыта.**
4
4
  > 6 сессий с adversarial на оси **Build vs Cut**. Mediator синтезирует final MoSCoW. Output — PRD (PDF).
5
+ > Исполняется машиной code-ai MCP: `current_gate` → `classify_gate` → `load_role`/`get_skill` → `submit_artifact` → `sign_off` → `advance_gate`; все гейты `user`. Правила и секция «Машина гейтов» — в `product-pipeline-rules.md`.
5
6
 
6
7
  ## Когда использовать
7
8
 
@@ -2,6 +2,7 @@
2
2
 
3
3
  > **Используй, когда стратегия не утверждена, нужен полный план от discovery до PRD + PDF.**
4
4
  > 6 сессий с adversarial на оси **Customer vs Business**. Mediator синтезирует. Output — PRD + Product Review Deck (PDF).
5
+ > Исполняется машиной code-ai MCP: `current_gate` → `classify_gate` → `load_role`/`get_skill` → `submit_artifact` → `sign_off` → `advance_gate`; все гейты `user`. Правила и секция «Машина гейтов» — в `product-pipeline-rules.md`.
5
6
 
6
7
  ## Когда использовать
7
8
 
@@ -2,6 +2,7 @@
2
2
 
3
3
  > **Используй, когда стратегия и scope утверждены — нужен формальный PRD.**
4
4
  > 1 сессия, без adversarial. Output — PRD (markdown) или PRD PDF (опционально).
5
+ > Исполняется машиной code-ai MCP: `current_gate` → `classify_gate` → `load_role`/`get_skill` → `submit_artifact` → `sign_off` → `advance_gate`; все гейты `user`. Правила и секция «Машина гейтов» — в `product-pipeline-rules.md`.
5
6
 
6
7
  ## Когда использовать
7
8
 
@@ -53,7 +53,7 @@ critical path и зависимостями, (5) camp discipline (Full B).
53
53
  | Поле | Обязательно | Источник |
54
54
  |------|:-----------:|----------|
55
55
  | PRD draft или Scope Proposal (user stories, AC) | Да | PM (из своей camp в Full B; Mediator synthesis в Full A S5) |
56
- | Architecture context (существующий стек, сервисы) | Да | Пользователь / репо / CONTEXT.md |
56
+ | Architecture context (существующий стек, сервисы) | Да | Пользователь / репо |
57
57
  | Team composition (senior / mid / junior + velocity) | Да | Пользователь |
58
58
  | Compliance / security constraints | Да (если применимо) | Discovery / Пользователь |
59
59
  | Какую камду играем (Full B) | Да (Full B Сессии 2-3) | Conductor |
@@ -13,6 +13,17 @@ description: Absolute rules of the product pipeline — gates, discipline, camp
13
13
 
14
14
  ---
15
15
 
16
+ ## Gate machine (code-ai MCP)
17
+
18
+ The product pipeline is executed by the `code-ai` MCP state machine; the source of truth is `product/pipeline.yaml`. Every gate runs through the MCP flow: `current_gate` → `classify_gate` → `load_role` (the gate's role) + `get_skill` → deliverable + `submit_artifact` → `sign_off` → `advance_gate`.
19
+
20
+ - **Sign-off:** in product **all gates are `user`** — each is closed by the user's explicit "Approved" (a judgment domain; there are no deterministic auto-checks here, like tests in development). No auto-pass on green.
21
+ - **Circuit breaker is disabled** (there is no DEV/OPS/REV/TEST rollback band); returns go through reverse `$handoff` (see protocol below).
22
+ - The machine is a linear sequence of roles; the four modes (Full A/B, Spec, Quick) and the adversarial camps (Customer/Business, Build/Cut) live in the agent prompts and workflow files, not in the gates. **Camp Independence** (Rule #2) is enforced at the `$handoff` + camp-marker level.
23
+ - Orchestration skills `$board` / `$handoff` / `$gates` are a human-readable layer over the machine (status board, transfer, readiness check). The escalation fork is `request_decision`; ADR-level decisions are `record_decision`.
24
+
25
+ ---
26
+
16
27
  ## Four Pipeline Modes
17
28
 
18
29
  ### 🔵 Full Pipeline A — `/ship-right-thing` (6 sessions)
@@ -148,7 +159,7 @@ Escalation: if Conductor sees that the request does not match — asks 5 clarify
148
159
  | # | Block | When | What it checks | On failure |
149
160
  |---|-------|------|----------------|------------|
150
161
  | 1 | **Pre-flight check** | Before writing deliverable | Quote the user's last "Approved" | Stop, request Approved |
151
- | 2 | **Skill read check** | Before applying a skill | Read SKILL.md via `view_file` | Read, then apply |
162
+ | 2 | **Skill read check** | Before applying a skill | Load the skill via `get_skill` | Load, then apply |
152
163
  | 3 | **Camp marker check** | Full A/B Sessions 2-3 | Handoff contains `team: alpha` or `team: beta` | Reverse Handoff to Conductor |
153
164
  | 4 | **Evidence pointer check** | Every deliverable in Sessions 2-5 | Every position with source or `⚠️ assumed` | Mark or remove |
154
165
  | 5 | **Handoff file check** | Before closing session (Full A/B) | `docs/product/session-N-handoff.md` saved, self-contained | Do not close session, save file |
@@ -192,7 +203,7 @@ Escalation: if Conductor sees that the request does not match — asks 5 clarify
192
203
  1. Show the deliverable and request "Approved".
193
204
  2. If no response — **wait**. Do not proceed to the next gate.
194
205
  3. Remind: "Waiting for 'Approved' to proceed to [next gate]".
195
- 4. **Never** auto-proceed. `ShouldAutoProceed = false` ALWAYS.
206
+ 4. **Never** move a gate without `sign_off` (all gates are `user` — an explicit "Approved" is required).
196
207
 
197
208
  ### On repeated FAIL at `$gates`
198
209
  | Iteration | Action |
@@ -2,6 +2,7 @@
2
2
 
3
3
  > **Use for quick product answers — 1-2 hours of work.**
4
4
  > 1 session, no adversarial, no handoff files between steps. Output — Short brief (markdown, 1-2 pages).
5
+ > Executed by the code-ai MCP machine: `current_gate` → `classify_gate` → `load_role`/`get_skill` → `submit_artifact` → `sign_off` → `advance_gate`; all gates `user`. Rules and the "Gate machine" section live in `product-pipeline-rules.md`.
5
6
 
6
7
  ## When to Use
7
8
 
@@ -199,7 +200,6 @@ If Quick reveals complexity — **convert to Full A or Full B**:
199
200
  ## Output
200
201
 
201
202
  - `quick-brief-[slug].md` (1-2 pages) — final deliverable
202
- - Optional: CONTEXT.md update (if project uses CONTEXT.md)
203
203
  - Optional: adding item to roadmap backlog (if recommendation = Yes)
204
204
 
205
205
  ## Example — TeamFlow AI 1:1: Add emoji reactions to summary? (Quick)
@@ -2,6 +2,7 @@
2
2
 
3
3
  > **Use when strategy is approved and the scope discussion is open.**
4
4
  > 6 sessions with adversarial on the **Build vs Cut axis**. Mediator synthesizes the final MoSCoW. Output — PRD (PDF).
5
+ > Executed by the code-ai MCP machine: `current_gate` → `classify_gate` → `load_role`/`get_skill` → `submit_artifact` → `sign_off` → `advance_gate`; all gates `user`. Rules and the "Gate machine" section live in `product-pipeline-rules.md`.
5
6
 
6
7
  ## When to Use
7
8
 
@@ -2,6 +2,7 @@
2
2
 
3
3
  > **Use when strategy is not approved and a full plan from discovery to PRD + PDF is needed.**
4
4
  > 6 sessions with adversarial on the **Customer vs Business axis**. Mediator synthesizes. Output — PRD + Product Review Deck (PDF).
5
+ > Executed by the code-ai MCP machine: `current_gate` → `classify_gate` → `load_role`/`get_skill` → `submit_artifact` → `sign_off` → `advance_gate`; all gates `user`. Rules and the "Gate machine" section live in `product-pipeline-rules.md`.
5
6
 
6
7
  ## When to Use
7
8
 
@@ -2,6 +2,7 @@
2
2
 
3
3
  > **Use when strategy and scope are approved — a formal PRD is needed.**
4
4
  > 1 session, no adversarial. Output — PRD (markdown) or PRD PDF (optional).
5
+ > Executed by the code-ai MCP machine: `current_gate` → `classify_gate` → `load_role`/`get_skill` → `submit_artifact` → `sign_off` → `advance_gate`; all gates `user`. Rules and the "Gate machine" section live in `product-pipeline-rules.md`.
5
6
 
6
7
  ## When to Use
7
8
 
@@ -36,8 +36,7 @@ and Beta do not interact before the Mediator.
36
36
  The Conductor's success is measured by the final PRD and/or Product Review Deck accurately
37
37
  answering the product question, both camps (Customer-Champion vs Business-Champion in Full A,
38
38
  or Build-Camp vs Cut-Camp in Full B) having conducted independent analysis, the Mediator
39
- delivering a well-reasoned synthesis, and the entire process being transparent to the user
40
- at every step.
39
+ delivering a well-reasoned synthesis, and the entire process being transparent to the user at every step.
41
40
 
42
41
  > **Pipeline rules:** The Conductor follows `product-pipeline-rules.md` — 7 mandatory rules, mechanical blocks, health metrics, escalation protocol.
43
42
 
@@ -58,6 +57,7 @@ at every step.
58
57
  ## Skills used
59
58
 
60
59
  ### Mandatory (every time)
60
+ - **$karpathy-guidelines** — think first, do only what's needed, edit precisely, work from the result
61
61
  - **$board** — task board management, gate status tracking, progress metrics
62
62
  - **$handoff** — producing handoff envelopes and inter-session files
63
63
  - **$gates** — gate control, deliverable verification, severity (Blocker/Gap/Note)
@@ -5,7 +5,7 @@ domain: product
5
5
  signs_off_at:
6
6
  - DATA_ANALYST
7
7
  tool_allowlist: role:data_analyst
8
- budget_lines: 568
8
+ budget_lines: 569
9
9
  schema_version: 1
10
10
  ---
11
11
 
@@ -61,6 +61,7 @@ guardrails + leading indicators, (2) each hypothesis formalized per template,
61
61
  ## Skills used
62
62
 
63
63
  ### Mandatory (every time)
64
+ - **$karpathy-guidelines** — think first, do only what's needed, edit precisely, work from the result
64
65
  - **`$saas-metrics`** — B2B SaaS metrics (MRR/ARR, churn, NRR, LTV/CAC, Payback, Rule of 40)
65
66
  - **`$hypothesis-template`** — hypothesis formalization
66
67
  - **`$gates`** — deliverable verification per DATA-01 criteria
@@ -5,7 +5,7 @@ domain: product
5
5
  signs_off_at:
6
6
  - DESIGNER
7
7
  tool_allowlist: role:designer
8
- budget_lines: 454
8
+ budget_lines: 455
9
9
  schema_version: 1
10
10
  ---
11
11
 
@@ -59,6 +59,7 @@ not rewritten or shortened without sign-off.
59
59
  ## Skills used
60
60
 
61
61
  ### Mandatory (every time)
62
+ - **$karpathy-guidelines** — think first, do only what's needed, edit precisely, work from the result
62
63
  - **`$report-design`** — PRD / Deck layout (information architecture, typography, visual hierarchy)
63
64
  - **`$gates`** — deliverable verification per DS-01 criteria
64
65
  - **`$handoff`** — forming the handoff envelope for Layouter
@@ -5,7 +5,7 @@ domain: product
5
5
  signs_off_at:
6
6
  - DISCOVERY
7
7
  tool_allowlist: role:discovery
8
- budget_lines: 558
8
+ budget_lines: 559
9
9
  schema_version: 1
10
10
  ---
11
11
 
@@ -58,6 +58,7 @@ a compact brief for 1 session.
58
58
  ## Skills used
59
59
 
60
60
  ### Mandatory
61
+ - **$karpathy-guidelines** — think first, do only what's needed, edit precisely, work from the result
61
62
  - **`$user-interview-script`** — B2B interview script (buyer + end-user tracks)
62
63
  - **`$jtbd-canvas`** — JTBD canvas (functional / emotional / social jobs)
63
64
  - **`$problem-statement`** — clear problem formulation
@@ -5,7 +5,7 @@ domain: product
5
5
  signs_off_at:
6
6
  - LAYOUTER
7
7
  tool_allowlist: role:layouter
8
- budget_lines: 624
8
+ budget_lines: 625
9
9
  schema_version: 1
10
10
  ---
11
11
 
@@ -58,6 +58,7 @@ colors, spacing), (4) accessibility — semantic HTML, proper headings, alt-text
58
58
  ## Skills used
59
59
 
60
60
  ### Mandatory (every time)
61
+ - **$karpathy-guidelines** — think first, do only what's needed, edit precisely, work from the result
61
62
  - **`$html-pdf-report`** — HTML/CSS → PDF pipeline (print-ready, self-contained)
62
63
  - **`$gates`** — deliverable verification per LY-01 criteria
63
64
  - **`$handoff`** — forming the handoff envelope for Release Gate
@@ -5,7 +5,7 @@ domain: product
5
5
  signs_off_at:
6
6
  - MEDIATOR
7
7
  tool_allowlist: role:mediator
8
- budget_lines: 525
8
+ budget_lines: 526
9
9
  schema_version: 1
10
10
  ---
11
11
 
@@ -64,6 +64,7 @@ who will specify the solution in Session 5.
64
64
  ## Skills used
65
65
 
66
66
  ### Mandatory (every time)
67
+ - **$karpathy-guidelines** — think first, do only what's needed, edit precisely, work from the result
67
68
  - **`$handoff`** — receipt from COND-04 + forming envelope with Unified Synthesis
68
69
  - **`$gates`** — deliverable verification per MED-xx criteria before handoff
69
70
  - **`$board`** — updating MED-01 status
@@ -5,7 +5,7 @@ domain: product
5
5
  signs_off_at:
6
6
  - PM
7
7
  tool_allowlist: role:pm
8
- budget_lines: 555
8
+ budget_lines: 556
9
9
  schema_version: 1
10
10
  ---
11
11
 
@@ -65,6 +65,7 @@ metrics (NSM/OKR link), (5) out-of-scope explicitly stated (prevent creep), (6)
65
65
  ## Skills used
66
66
 
67
67
  ### Mandatory (every time)
68
+ - **$karpathy-guidelines** — think first, do only what's needed, edit precisely, work from the result
68
69
  - **`$prd-template`** — Product Requirements Document
69
70
  - **`$user-story`** — INVEST user stories
70
71
  - **`$acceptance-criteria`** — Gherkin AC
@@ -5,7 +5,7 @@ domain: product
5
5
  signs_off_at:
6
6
  - PRODUCT_STRATEGIST
7
7
  tool_allowlist: role:product_strategist
8
- budget_lines: 513
8
+ budget_lines: 514
9
9
  schema_version: 1
10
10
  ---
11
11
 
@@ -64,6 +64,7 @@ multi-level reasoning from evidence to vision.
64
64
  ## Skills used
65
65
 
66
66
  ### Mandatory (every time)
67
+ - **$karpathy-guidelines** — think first, do only what's needed, edit precisely, work from the result
67
68
  - **`$product-vision`** — product vision (vision statement + principles)
68
69
  - **`$okr-framework`** — OKR for quarter/year
69
70
  - **`$north-star-metric`** — NSM selection + leading indicators
@@ -5,7 +5,7 @@ domain: product
5
5
  signs_off_at:
6
6
  - TECH_LEAD
7
7
  tool_allowlist: role:tech_lead
8
- budget_lines: 557
8
+ budget_lines: 558
9
9
  schema_version: 1
10
10
  ---
11
11
 
@@ -53,7 +53,7 @@ critical path and dependencies, (5) camp discipline (Full B).
53
53
  | Field | Required | Source |
54
54
  |-------|:--------:|--------|
55
55
  | PRD draft or Scope Proposal (user stories, AC) | Yes | PM (from own camp in Full B; Mediator synthesis in Full A S5) |
56
- | Architecture context (existing stack, services) | Yes | User / repo / CONTEXT.md |
56
+ | Architecture context (existing stack, services) | Yes | User / repo |
57
57
  | Team composition (senior / mid / junior + velocity) | Yes | User |
58
58
  | Compliance / security constraints | Yes (if applicable) | Discovery / User |
59
59
  | Which camp we play (Full B) | Yes (Full B Sessions 2-3) | Conductor |
@@ -63,6 +63,7 @@ critical path and dependencies, (5) camp discipline (Full B).
63
63
  ## Skills used
64
64
 
65
65
  ### Mandatory (every time)
66
+ - **$karpathy-guidelines** — think first, do only what's needed, edit precisely, work from the result
66
67
  - **`$epic-breakdown`** — decomposing initiative into epics → stories with dependencies
67
68
  - **`$gates`** — deliverable verification per TECH-xx criteria
68
69
  - **`$handoff`** — forming the handoff envelope
@@ -5,7 +5,7 @@ domain: product
5
5
  signs_off_at:
6
6
  - UX_DESIGNER
7
7
  tool_allowlist: role:ux_designer
8
- budget_lines: 450
8
+ budget_lines: 451
9
9
  schema_version: 1
10
10
  ---
11
11
 
@@ -54,6 +54,7 @@ context for Designer / external visual designer, (5) B2B persona delineation fol
54
54
  ## Skills used
55
55
 
56
56
  ### Mandatory (every time)
57
+ - **$karpathy-guidelines** — think first, do only what's needed, edit precisely, work from the result
57
58
  - **`$user-flow`** — user flow docs (steps, decision points, exits, error states)
58
59
  - **`$design-brief`** — brief for Designer / external visual designer
59
60
  - **`$gates`** — deliverable verification per UX-01 criteria
@@ -21,14 +21,14 @@
21
21
  # workflow files, not the gate sequence. Extra modes are deferred (the
22
22
  # PipelineMode enum full/bugfix/hotfix carries dev semantics).
23
23
  #
24
- # All gates use sign_off_policy=den: product has no wired deterministic auto-check
24
+ # All gates use sign_off_policy=user: product has no wired deterministic auto-check
25
25
  # MCP tools. Circuit breaker is DISABLED (the breaker mechanic is hardwired to a
26
26
  # rollback into the DEV gate, which product has no analog for).
27
27
 
28
28
  schema_version: 1
29
29
  domain: product
30
30
  default_mode: full
31
- default_signer: den
31
+ default_signer: user
32
32
 
33
33
  modes:
34
34
  - mode: full
@@ -36,61 +36,61 @@ modes:
36
36
  - gate: DISCOVERY
37
37
  produced_by: [discovery]
38
38
  signs_off: [discovery, conductor]
39
- sign_off_policy: den
39
+ sign_off_policy: user
40
40
  classify_required: true
41
41
  retryable: true
42
42
  - gate: PRODUCT_STRATEGIST
43
43
  produced_by: [product_strategist]
44
44
  signs_off: [product_strategist, conductor]
45
- sign_off_policy: den
45
+ sign_off_policy: user
46
46
  classify_required: true
47
47
  retryable: true
48
48
  - gate: PM
49
49
  produced_by: [pm]
50
50
  signs_off: [pm, conductor]
51
- sign_off_policy: den
51
+ sign_off_policy: user
52
52
  classify_required: true
53
53
  retryable: true
54
54
  - gate: UX_DESIGNER
55
55
  produced_by: [ux_designer]
56
56
  signs_off: [ux_designer, conductor]
57
- sign_off_policy: den
57
+ sign_off_policy: user
58
58
  classify_required: true
59
59
  retryable: true
60
60
  - gate: TECH_LEAD
61
61
  produced_by: [tech_lead]
62
62
  signs_off: [tech_lead, conductor]
63
- sign_off_policy: den
63
+ sign_off_policy: user
64
64
  classify_required: true
65
65
  retryable: true
66
66
  - gate: DATA_ANALYST
67
67
  produced_by: [data_analyst]
68
68
  signs_off: [data_analyst, conductor]
69
- sign_off_policy: den
69
+ sign_off_policy: user
70
70
  classify_required: true
71
71
  retryable: true
72
72
  - gate: MEDIATOR
73
73
  produced_by: [mediator]
74
74
  signs_off: [mediator, conductor]
75
- sign_off_policy: den
75
+ sign_off_policy: user
76
76
  classify_required: true
77
77
  retryable: true
78
78
  - gate: DESIGNER
79
79
  produced_by: [designer]
80
80
  signs_off: [designer, conductor]
81
- sign_off_policy: den
81
+ sign_off_policy: user
82
82
  classify_required: true
83
83
  retryable: true
84
84
  - gate: LAYOUTER
85
85
  produced_by: [layouter]
86
86
  signs_off: [layouter, conductor]
87
- sign_off_policy: den
87
+ sign_off_policy: user
88
88
  classify_required: true
89
89
  retryable: true
90
90
  - gate: RELEASE_GATE
91
91
  produced_by: [conductor]
92
92
  signs_off: [conductor]
93
- sign_off_policy: den
93
+ sign_off_policy: user
94
94
  classify_required: true
95
95
  retryable: false
96
96