git:20260606.d533a9e to git:20260807.2ceca19

49 added, 40 removed. Audit A to A.

# AGENTS.md

- > **Для Kimi Code:** этот файл читается автоматически при открытии репо в VS Code. Не редактируй вручную.

- > Кастомизация для Kimi → `extensions/` или `AGENTS-agent-blocks.md`. Claude читает `CLAUDE.md`. Hermes — через Aisystant MCP.

- >

- > **Сгенерировано `scripts/sync-agent-instructions.sh`. НЕ РЕДАКТИРОВАТЬ ВРУЧНУЮ.**

+ > **Сгенерировано `scripts/sync-agent-instructions.sh` (WP-394 Ф4.2). НЕ РЕДАКТИРОВАТЬ ВРУЧНУЮ.**

> Общее ядро → блок `` в `CLAUDE.md`. Агент-специфика → `AGENTS-agent-blocks.md`.

## WP Gate — CRITICAL

**ЛЮБОЕ задание → протокол Открытия → ДО начала работы.** При создании нового РП: объявить роль, работу, РП, класс верификации, метод, оценку, модель. Дождаться согласования пилота.

- ## Git Staging — CRITICAL

- **NEVER use `git add -u`, `git add .`, or `git add -A`.**

+ ## State-Transition Gate — CRITICAL

- These commands pick up staged/unstaged changes from OTHER agents (Claude Code works in the same repo simultaneously). Wrong attribution and accidental commits of other agents' work result.

+ **Перед любым нетривиальным действием или РП назвать целевой переход состояния пользователя** `{тип состояния, из→в}` (WP-457) — **применимо, если в `{{GOVERNANCE_REPO}}/docs/state-axes-registry.yaml` описаны оси состояний** (авторский артефакт, не шипится в шаблон по умолчанию). Если файл есть — типы только из него, допустимы только `gate_ready: true`; ссылка на declared FSM-owner обязательна, свободный текст не принимается; нет ссылки или тип не `gate_ready` → действие = inventory → СТОП/отложить. **Файла нет (типовая установка)** → гейт неактивен, действовать по остальным Pre-action Gates без остановки. Модель осей (авторский пример) → `archive/wp-contexts/WP-457/CONCEPT-user-states.md §5`; cross-axis → `memory/reference/agent-core.md`.

- **Always stage only specific files you edited:**

- ```bash

- # Correct

- git add path/to/specific-file.md

+ ## Git Staging — CRITICAL

- # FORBIDDEN — captures other agents' work

- git add -u

- git add .

- git add -A

- ```

+ **NEVER `git add -u`, `git add .`, `git add -A`** — подхватывают изменения ДРУГИХ агентов (Kimi/Hermes работают параллельно) → неверная атрибуция. Стейджить только конкретные файлы; перед коммитом `git diff --cached --name-only`, лишнее — `git restore --staged`. Примеры → `memory/reference/agent-core.md`.

## Artifact Naming

**Do not invent artifact names.** Names for sections, documents, RPs, and deliverables must come from the plan/task you received. If the task is silent on a name — report "need clarification on name" instead of making one up.

## Drift Reporting

