code-ai-installer 2.3.0 → 2.4.1

package/.agents/skills/karpathy-guidelines/SKILL.md

@@ -0,0 +1,326 @@
+---
+name: karpathy-guidelines
+description: Правила работы для предотвращения типичных ошибок LLM — сначала думай, делай только нужное, правь точечно, работай от результата.
+license: MIT
+source: https://x.com/karpathy/status/2015883857489522876
+---
+
+# Karpathy Guidelines
+
+Правила работы, основанные на наблюдениях Андрея Карпати о типичных ошибках LLM.
+
+> Эти правила ставят аккуратность выше скорости. Для совсем тривиальных задач используй здравый смысл.
+
+---
+
+## 1. Сначала думай, потом делай
+
+**Не предполагай молча. Не скрывай неопределённость. Называй альтернативы.**
+
+Перед тем как приступить:
+- Явно назови свои предположения. Если не уверен — спроси.
+- Если задачу можно понять по-разному — перечисли варианты, не выбирай сам.
+- Если есть более простой путь — скажи об этом. Возражай, когда это уместно.
+- Если что-то непонятно — остановись, назови конкретно что, и спроси.
+
+### Пример: скрытые предположения
+
+**Запрос:** "Добавь экспорт пользовательских данных"
+
+❌ **Что делают LLM** — молча предполагают формат, поля и объём:
+
+```python
+def export_users(format='json'):
+    users = User.query.all()
+    with open('users.json', 'w') as f:
+        json.dump([u.to_dict() for u in users], f)
+    return f"Exported {len(users)} users"
+```
+
+✅ **Как надо** — сначала назвать предположения и уточнить:
+
+```
+Прежде чем делать, нужно прояснить:
+
+1. Кого экспортировать: всех пользователей или отфильтрованных? (вопрос приватности)
+2. Что значит "экспорт": скачать файл, фоновая задача с уведомлением или API endpoint?
+3. Какие поля включать? (часть данных может быть чувствительной)
+4. Сколько пользователей обычно? (влияет на архитектуру)
+
+Что из этого важнее всего?
+```
+
+### Пример: несколько трактовок
+
+**Запрос:** "Ускорь поиск"
+
+❌ **Что делают LLM** — выбирают одну трактовку и пишут 200 строк оптимизации.
+
+✅ **Как надо:**
+
+```
+"Ускорить поиск" — это может быть разное:
+
+1. Уменьшить время ответа (< 100 мс вместо 500 мс)
+   → индексы в БД, кеш частых запросов | ~2 часа
+
+2. Выдерживать больше одновременных запросов
+   → async/await, connection pooling | ~4 часа
+
+3. Субъективно казаться быстрее (UX)
+   → показывать частичные результаты сразу | ~3 часа
+
+Сейчас поиск занимает ~500 мс. Что важнее?
+```
+
+---
+
+## 2. Делай только то, что просили
+
+**Минимум, решающий задачу. Ничего лишнего.**
+
+- Не добавляй возможности сверх того, что просили.
+- Не создавай абстракции, если код используется один раз.
+- Не делай код "гибким" и "настраиваемым" без запроса.
+- Не обрабатывай ошибки, которые не могут случиться.
+- Написал 200 строк, а можно 50 — перепиши.
+
+Спроси себя: "Сказал бы опытный коллега, что это переусложнено?" Если да — упрости.
+
+### Пример: лишние абстракции
+
+**Запрос:** "Добавь функцию расчёта скидки"
+
+❌ **Что делают LLM** — Strategy pattern, ABC, dataclass, конфигуратор:
+
+```python
+class DiscountStrategy(ABC):
+    @abstractmethod
+    def calculate(self, amount: float) -> float: pass
+
+class PercentageDiscount(DiscountStrategy):
+    def __init__(self, percentage: float):
+        self.percentage = percentage
+    def calculate(self, amount: float) -> float:
+        return amount * (self.percentage / 100)
+
+@dataclass
+class DiscountConfig:
+    strategy: DiscountStrategy
+    min_purchase: float = 0.0
+    max_discount: float = float('inf')
+
+# Ещё 40 строк ради одной формулы
+```
+
+✅ **Как надо:**
+
+```python
+def calculate_discount(amount: float, percent: float) -> float:
+    """Calculate discount amount. percent should be 0-100."""
+    return amount * (percent / 100)
+```
+
+Усложнять — только когда реально появится несколько типов скидок.
+
+### Пример: возможности "на будущее"
+
+**Запрос:** "Сохрани пользовательские настройки в БД"
+
+❌ **Что делают LLM** — кеш, валидатор, флаг merge, уведомления:
+
+```python
+class PreferenceManager:
+    def __init__(self, db, cache=None, validator=None):
+        ...
+    def save(self, user_id, prefs, merge=True, validate=True, notify=False):
+        # 50 строк вместо трёх
+```
+
+✅ **Как надо:**
+
+```python
+def save_preferences(db, user_id: int, preferences: dict):
+    db.execute(
+        "UPDATE users SET preferences = ? WHERE id = ?",
+        (json.dumps(preferences), user_id)
+    )
+```
+
+Кеш, валидацию, merge — добавить тогда, когда это реально понадобится.
+
+---
+
+## 3. Трогай только то, что нужно
+
+**Правь минимум. Чисти только за собой.**
+
+При редактировании существующего кода:
+- Не "улучшай" соседний код, комментарии или форматирование.
+- Не рефактори то, что работает.
+- Сохраняй существующий стиль, даже если ты сделал бы иначе.
+- Заметил лишний код рядом — упомяни, но не трогай.
+
+Если после твоих правок что-то стало неиспользуемым:
+- Удали то, что стало ненужным из-за твоих изменений.
+- Не трогай уже существующий мёртвый код без запроса.
+
+**Проверка:** каждая изменённая строка должна напрямую относиться к запросу.
+
+### Пример: попутный рефакторинг
+
+**Запрос:** "Исправь баг — пустой email вызывает падение валидатора"
+
+❌ **Что делают LLM** — заодно улучшают валидацию email, добавляют валидацию username, меняют комментарии, пишут docstring.
+
+✅ **Как надо — только строки, связанные с пустым email:**
+
+```diff
+  def validate_user(user_data):
+      # Check email format
+-     if not user_data.get('email'):
++     email = user_data.get('email', '')
++     if not email or not email.strip():
+          raise ValueError("Email required")
+
+      # Basic email validation
+-     if '@' not in user_data['email']:
++     if '@' not in email:
+          raise ValueError("Invalid email")
+
+      # Check username  ← не трогаем, это не в задаче
+      if not user_data.get('username'):
+          raise ValueError("Username required")
+
+      return True
+```
+
+### Пример: дрейф стиля
+
+**Запрос:** "Добавь логирование в функцию upload"
+
+❌ **Что делают LLM** — заодно добавляют type hints, меняют одинарные кавычки на двойные, пишут docstring, переформатируют отступы.
+
+✅ **Как надо — сохраняй существующий стиль:**
+
+```diff
++ import logging
++
++ logger = logging.getLogger(__name__)
++
+  def upload_file(file_path, destination):
++     logger.info(f'Starting upload: {file_path}')
+      try:
+          with open(file_path, 'rb') as f:
+              data = f.read()
+
+          response = requests.post(destination, files={'file': data})
+
+          if response.status_code == 200:
++             logger.info(f'Upload successful: {file_path}')
+              return True
+          else:
++             logger.error(f'Upload failed: {file_path}, status={response.status_code}')
+              return False
+      except Exception as e:
+-         print(f"Error: {e}")
++         logger.exception(f'Upload error: {file_path}')
+          return False
+```
+
+Сохранено: одинарные кавычки, нет type hints, тот же стиль boolean-возврата.
+
+---
+
+## 4. Работай от результата
+
+**Определи, как выглядит "готово". Проверяй каждый шаг.**
+
+Переформулируй задачи в проверяемые цели:
+- "Добавь валидацию" → "Напиши тесты на некорректные данные, затем сделай их зелёными"
+- "Исправь баг" → "Напиши тест, воспроизводящий баг, затем исправь"
+- "Рефакторинг X" → "Убедись, что тесты проходят до и после"
+
+Для многошаговых задач — кратко опиши план:
+
+```
+1. [Шаг] → проверка: [что проверить]
+2. [Шаг] → проверка: [что проверить]
+3. [Шаг] → проверка: [что проверить]
+```
+
+Чёткие критерии дают возможность работать самостоятельно. Размытые ("сделай так, чтобы работало") требуют постоянных уточнений.
+
+### Пример: пошаговая реализация с проверкой
+
+**Запрос:** "Добавь rate limiting в API"
+
+❌ **Что делают LLM** — реализуют Redis, несколько стратегий, конфигурацию и мониторинг в одном PR на 300 строк без чётких шагов проверки.
+
+✅ **Как надо:**
+
+```
+План:
+
+1. Базовый лимит в памяти (один endpoint)
+   Проверка: 100 запросов → первые 10 проходят, остальные получают 429
+
+2. Вынести в middleware (все endpoints)
+   Проверка: существующие тесты не сломались
+
+3. Redis вместо памяти (для нескольких серверов)
+   Проверка: лимит сохраняется после перезапуска
+
+4. Настройка лимитов per-endpoint
+   Проверка: /search — 10/мин, /users — 100/мин
+
+Начинаем с первого шага?
+```
+
+### Пример: сначала воспроизведи баг
+
+**Запрос:** "Сортировка ломается при одинаковых значениях"
+
+❌ **Что делают LLM** — сразу меняют логику сортировки, не убедившись, что воспроизвели проблему.
+
+✅ **Как надо:**
+
+```python
+# 1. Сначала — тест, воспроизводящий баг
+def test_sort_with_duplicate_scores():
+    scores = [
+        {'name': 'Alice', 'score': 100},
+        {'name': 'Bob', 'score': 100},
+        {'name': 'Charlie', 'score': 90},
+    ]
+    result = sort_scores(scores)
+    # Проблема: при одинаковых score порядок непредсказуем
+    assert result[0]['score'] == 100
+    assert result[2]['score'] == 90
+    assert result[0]['name'] < result[1]['name']  # ожидаем стабильную сортировку
+
+# Запускаем тест → он падает → баг подтверждён
+
+# 2. Только теперь исправляем
+def sort_scores(scores):
+    return sorted(scores, key=lambda x: (-x['score'], x['name']))
+
+# Запускаем тест → зелёный
+```
+
+---
+
+## Сводка: что делать нельзя
+
+| Принцип | Типичная ошибка | Правильно |
+|---|---|---|
+| Сначала думай | Молча выбирает формат, поля, трактовку задачи | Называет предположения явно, спрашивает |
+| Делай только то, что просили | Strategy pattern ради одного расчёта | Одна функция — и точка |
+| Трогай только то, что нужно | Правит кавычки и добавляет типы при фиксе бага | Меняет только строки, касающиеся задачи |
+| Работай от результата | "Проанализирую и улучшу" | "Тест воспроизводит баг → исправляю → проверяю регрессии" |
+
+## Главный вывод
+
+Переусложнённые решения не выглядят явно неправильными — они следуют паттернам и best practices. Проблема в **моменте**: сложность добавляется раньше, чем она реально нужна.
+
+**Хорошее решение — это минимум, который решает задачу сегодня, а не задачу, которая, возможно, появится завтра.**

