# agent-v10-comments — решения агента

Спека и дизайн изменения — в `jira-hub/openspec/changes/issue-card-modal/` (issue aep/jira-hub#37, aep/jira-agent#27).
Агентская часть — решения 1–4 дизайна хаба (поле `comment` в `search`, дочитывание, форма комментария, версия и выкатка)
и требование `agent` «Чтение состояния».

Решения владельца 15.10.2026 (brainstorming jira-hub#37): комментарии задачи нужны в карточке веб-приложения; два change
по репозиториям, сначала агент; автор — отображаемое имя, как в Jira над комментарием.

## Decisions made without discussion

Рулинги R-1…R-5 записаны в `jira-hub/openspec/changes/issue-card-modal/design.md`
(раздел «Decisions made without discussion»); здесь — только решения, принятые при исполнении агентской части.

| Маркер | Дата | Решение | Обоснование | Цена ошибки |
|---|---|---|---|---|
| R-20 | 2026-10-15 | Размер пачки `POST /agent/state` с комментариями не ограничивается отдельно: пачка по-прежнему 100 задач | Риск принят в design хаба (Risks): типичные комментарии — сотни килобайт на пачку при пределе хаба 16 МБ (финальное ревью, «Declined to judge») | Если пачка превысит 16 МБ, хаб ответит 413 и упадёт весь `refresh` — зеркало перестанет обновляться; лечится уменьшением пачки |
| R-21 | 2026-10-15 | Ограничения видимости комментариев Jira (`visibility` по группе/роли) в хаб не переносятся: комментарий уходит как есть | Хаб личный, учётка агента видит только разрешённое ей; в спеке требования нет (финальное ревью, «Declined to judge») | Комментарий с ограничением видимости виден любому с доступом к веб-приложению хаба |

Нумерация рулингов агентской части — с R-20, чтобы не пересечься с рулингами исполнения хабовой части (R-6 и далее в design.md хаба).

Финальное ревью ветки (opus, 15.10.2026), маркеры с пометкой «агент»: I-1 — fixed 28b21e0 (возвращены проверки `test_refresh_empty_keys`); M-1…M-5 — deferred (follow-up при закрытии #37).