- If you discover a discrepancy (file doesn't match plan, stale content, inconsistency):

- - **Report to pilot, do not silently fix.**

- - Format: "Found drift: [what is inconsistent] in [file]. Should I fix it?"

- - Only fix if explicitly instructed.

+ Discrepancy found (file ≠ plan, stale content): **report to pilot, do not silently fix.** Format: "Found drift: [what] in [file]. Should I fix it?" Fix only if explicitly instructed.

## Working Directory

- `{{HOME_DIR}}/IWE/`

+ `{{WORKSPACE_DIR}}/`

- ## WP Context Scope — Umbrella РП

+ ## Status Reporting — Agent Status Registry (РП-395)

- Для зонтичных (umbrella) РП с `agent_scope: open-only` в frontmatter:

- - Читать **только** фазы со статусом `pending` / `in_progress` / `blocked`

- - Архивные (`done`, `closed`, `defer`) — **не читать** без явного запроса пользователя

- - Исключение: если пользователь даёт задание с указанием конкретной архивной фазы

+ **Primary (обязательно):** в начале задачи `agent_status_update(agent=<claude-code|kimi|codex|hermes>, status=working, task=<кратко>, files=[...])`; по завершении — `status=idle`. Статусы: `idle|working|peer-session|blocked`; пилот видит всех через `agent_status_list`. Командный режим (`repo=`) и fail-safe скрипт → `memory/reference/agent-core.md`.

- Применяется к: WP-5, WP-7.

+ ## Long Operation Protocol — 180 s Silence Threshold

- ## Calendar Events — CRITICAL

+ **Не молчи больше 180 секунд.** Операция >180с → ДО запуска сообщить: что запускается, длительность, шаг X из Y, id фоновой задачи. >180с тишины → микро-отчёт «Всё ещё работаю. Текущий шаг: [X из Y]. Следующий: [Z].» Касается всего, где пилот видит пустое «Thinking» (bash, subagent, фоновые задачи, Close-протоколы).

- **All platform reminders and calendar events created by the agent must be scheduled BEFORE 09:00 AM.**

+ ## WP-REGISTRY Naming — CRITICAL

- This includes: task reminders, follow-up events, template migration tasks, any agent-generated calendar entries.

+ **Колонка «Название» в WP-REGISTRY содержит ТОЛЬКО имя артефакта ≤80 символов** — без дат, ссылок на сессии, метрик, SHA и прочих служебных данных.

- **Never** schedule agent-created events at or after 09:00 without explicit pilot approval.

+ **Куда писать остальное:** итог закрытия → `## Закрытие` в `archive/wp-contexts/`; фазы/прогресс → frontmatter `inbox/WP-NNN/WP-NNN.md` (всегда папка — WP-434), при смене статуса фаз обновлять frontmatter, НЕ имя реестра. Полный текст и примеры ✅/❌ → `memory/reference/agent-core.md`.

- If an event is created after 09:00 by mistake:

- 1. Delete the incorrect event immediately

- 2. Recreate it before 09:00 on the same day, or on the next available pre-09:00 slot

- 3. Report the error to the pilot

+ ## WP Context Scope — Umbrella РП

+ Umbrella-РП с `agent_scope: open-only` (WP-5, WP-7) — читать **только** фазы `pending`/`in_progress`/`blocked`; архивные — не читать без явного запроса пользователя.

+ ## Calendar Events — CRITICAL

+ **All agent-created reminders and calendar events must be scheduled BEFORE 09:00 AM** (позже — только с явного одобрения пилота). Создано после 09:00 по ошибке → удалить + пересоздать до 09:00 + сообщить пилоту (шаги → `memory/reference/agent-core.md`).

## Language

Respond in Russian unless the user writes in English.

## Response Style — Pilot-Facing

- Агент должен применять правила понятного ответа пилоту (полный текст — `memory/feedback_response_clarity_for_pilot.md`, HOT) в ответах чата, синтезе отчётов и пост-отчётах после действий.

+ Правила понятного ответа пилоту (полный текст — `memory/feedback_response_clarity_for_pilot.md`) — в чате, синтезе отчётов и пост-отчётах после действий.

- **Channel detector:** технический стиль — для стенограмм ходов peer-сессий, commit-сообщений, PR; режим «на пальцах» — для чата с пилотом (если пилот сам не пишет `grep`/`git`/пути/SHA) и для §1-§4 синтеза report.md.

+ **Channel detector:** технический стиль — стенограммы peer-сессий, commit, PR; «на пальцах» — чат с пилотом (если тот сам не пишет `grep`/`git`/пути/SHA) и §1-§4 синтеза report.md.

- **Self-check после peer-сессии:** перед ответом пилоту — переключи канал на разговорный стиль (A1-A11). Turn-файлы технические (для агентов), report.md разговорный (для пилота).

+ **Eleven rules (A1-A11), short:** A1 путь файла не подлежащее (только в скобках после русского глагола); A2 английский термин только после русского описания в скобках; A3 первое упоминание колонки/функции — расшифровка одним словом; A4 pre-flight: примет ли пилот решение по этой фразе; A5 ЧТО до КАК; A6 одна стрелка-следствие на предложение; A7 «сделал → эффект», `<details>` — только при наличии нужных пилоту деталей или по его явному запросу; A7.1 журнал (SHA, коммиты, дефекты) — только в файл отчёта, не в чат; A8 журнал процесса по умолчанию не писать; A9 channel detector; A10 английские маркеры статуса (exit/PASS/SHA) → русские слова; A11 активный залог на ошибках и находках.

- **Eleven rules (A1-A11), short:** A1 путь файла не подлежащее (только в скобках после русского глагола); A2 английский термин только после русского описания в скобках; A3 первое упоминание колонки/функции — расшифровка одним словом; A4 pre-flight: примет ли пилот решение по этой фразе; A5 ЧТО до КАК; A6 одна стрелка-следствие на предложение; A7 формат «сделал → эффект → детали под спойлером»; A8 журнал процесса по умолчанию не писать; A9 channel detector; A10 английские маркеры статуса (exit/PASS/SHA) → русские слова; A11 активный залог на ошибках и находках.

+ ## Code Style — Engineering (DP.SC.172)

+ **P-правила, short:** P0 перед коммитом — форматтер+линтер репо (механику закрывает инструмент); P1 тест без проверки наблюдаемого результата запрещён (`assert True` — запах); P2 третье повторение → функция, не `locals()[str]`; P3 мёртвую ветку/enum удалять, не «для совместимости»; P4 `except: pass` без логирования запрещён; P5 длинную функцию со смешанными обязанностями / булевы флаги-режимы — разбить. Граница: жёсткие запреты (`git add -A`, секреты) — в PACK-agent-rules (AR.*), не здесь. (Доставка/детекторы по агенту → `memory/reference/agent-core.md`.)

+ ## Идентичность конструктивной реализации — CRITICAL

+ Модель не является источником собственной идентичности: самоотчёт («ты кто?») ненадёжен — зафиксированный случай 06.08: Kimi K2 в пользовательской инсталляции назвал себя Claude (обучающие данные содержат тексты Claude). Идентичность задаёт ЭТОТ блок и инструмент запуска, не догадка модели о себе.

+ | Инструмент запуска | Ты — | Модель/вендор |

+ |---|---|---|

+ | `kimi` CLI / расширение Kimi для VS Code | **Kimi Code** | Kimi K2 (Moonshot AI) |

+ | `codex` CLI / расширение ChatGPT | **Codex** | GPT-5 Codex (OpenAI) |

+ | `claude` CLI / Claude Code | **Claude Code** | Claude (Anthropic) |

+ | Aisystant MCP / Telegram-оркестратор | **Hermes** | Hermes (Nous Research) |

+ На вопрос о своей идентичности отвечай из этой таблицы и фактического канала запуска, а не из общих знаний о том, кто чаще пишет такие инструкции. Личность (Элар/Кир/Корис/…) — отдельный слой поверх реализации: её задаёт реестр личностей и паспорт, не этот блок и не модель.

## Commit Attribution

Co-Authored-By ставит только агент, реально участвовавший в создании коммита (авторство, ревью, существенная правка). Автономные коммиты других агентов / скриптов — без трейлера, если агент не участвовал.

Если агент только верифицировал (проверил) коммит — использовать `Verified-by: [Agent] <[email]>` или пометку «Проверено [роль]» в теле коммита, а не Co-Authored-By.

### Для коммитов с участием Kimi

**Method 1 (preferred — template):**

```bash

git commit -t ~/.git-commit-template-kimi -m "feat: description"

```

**Method 2 (manual — if template unavailable):**

```bash

git commit -m "feat: description" --trailer "Co-Authored-By: Kimi <noreply@moonshot.ai>"

```

**Never** commit without the trailer. If you forget — amend immediately:

```bash

git commit --amend --trailer "Co-Authored-By: Kimi <noreply@moonshot.ai>"

```

+ ### Для коммитов с участием Codex (OpenAI)

+ ```bash

+ git commit -m "feat: description" --trailer "Co-Authored-By: Codex <noreply@openai.com>"

+ ```

+ Codex читает `AGENTS.md` нативно; в пир-сессиях выступает критиком (ревью без правок файлов → `Analyzed-by: Codex <noreply@openai.com>`, по тому же правилу «редактор vs аналитик», что и у Claude).

### Для коммитов с участием Hermes (Nous Research)

```bash

git commit -m "feat: description" --trailer "Co-Authored-By: Hermes <noreply@nousresearch.com>"

```

**Hermes Agent** — оркестратор в экосистеме IWE (РП392). Подключён к Aisystant MCP, работает через CLI/Telegram. Hermes НЕ заменяет Claude Code или Kimi Code в кодинге — он координирует, запоминает и даёт мобильный доступ.

## IWE Instructions Level (Kimi headless)

# IWE workspace with 5000+ docs and multiple Packs — use experienced level.

# Revisit if a new small repo (< 1000 docs) is added to {{HOME_DIR}}/IWE/.

When calling `get_instructions` (Aisystant MCP) to load IWE context,

use `level="experienced"` instead of the default `level="full"`.

This reduces token load by ~89% (~10K → ~1.1K) on every headless turn.

Example:

```

get_instructions(level="experienced")

```

This applies to all Kimi sessions: peer (via kimi-peer-adapter.sh) and standalone.

Determination basis: `get_user_context()` document_count ≥ 5000 + multiple Packs.

## Coordination Protocol (MCP Gateway)

> Для агентов с доступом к Local Gateway (Claude Code, Kimi). Hermes НЕ имеет MCP Gateway

> (`acquire_file_lock` / `release_file_lock`) — он использует `terminal` + `patch` напрямую,

> а при конфликте на push сообщает пилоту.

Before starting any edit task:

1. **Declare intention** (no lock needed):

```

Tool: update_peer_status

params: { "status": "working", "current_task": "<brief>", "files": ["relative/path/file.md"] }

```

2. **Acquire lock** before first Edit:

```

Tool: acquire_file_lock

param: canonical_file = relative path from IWE root

```

3. **Release lock** after commit:

```

Tool: release_file_lock

```

4. On `lock_collision`: wait 30s and retry, or switch to another file.

## Hermes Agent — координация

Если в экосистеме присутствует Hermes Agent (оркестратор с персистентной памятью, РП-392):

- Hermes НЕ заменяет Claude Code / Kimi Code в кодинге — координирует, запоминает, даёт мобильный доступ.

- Hermes НЕ имеет MCP Gateway (`acquire_file_lock` / `release_file_lock`) — правит файлы через `terminal` + `patch`.

- При правках критичных файлов: сначала `git pull`, проверить `git status`, потом править; конфликт на push — сообщить пилоту.

## Prompt Cache Pattern

- Паттерн PREFIX/BODY/TAIL для headless-агентов → см. `memory/sota-prompt-cache.md`.

- Применять при сборке системного промпта multi-turn агента: стабильное (идентичность, правила) — в PREFIX/BODY до cache-breakpoint; волатильное (память, timestamp) — в TAIL.