package/.agents/skills/karpathy-guidelines/agents/claude.json

@@ -0,0 +1,21 @@
+{
+  "name": "karpathy-guidelines",
+  "display_name": "Karpathy Guidelines",
+  "description": "Правила работы для предотвращения типичных ошибок LLM — сначала думай, делай только нужное, правь точечно, работай от результата.",
+  "default_prompt": "Используй $karpathy-guidelines, когда задача требует соблюдения правил качества: написание кода, ревью, рефакторинг, анализ или проектирование.",
+  "triggers": [
+    "karpathy-guidelines",
+    "karpathy",
+    "Karpathy Guidelines",
+    "сначала думай потом делай",
+    "простота прежде всего",
+    "хирургические изменения"
+  ],
+  "capabilities": [
+    "quality",
+    "guidelines",
+    "best-practices"
+  ],
+  "tools": [],
+  "implicit_invocation": true
+}

package/.agents/skills/karpathy-guidelines/agents/copilot.json

@@ -0,0 +1,21 @@
+{
+  "name": "karpathy-guidelines",
+  "display_name": "Karpathy Guidelines",
+  "description": "Правила работы для предотвращения типичных ошибок LLM — сначала думай, делай только нужное, правь точечно, работай от результата.",
+  "default_prompt": "Используй $karpathy-guidelines, когда задача требует соблюдения правил качества: написание кода, ревью, рефакторинг, анализ или проектирование.",
+  "triggers": [
+    "karpathy-guidelines",
+    "karpathy",
+    "Karpathy Guidelines",
+    "сначала думай потом делай",
+    "простота прежде всего",
+    "хирургические изменения"
+  ],
+  "capabilities": [
+    "quality",
+    "guidelines",
+    "best-practices"
+  ],
+  "tools": [],
+  "implicit_invocation": true
+}

