feat(brain): register project-agents delegation rule (Pravila §2.4 + CLAUDE.md §3.9 + registry #84/#85)

Level 1 + Level 2 of agent auto-invocation: Level 1 — нормативный контракт: - Pravila §2.4 (new) — controller MUST delegate to project agents: * normative-sync (#84) after big task closure (4-file sync trigger) * prod-deploy-validator (#85) before any liderra.ru deploy * pest-parallel-debugger / rls-reviewer — prior project agents formalized in same table - CLAUDE.md §3.9 (new) — operational map index of all 4 project agents Level 2 — наблюдатель (missed-activation detector): - docs/registry/nodes.yaml +#84 normative-sync, +#85 prod-deploy-validator с subcategory: "project-agent" + agent_file: attribute - triggers.classification: "normative_sync_needed" / "prod_deploy_imminent" автоматически подхватываются registry-to-classification-map.mjs runtime; deprecated observer-classification-map.json не правится. - tools/registry-load.test.mjs fixtures: 83→85 / 75→77 active Tooling канон счётчиков НЕ изменился (#1-#83 остаётся; project-агенты вне Tooling). Spec: docs/superpowers/specs/2026-05-24-controller-offload-agents-design.md. Headers: Pravila v1.39→v1.40, CLAUDE.md v2.27→v2.28. Level 3 (hooks) — defer; level 1+2 покрывают первый раунд автоматизации. Also: +6 cspell words for new vocabulary in normative paragraphs. Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
2026-05-24 17:10:28 +03:00
parent 9fa5ca1a86
commit c7f603aa75
5 changed files with 97 additions and 8 deletions
@@ -1721,6 +1721,14 @@ FNS
 NTFS
 маппинге
 dogfooded
+
+# Controller-offload agents level 1+2 (24.05.2026)
+бинари
+ребейзе
+dok
+аддон
+синкни
+фейл
 пинуются
 маунт
 pgrep
@@ -1,10 +1,12 @@
 # Правила работы Claude в проекте «Лидерра»

-**Версия:** v1.39 (22.05.2026)
-**Дата:** 22.05.2026
+**Версия:** v1.40 (24.05.2026)
+**Дата:** 24.05.2026
 **Назначение:** настройки проекта (Project instructions) — Claude читает этот файл в каждом чате и следует правилам ниже.
 **Статус документа:** ✅ утверждён. Содержимое скопировано в поле "Project instructions" Claude.ai. Файл хранится в архиве как служебный документ.

+**Что изменилось в v1.40 относительно v1.39:** Делегирование проектным AI-агентам — §2.4 (новая подсекция) описывает обязанность контроллера передавать класс задач 4 узко-специализированным агентам в `.claude/agents/`: `normative-sync` (#84, синк 4 нормативных файлов после крупной задачи), `prod-deploy-validator` (#85, 8 SSH pre-flight перед выкатом на liderra.ru), плюс прежние `pest-parallel-debugger` и `rls-reviewer`. Project-агенты регистрируются в `docs/registry/nodes.yaml` (subcategory `project-agent`) для missed-activation детектора, но **не входят в Tooling канон счётчиков** #1-#83 (footer-числа не двигаются). Архитектурных изменений §§1, §3–§16: 0. Связано: CLAUDE.md v2.28+ (§3.9), spec `docs/superpowers/specs/2026-05-24-controller-offload-agents-design.md`, agent files `.claude/agents/{normative-sync,prod-deploy-validator}.md`.
+
 **Что изменилось в v1.39 относительно v1.38:** C1 marketing-tooling — §13.2 +абзац «Off-phase marketing-tooling»: #74 marketing (Anthropic, первичный решатель C1), #75 marketingskills (вендорен MIT, материал/резерв), #76 brand-voice (Anthropic, вербальный бренд), #77 marketing-ru (self-authored project-скил, РФ-специфика + 152-ФЗ маркетинг), #78 Яндекс.Метрика MCP (READ-ONLY), #79 Яндекс.Директ+Wordstat MCP (**Wordstat-only**, Direct-мутации отключены per IS9), #80 Telegram MCP, #81 Postiz (self-host, AGPL-3.0 internal), #82 DataForSEO (**DEFERRED**, pending Б-1/бюджет), #83 Unisender Go (**DEFERRED**, pending согласования + 152-ФЗ). 18-я off-phase подкатегория, раздел C1. Не UI → вне R6.0/R6.1/R14. Границы — ADR-015. Счётчики — канон Tooling §0. Архитектурных изменений §§1–12, §14–§16: 0. Связано: Tooling v2.23+, PSR_v1 v3.22+, CLAUDE.md v2.27+; план `docs/superpowers/plans/2026-05-22-c1-marketing-tooling.md`.

 **Что изменилось в v1.38 относительно v1.37:** A8 infosec install-sync — ZAP #68 + Ward #70 установлены портативно 21.05.2026 (без choco, по выбору заказчика «оба портативно») → в §13.2 абзаце «Off-phase infosec-tooling» статус **PENDING INSTALL снят** для обоих (ZAP: ZAP 2.17.0 + MCP-аддон на portable Temurin JRE 17; Ward: собран portable Go → `bin/ward.exe` v0.4.1); setup-доки `docs/security/{zap,ward}-setup.md`. Архитектурных изменений §§1–16: 0. Связано: Tooling v2.21, PSR_v1 v3.21, CLAUDE.md v2.25; план `docs/superpowers/plans/2026-05-21-a8-infosec-tooling.md`.
@@ -238,6 +240,27 @@ Claude — **системный архитектор-документалист*
 - Не продолжает работу при обнаружении противоречия между файлами архива «молча» — всегда сообщает заказчику.
 - Не загружает в контекст всю документацию v8.0+ целиком — обращается по разделам через `project_knowledge_search`.

+### 2.4. Делегирование проектным AI-агентам (v1.40)
+
+В `.claude/agents/` лежат проектные AI-агенты (Sonnet 4.6, узко-специализированные). Контроллер ОБЯЗАН делегировать им следующие классы задач:
+
+| Условие | Агент | Brief-фраза заказчика-триггер |
+|---------|-------|-------------------------------|
+| Закрытие крупной off-phase интеграции / brain governance артефакта / принятого ADR — синк 4 нормативных файлов (Pravila / PSR_v1 / Tooling / CLAUDE.md) | `normative-sync` (#84, [agent file](../.claude/agents/normative-sync.md), [spec §3](superpowers/specs/2026-05-24-controller-offload-agents-design.md)) | «синкни нормативку», «закрыли X — нужен синк» |
+| Любой выкат на боевой `liderra.ru` (push с миграциями, scp-патч, ручной деплой) — 8 pre-flight SSH проверок | `prod-deploy-validator` (#85, [agent file](../.claude/agents/prod-deploy-validator.md), [spec §4](superpowers/specs/2026-05-24-controller-offload-agents-design.md)) | «проверь готовность боевого», «ready to deploy» |
+| Диагностика Pest 4 `--parallel` failures (квирки 72/73/77) | `pest-parallel-debugger` ([agent file](../.claude/agents/pest-parallel-debugger.md)) | «pest упал на parallel», «классифицируй фейл» |
+| RLS-compliance review при правке `db/schema.sql` или `db/migrations/` | `rls-reviewer` ([agent file](../.claude/agents/rls-reviewer.md)) | «проверь RLS на миграции», «RLS review» |
+
+**Дисциплина делегирования:**
+
+- Контроллер вызывает агента **по триггеру**, не дожидаясь явного запроса заказчика — для `normative-sync` сразу после крупной задачи; для `prod-deploy-validator` обязательно ДО любых SSH-команд на боевой.
+- Заказчик может явно отменить вызов («не зови сейчас X»). Live-отмена — только на текущее действие.
+- Если агент возвращает эскалацию — контроллер передаёт её заказчику без угадывания, не пытается обойти.
+- Project-агенты **не входят в Tooling Прил. Н канон счётчиков** (#1-#83 — реестр инструментов; project-агенты идут #84+ в `docs/registry/nodes.yaml` с подкатегорией `project-agent`). Footer-счётчики «N формализованных» изменяются только при добавлении в Tooling-канон, не при добавлении project-агента.
+- Полный perimeter / триггеры / границы — в `description`-frontmatter каждого агент-файла. Это первичный источник «когда звать»; настоящая таблица — индекс контракта, не дублирующая декларация.
+
+**Naming-convention:** `agent_file: ".claude/agents/<slug>.md"` атрибут в `docs/registry/nodes.yaml` маркирует узел как project-агент (отличает от Tooling-инструментов, у которых `tooling_section` атрибут).
+
 ---

 ## 3. Формат ответов и работы с файлами
@@ -1546,6 +1546,48 @@ nodes:
    attributes:
      tooling_section: "§4.58 #83"

+  - id: "#84"
+    name: "normative-sync"
+    slug: "normative-sync"
+    category: "off-phase"
+    subcategory: "project-agent"
+    status: "active"
+    dormancy_reason: null
+    triggers:
+      - {classification: "normative_sync_needed", weight: 1.0}
+      - {keyword: "синкни нормативку", weight: 1.0}
+      - {keyword: "нормативный синк", weight: 1.0}
+      - {keyword: "закрыли задачу синк", weight: 0.9}
+    boundaries:
+      - {relation: "Контроллер обязан звать после закрытия крупной off-phase интеграции, brain governance артефакта, принятого ADR — Pravila §2.4"}
+      - {pair: "#85", relation: "Парный project-агент — оба не входят в Tooling-канон счётчиков (#1-#83), это .claude/agents/ файлы"}
+    chain_membership: []
+    attributes:
+      agent_file: ".claude/agents/normative-sync.md"
+      spec: "docs/superpowers/specs/2026-05-24-controller-offload-agents-design.md §3"
+      tooling_section: null
+
+  - id: "#85"
+    name: "prod-deploy-validator"
+    slug: "prod-deploy-validator"
+    category: "off-phase"
+    subcategory: "project-agent"
+    status: "active"
+    dormancy_reason: null
+    triggers:
+      - {classification: "prod_deploy_imminent", weight: 1.0}
+      - {keyword: "готовность боевого", weight: 1.0}
+      - {keyword: "проверь прод", weight: 1.0}
+      - {keyword: "ready to deploy", weight: 1.0}
+    boundaries:
+      - {relation: "Контроллер обязан звать перед любым выкатом на liderra.ru — Pravila §2.4. READ-ONLY по дизайну."}
+      - {pair: "#84", relation: "Парный project-агент"}
+    chain_membership: []
+    attributes:
+      agent_file: ".claude/agents/prod-deploy-validator.md"
+      spec: "docs/superpowers/specs/2026-05-24-controller-offload-agents-design.md §4"
+      tooling_section: null
+
 chains:
  L1:
    name: "feature discovery & implementation chain"
@@ -5,9 +5,9 @@ import { loadRegistry, clearCache, findByClassification, findByKeyword, findActi
 describe('registry-load', () => {
  beforeEach(() => clearCache());

-  it('loads registry (83 nodes after task 8d)', () => {
+  it('loads registry (85 nodes after #84/#85 project-agents added 24.05.2026)', () => {
    const r = loadRegistry();
-    expect(r.nodes).toHaveLength(83);
+    expect(r.nodes).toHaveLength(85);
    expect(r.version).toBe('0.1.0');
  });

@@ -46,8 +46,9 @@ describe('registry-load', () => {
  it('findActiveNodes excludes non-active', () => {
    const r = loadRegistry();
    const active = findActiveNodes(r);
-    // After task 8d: 83 nodes total; #1 historic, #17 dormant, #44/#50/#54/#67/#82/#83 deferred → 75 active
-    expect(active).toHaveLength(75);
+    // 85 nodes total; #1 historic, #17 dormant, #44/#50/#54/#67/#82/#83 deferred,
+    // #84/#85 (project-agents added 24.05.2026) are active → 75 + 2 = 77 active
+    expect(active).toHaveLength(77);
    expect(active.map(n => n.id)).toContain('#18');
    expect(active.map(n => n.id)).toContain('#19');
    expect(active.map(n => n.id)).not.toContain('#1');