package/.agents/skills/karpathy-guidelines/agents/gemini.json

@@ -0,0 +1,21 @@
+{
+  "name": "karpathy-guidelines",
+  "display_name": "Karpathy Guidelines",
+  "description": "Правила работы для предотвращения типичных ошибок LLM — сначала думай, делай только нужное, правь точечно, работай от результата.",
+  "default_prompt": "Используй $karpathy-guidelines, когда задача требует соблюдения правил качества: написание кода, ревью, рефакторинг, анализ или проектирование.",
+  "triggers": [
+    "karpathy-guidelines",
+    "karpathy",
+    "Karpathy Guidelines",
+    "сначала думай потом делай",
+    "простота прежде всего",
+    "хирургические изменения"
+  ],
+  "capabilities": [
+    "quality",
+    "guidelines",
+    "best-practices"
+  ],
+  "tools": [],
+  "implicit_invocation": true
+}

package/.agents/skills/karpathy-guidelines/agents/openai.yaml

@@ -0,0 +1,8 @@
+interface:
+  display_name: "Karpathy Guidelines"
+  short_description: "Поведенческие правила для снижения типичных ошибок LLM — думай перед тем как делать, простота, хирургические изменения, ориентация на цель."
+  default_prompt: "Используй $karpathy-guidelines, когда задача требует соблюдения правил качества: написание кода, ревью, рефакторинг, анализ или проектирование."
+dependencies:
+  tools: []
+policy:
+  allow_implicit_invocation: true

package/.agents/skills/karpathy-guidelines/agents/qwen.json

@@ -0,0 +1,21 @@
+{
+  "name": "karpathy-guidelines",
+  "display_name": "Karpathy Guidelines",
+  "description": "Правила работы для предотвращения типичных ошибок LLM — сначала думай, делай только нужное, правь точечно, работай от результата.",
+  "default_prompt": "Используй $karpathy-guidelines, когда задача требует соблюдения правил качества: написание кода, ревью, рефакторинг, анализ или проектирование.",
+  "triggers": [
+    "karpathy-guidelines",
+    "karpathy",
+    "Karpathy Guidelines",
+    "сначала думай потом делай",
+    "простота прежде всего",
+    "хирургические изменения"
+  ],
+  "capabilities": [
+    "quality",
+    "guidelines",
+    "best-practices"
+  ],
+  "tools": [],
+  "implicit_invocation": true
+}

package/.agents/skills/karpathy-guidelines/agents/skill.yaml

@@ -0,0 +1,25 @@
+version: 1
+name: "karpathy-guidelines"
+display_name: "Karpathy Guidelines"
+description: "Правила работы для предотвращения типичных ошибок LLM — сначала думай, делай только нужное, правь точечно, работай от результата."
+default_prompt: "Используй $karpathy-guidelines, когда задача требует соблюдения правил качества: написание кода, ревью, рефакторинг, анализ или проектирование."
+triggers:
+  - "karpathy-guidelines"
+  - "karpathy"
+  - "Karpathy Guidelines"
+  - "сначала думай потом делай"
+  - "простота прежде всего"
+  - "хирургические изменения"
+capabilities:
+  - "quality"
+  - "guidelines"
+  - "best-practices"
+tools: []
+invocation:
+  explicit: true
+  implicit: true
+localization:
+  default_locale: "ru"
+  available_locales:
+    - "ru"
+    - "en"

package/AGENTS.md

@@ -117,6 +117,9 @@
 - $security-baseline-dev
 - $compass-mongodb
 
+### Cross-cutting / Quality (все агенты, все домены)
+- $karpathy-guidelines
+
 ### Testing (QA)
 - $qa-test-plan
 - $qa-manual-run
@@ -148,6 +151,16 @@ CONDUCTOR → DEV+TEST(Fix + self-check + GO/NO-GO)
 
 ---
 
+## Обязательное правило качества (Karpathy Guidelines)
+
+**$karpathy-guidelines обязателен для всех агентов во всех доменах.** Перед любой нетривиальной задачей:
+1. **Сначала думай, потом делай** — явно называй предположения, спрашивай при неопределённости.
+2. **Делай только то, что просили** — минимум, решающий задачу. Ничего лишнего.
+3. **Правь точечно** — трогай только то, что необходимо для задачи.
+4. **Работай от результата** — определи проверяемые критерии успеха до начала работы.
+
+---
+
 ## Обязательное правило документации функций
 - Для всех функций в кодовой базе использовать JSDoc-блок в формате:
 

package/CONTEXT.md

@@ -4,9 +4,9 @@
 |------|----------|
 | **Название** | code-ai-installer |
 | **Описание** | CLI для установки AI-агентов и скилов для множества AI-ассистентов |
-| **Текущая фаза** | v2.1.0 — Socket.dev Supply-Chain Integration |
+| **Текущая фаза** | v2.4.1 — Domain karpathy fix + Gemini agent rename |
 | **Дата создания** | 2026-03-01 |
-| **Последнее обновление** | 2026-04-08 |
+| **Последнее обновление** | 2026-04-29 |
 
 ---
 
@@ -45,13 +45,18 @@
 - DomainId strict enum + zod validation
 - domainResolver.ts: listDomains, resolveDomainSourceRoot, normalizeDomain
 - sourceResolver.ts: расширена isValidSourceRoot для domains/ layout
-- installer.ts: domain-aware state file naming (target--domain.json)
+- installer.ts: domain-aware state file naming (target--domain.json) + Gemini prompt.md → `<agent>.md` migration (v2.4.1)
 - index.ts: --domain flag на всех CLI командах, wizard domain step
-- domains/development/: зеркало корня (8 agents, 71 skills, 5 workflows)
-- domains/content/: новый домен (6 agents, 30 skills, 4 workflows)
-- Локали en/ для обоих доменов
-- package.json: v2.0.0, "domains" в files array
-- 93 теста (86 existing + 7 new), все GREEN
+- domains/development/: 8 agents, 72 skills (включая karpathy-guidelines), 5 workflows
+- domains/content/: 6 agents, 35 skills, 4 workflows
+- domains/analytics/: 8 agents, 24 skills
+- domains/product/: 10 agents, 33 skills
+- Локали en/ для всех 4 доменов
+- karpathy-guidelines: cross-cutting skill, mandatory for all agents in all domains (v2.4.1 fix: добавлен в `domains/<id>/`)
+- Gemini layout: `<agentsDir>/<agentName>/<agentName>.md` (v2.4.1, было `prompt.md` до v2.4.0)
+- agentSkillResolution регрессионный тест: ловит broken `$skill-name` ссылки из агентов
+- package.json: v2.4.1, "domains" в files array
+- 102 теста, все GREEN
 - Build (tsc): 0 errors
 
 ### В процессе
@@ -80,3 +85,4 @@
 | Session 3 | 2026-04-04 | Gates 4-8: DEV + REV + OPS + TEST + RG | src/domainResolver.ts, domains/, package.json v2.0.0 |
 | Hotfix v2.0.2 | 2026-04-08 | Bugfix + защита от регрессии: (1) 30 content-domain скиллов имели расхождения `description` между SKILL.md frontmatter и портабл/вендор sidecar — приведено к SKILL.md (источник истины), 150 файлов обновлено. (2) 4 скилла (`email-engagement-tiers`, `google-stitch-content`, `mailerlite-email-ops`, `marketing-psychology`) шипились без sidecar — сгенерированы 24 файла (skill.yaml + claude/copilot/gemini/qwen.json + openai.yaml). (3) Test gap: единственный test против реальных файлов смотрел только на легаси-корень репо (= development domain), content domain был слепой. Добавлен `metadataAudit.test.ts → "should pass audit for every domain × every target"` — итерируется по `listDomains() × 5 targets`. (4) `package.json prepack` теперь запускает `doctor:all` (`development` + `content`) — `npm publish` не сможет запаковать сломанный пакет. 94/94 теста зелёные, doctor PASS на всех 5 targets без warnings. **Не публиковался отдельно — все изменения вошли в v2.1.0.** | См. v2.1.0 |
 | Feature v2.1.0 | 2026-04-08 | **Socket.dev Supply-Chain Integration**. Bugfix-pipeline (CONDUCTOR → ARCH lite → DEV → REV → TEST) с user sign-off на каждом гейте. Изменения: (1) `dependency-supply-chain-review` skill v2.0 — добавлена секция «0. Prerequisites» с обязательным `socket-mcp` (HTTP по умолчанию, stdio для paid аккаунтов), detection protocol, degraded mode protocol; новая секция «9. Socket.dev Integration» с `depscore` workflow и threshold matrix (supply_chain≥0.75, vulnerability≥0.80, license≥0.50); checklist 3.2 расширен DEP-05a/05b/05c/05d (P0); Output Template обновлён блоком Socket.dev Audit. (2) Reviewer agent: добавлен socket-mcp в Входы, обязательный принцип supply chain через socket.dev в Главные принципы, поле `SOCKET.DEV MODE` в Handoff Envelope. (3) Senior Full Stack agent: новый принцип #11 (pre-install gate), шаг в Security Baseline, новый DoD пункт, поле `SOCKET.DEV PRE-INSTALL` в Handoff Envelope. (4) RU + EN локали зеркальны. (5) 12 sidecar файлов синхронизированы (RU + EN × 6 файлов). (6) Bonus: фиксы из v2.0.2 (sidecar metadata + regression test + prepack:doctor:all) включены в этот же релиз. P0 алерты от socket.dev блокируют установку до явного подтверждения. Degraded mode (socket-mcp недоступен) — review не блокируется, но статус фиксируется. | package.json v2.1.0, domains/development/.agents/skills/dependency-supply-chain-review/**, domains/development/agents/{reviewer,senior_full_stack}.md, domains/content/** (sidecar fixes из v2.0.2), src/__tests__/metadataAudit.test.ts |
+| Bugfix v2.4.1 | 2026-04-29 | **Domain karpathy fix + Gemini agent rename**. Bugfix-pipeline (CONDUCTOR → DEV → REV → TEST → RG) с user sign-off на каждом гейте. **Часть A — karpathy в доменах:** v2.4.0 поставил `$karpathy-guidelines` в легаси-корень репо, но забыл скопировать папку скила в `domains/<id>/.agents/skills/`, при этом 32 файла агентов в доменах уже ссылались на скил. При установке через `--domain <id>` скил физически отсутствовал. Скил скопирован в 4 домена × 2 локали (56 файлов), секция «Cross-cutting / Quality» добавлена в 8 файлов AGENTS.md. **Часть B — Gemini agent rename:** до v2.4.1 Gemini-адаптер ставил агентов как `<agentsDir>/<agentName>/prompt.md`, теперь как `<agentsDir>/<agentName>/<agentName>.md`. Добавлена `migrateLegacyGeminiPromptFiles` миграция в `runInstall`: переименовывает legacy `prompt.md` → `<agentName>.md` (сохраняя user-customized content под skip mode), патчит `promptFile` поле в legacy `config.json`, чистит orphan файлы. Идемпотентна, под backup/rollback covered. **Часть C — регрессионный тест:** новый `agentSkillResolution.test.ts` проверяет резолвимость каждого `$skill-name` из агентов в существующую папку скила домена. Тест нашёл 2 пре-существующих бага: (1) литеральный `$skill-name` плейсхолдер в `analytics/data_analyst.md` (RU+EN) — заменён на `` `<skill-name>` ``; (2) `$google-stitch` → `$google-stitch-skill` в `development/ux_ui_designer.md` (RU+EN). **Verification:** 102/102 тестов PASS, doctor:all PASS на всех 4 доменах × 5 targets, end-to-end smoke-install gemini target в tmp подтвердил миграцию с user customizations preserved. | package.json v2.4.1, domains/{development,content,analytics,product}/.agents/skills/karpathy-guidelines/**, domains/{...}/locales/en/.agents/skills/karpathy-guidelines/**, domains/{...}/AGENTS.md (RU+EN), src/installer.ts, src/platforms/adapters.ts, src/__tests__/agentSkillResolution.test.ts (NEW), src/__tests__/installer.test.ts, src/__tests__/domainIntegration.test.ts |

package/agents/architect.md

@@ -273,6 +273,7 @@
 ---
 
 ## Используемые skills (вызовы)
+- **$karpathy-guidelines** — сначала думай, делай только нужное, правь точечно, работай от результата
 - $current-state-analysis
 - $system-design-checklist
 - $architecture-doc

package/agents/conductor.md

@@ -275,6 +275,7 @@
 ---
 
 ## Используемые skills (вызовы)
+- **$karpathy-guidelines** — сначала думай, делай только нужное, правь точечно, работай от результата
 - $board
 - $handoff
 - $memory

package/agents/devops.md

@@ -193,6 +193,7 @@ lint → typecheck → unit tests → integration tests → build → deploy (st
 ---
 
 ## Используемые skills (вызовы)
+- **$karpathy-guidelines** — сначала думай, делай только нужное, правь точечно, работай от результата
 - $deployment-ci-plan
 - $docker-kubernetes-architecture
 - $k8s-manifests-conventions

package/agents/product_manager.md

@@ -122,6 +122,7 @@ PRD должен содержать:
 ---
 
 ## Используемые skills (вызовы)
+- **$karpathy-guidelines** — сначала думай, делай только нужное, правь точечно, работай от результата
 - $pm-interview
 - $pm-prd
 - $pm-backlog

package/agents/reviewer.md

@@ -154,6 +154,7 @@ Reviewer обязан выдать отчёт, который может исп
 ---
 
 ## Используемые skills (вызовы)
+- **$karpathy-guidelines** — сначала думай, делай только нужное, правь точечно, работай от результата
 - $code-review-checklist
 - $security-review
 - $cloud-infrastructure-security

package/agents/senior_full_stack.md

@@ -170,6 +170,7 @@
 ---
 
 ## Используемые skills (вызовы)
+- **$karpathy-guidelines** — сначала думай, делай только нужное, правь точечно, работай от результата
 - $tdd-workflow
 - $testing-strategy-js
 - $tests-quality-review

package/agents/tester.md

@@ -210,6 +210,7 @@ Tester не обязан писать всю автоматизацию сам,
 ---
 
 ## Используемые skills (вызовы)
+- **$karpathy-guidelines** — сначала думай, делай только нужное, правь точечно, работай от результата
 - $qa-test-plan
 - $qa-manual-run
 - $qa-browser-testing — визуальное E2E через встроенный Antigravity Browser

package/agents/ux_ui_designer.md

@@ -153,6 +153,7 @@
 ---
 
 ## Используемые skills (вызовы)
+- **$karpathy-guidelines** — сначала думай, делай только нужное, правь точечно, работай от результата
 - $ux-discovery
 - $ux-spec
 - $ui-inventory

package/dist/installer.d.ts

@@ -7,6 +7,8 @@ interface ApplyResult {
 }
 /**
  * Runs installation for selected target with optional dry-run and backup.
+ * For target=google-antugravity, runs legacy prompt.md migration before applyOperations
+ * so the migrated <agent>.md ends up under applyOperations' backup/rollback coverage.
  * @param options Install options.
  * @returns Install state and write summary.
  */