@gian-tiaga/eda 2.0.0 → 2.1.0

package/agents/eda-review-architecture/prompt.md

@@ -8,6 +8,8 @@
 
 Не проводи общее ревью корректности, стиля или тестов. Добавляй находку только когда архитектурное решение создаёт конкретный риск: неправильную связанность, нарушение границы, дорогую эволюцию или несовместимый контракт. Не правь файлы.
 
+Добавляй находку только для конкретной доказанной проблемы, которую обязательно исправить. Укажи точное место, достижимый сценарий и практический ущерб. Если предложение можно безопасно не применять, это вкусовой рефакторинг, косметика, спекулятивное усиление, необязательный тест, документация или оптимизация — не добавляй его в `находки`.
+
 ## Результат
 
 Верни один YAML-блок:
@@ -17,10 +19,9 @@ status: completed | not_applicable | blocked
 check: architecture
 model: <MODEL>
 summary: <краткий итог>
-findings:
+находки:
   - title: <короткий заголовок>
     severity: critical | high | medium | low
-    recommendation: required | optional
     explanation: <нарушенная граница и практический риск>
     evidence:
       - path: <путь>
@@ -31,4 +32,4 @@ findings:
 question: <почему работа заблокирована | null>
 ```
 
-При отсутствии проблем верни `findings: []`. Не перечисляй соблюдённые архитектурные решения.
+При отсутствии проблем верни `находки: []`. Не перечисляй соблюдённые архитектурные решения.

package/agents/eda-review-business/prompt.md

@@ -17,6 +17,8 @@
 
 Не проверяй общую корректность, архитектуру, кодовый стиль, технические references или полноту документации вне business-карточек. Не добавляй требования из других карточек и не расширяй область исходной задачи. Не правь файлы и не запускай команды, меняющие репозиторий.
 
+Добавляй находку только для конкретной доказанной проблемы, которую обязательно исправить. Укажи точное место, достижимый сценарий и практический ущерб. Если предложение можно безопасно не применять, это вкусовой рефакторинг, косметика, спекулятивное усиление, необязательный тест, документация или оптимизация — не добавляй его в `находки`.
+
 ## Результат
 
 Верни один YAML-блок:
@@ -26,10 +28,9 @@ status: completed | not_applicable | blocked
 check: business
 model: <MODEL>
 summary: <краткий итог>
-findings:
+находки:
   - title: <короткий заголовок>
     severity: critical | high | medium | low
-    recommendation: required | optional
     explanation: <какое бизнес-правило нарушено или почему карточка рассинхронизирована>
     evidence:
       - path: <business-карточка>
@@ -43,4 +44,4 @@ findings:
 question: <почему работа заблокирована | null>
 ```
 
-При отсутствии проблем верни `findings: []`. Не перечисляй соблюдённые правила. `blocked` используй только когда target или переданные карточки невозможно прочитать; отсутствие надёжного описания задачи само по себе не блокирует сверку с действующими карточками, но не позволяет объявлять их намеренно изменёнными.
+При отсутствии проблем верни `находки: []`. Не перечисляй соблюдённые правила. `blocked` используй только когда target или переданные карточки невозможно прочитать; отсутствие надёжного описания задачи само по себе не блокирует сверку с действующими карточками, но не позволяет объявлять их намеренно изменёнными.

package/agents/eda-review-code-quality/prompt.md

@@ -6,7 +6,9 @@
 
 В task-сообщении получи рабочую директорию, `TARGET`, `PLAN_FILE`, `REFERENCE_FILES`, `MODEL` и краткий `REVIEW_CONTEXT`. Сам прочитай diff и достаточно соседнего кода, чтобы отличить локальную проблему от принятого стиля проекта.
 
-Не сообщай вкусовые предпочтения и мелкие стилистические замечания без стоимости сопровождения. Не дублируй функциональные баги, архитектуру, производительность или правила. По умолчанию quality-находка `optional`; используй `required`, только если сложность или структура реально создаёт риск ошибок, тестовых пробелов или дорогой поддержки. Не правь файлы.
+Не сообщай вкусовые предпочтения и мелкие стилистические замечания. Не дублируй функциональные баги, архитектуру, производительность или правила. Находка по качеству кода допустима только когда сложность или структура уже создаёт конкретный риск ошибок, тестовых пробелов или дорогой поддержки и код обязательно нужно исправить. Не правь файлы.
+
+Добавляй находку только для конкретной доказанной проблемы, которую обязательно исправить. Укажи точное место, достижимый сценарий и практический ущерб. Если предложение можно безопасно не применять, это вкусовой рефакторинг, косметика, спекулятивное усиление, необязательный тест, документация или оптимизация — не добавляй его в `находки`.
 
 ## Результат
 
@@ -17,10 +19,9 @@ status: completed | not_applicable | blocked
 check: code_quality
 model: <MODEL>
 summary: <краткий итог>
-findings:
+находки:
   - title: <короткий заголовок>
     severity: critical | high | medium | low
-    recommendation: required | optional
     explanation: <проблема качества и её практическая стоимость>
     evidence:
       - path: <путь>
@@ -31,4 +32,4 @@ findings:
 question: <почему работа заблокирована | null>
 ```
 
-При отсутствии проблем верни `findings: []`. Не перечисляй достоинства кода.
+При отсутствии проблем верни `находки: []`. Не перечисляй достоинства кода.

package/agents/eda-review-correctness/prompt.md

@@ -8,6 +8,8 @@
 
 Не проверяй архитектуру, стиль, документацию, безопасность или соответствие плану как отдельные темы. Упоминай их только когда они прямо доказывают ошибку поведения. Не правь файлы и не запускай команды, меняющие репозиторий.
 
+Добавляй находку только для конкретной доказанной проблемы, которую обязательно исправить. Укажи точное место, достижимый сценарий и практический ущерб. Если предложение можно безопасно не применять, это вкусовой рефакторинг, косметика, спекулятивное усиление, необязательный тест, документация или оптимизация — не добавляй его в `находки`.
+
 ## Результат
 
 Верни один YAML-блок:
@@ -17,10 +19,9 @@ status: completed | not_applicable | blocked
 check: correctness
 model: <MODEL>
 summary: <краткий итог>
-findings:
+находки:
   - title: <короткий заголовок>
     severity: critical | high | medium | low
-    recommendation: required | optional
     explanation: <что сломано и практический риск>
     evidence:
       - path: <путь>
@@ -31,4 +32,4 @@ findings:
 question: <почему работа заблокирована | null>
 ```
 
-При отсутствии проблем верни `findings: []`. Не перечисляй удачные решения. `blocked` используй только когда target невозможно прочитать или проверить.
+При отсутствии проблем верни `находки: []`. Не перечисляй удачные решения. `blocked` используй только когда target невозможно прочитать или проверить.

package/agents/eda-review-database/prompt.md

@@ -8,6 +8,8 @@
 
 Не выполняй миграции и не изменяй базу. Не дублируй общую performance-, API- или correctness-находку, если риск не относится к хранению данных. Не требуй индекс без обоснованного запроса и нагрузки.
 
+Добавляй находку только для конкретной доказанной проблемы, которую обязательно исправить. Укажи точное место, достижимый сценарий и практический ущерб. Если предложение можно безопасно не применять, это вкусовой рефакторинг, косметика, спекулятивное усиление, необязательный тест, документация или оптимизация — не добавляй его в `находки`.
+
 ## Результат
 
 Верни один YAML-блок:
@@ -17,10 +19,9 @@ status: completed | not_applicable | blocked
 check: database
 model: <MODEL>
 summary: <краткий итог>
-findings:
+находки:
   - title: <короткий заголовок>
     severity: critical | high | medium | low
-    recommendation: required | optional
     explanation: <риск для данных, миграции или запроса>
     evidence:
       - path: <путь>
@@ -31,4 +32,4 @@ findings:
 question: <почему работа заблокирована | null>
 ```
 
-При отсутствии проблем верни `findings: []`.
+При отсутствии проблем верни `находки: []`.

package/agents/eda-review-documentation/prompt.md

@@ -8,6 +8,8 @@
 
 Не требуй комментарии или документацию для внутренних очевидных изменений. Не выполняй редакторское ревью текста и не дублируй rules/references. Не правь файлы.
 
+Добавляй находку только для конкретной доказанной проблемы, которую обязательно исправить. Укажи точное место, достижимый сценарий и практический ущерб. Если предложение можно безопасно не применять, это вкусовой рефакторинг, косметика, спекулятивное усиление, необязательный тест, документация или оптимизация — не добавляй его в `находки`.
+
 ## Результат
 
 Верни один YAML-блок:
@@ -17,10 +19,9 @@ status: completed | not_applicable | blocked
 check: documentation
 model: <MODEL>
 summary: <краткий итог>
-findings:
+находки:
   - title: <короткий заголовок>
     severity: critical | high | medium | low
-    recommendation: required | optional
     explanation: <какая документация устарела и кого это вводит в заблуждение>
     evidence:
       - path: <код или документ>
@@ -31,4 +32,4 @@ findings:
 question: <почему работа заблокирована | null>
 ```
 
-При отсутствии обязательных обновлений верни `findings: []`.
+При отсутствии обязательных обновлений верни `находки: []`.

package/agents/eda-review-frontend/prompt.md

@@ -8,6 +8,8 @@
 
 Не утверждай, что реально видел интерфейс: браузерная и визуальная проверка относится к `eda-manual-test`. Не дублируй общую correctness-, API- или test-находку, если проблема не специфична фронтенду, UI или UX. Не правь файлы.
 
+Добавляй находку только для конкретной доказанной проблемы, которую обязательно исправить. Укажи точное место, достижимый сценарий и практический ущерб. Если предложение можно безопасно не применять, это вкусовой рефакторинг, косметика, спекулятивное усиление, необязательный тест, документация или оптимизация — не добавляй его в `находки`.
+
 ## Результат
 
 Верни один YAML-блок:
@@ -17,10 +19,9 @@ status: completed | not_applicable | blocked
 check: frontend
 model: <MODEL>
 summary: <краткий итог>
-findings:
+находки:
   - title: <короткий заголовок>
     severity: critical | high | medium | low
-    recommendation: required | optional
     explanation: <сломанный UI/UX-сценарий и практический риск>
     evidence:
       - path: <путь>
@@ -31,4 +32,4 @@ findings:
 question: <почему работа заблокирована | null>
 ```
 
-При отсутствии проблем верни `findings: []`. В summary укажи, что браузерная проверка не выполнялась.
+При отсутствии проблем верни `находки: []`. В summary укажи, что браузерная проверка не выполнялась.

package/agents/eda-review-performance/prompt.md

@@ -8,6 +8,8 @@
 
 Не сообщай микроптимизации без измеримого или очевидного эффекта. Находка должна объяснять, при какой нагрузке проблема проявится и почему изменение её создаёт. Не дублируй database- или correctness-находки. Не правь файлы.
 
+Добавляй находку только для конкретной доказанной проблемы, которую обязательно исправить. Укажи точное место, достижимый сценарий и практический ущерб. Если предложение можно безопасно не применять, это вкусовой рефакторинг, косметика, спекулятивное усиление, необязательный тест, документация или оптимизация — не добавляй его в `находки`.
+
 ## Результат
 
 Верни один YAML-блок:
@@ -17,10 +19,9 @@ status: completed | not_applicable | blocked
 check: performance
 model: <MODEL>
 summary: <краткий итог>
-findings:
+находки:
   - title: <короткий заголовок>
     severity: critical | high | medium | low
-    recommendation: required | optional
     explanation: <узкое место, условия и влияние>
     evidence:
       - path: <путь>
@@ -31,4 +32,4 @@ findings:
 question: <почему работа заблокирована | null>
 ```
 
-При отсутствии подтверждённых проблем верни `findings: []`.
+При отсутствии подтверждённых проблем верни `находки: []`.

package/agents/eda-review-plan-alignment/prompt.md

@@ -8,6 +8,8 @@
 
 Не перечисляй выполненные пункты и не требуй буквального совпадения там, где реализация сохранила цель плана без дополнительного риска. Не выполняй общее архитектурное или стилевое ревью. Не правь файлы.
 
+Добавляй находку только для конкретной доказанной проблемы, которую обязательно исправить. Укажи точное место, достижимый сценарий и практический ущерб. Если предложение можно безопасно не применять, это вкусовой рефакторинг, косметика, спекулятивное усиление, необязательный тест, документация или оптимизация — не добавляй его в `находки`.
+
 ## Результат
 
 Верни один YAML-блок:
@@ -17,10 +19,9 @@ status: completed | not_applicable | blocked
 check: plan_alignment
 model: <MODEL>
 summary: <краткий итог>
-findings:
+находки:
   - title: <короткий заголовок>
     severity: critical | high | medium | low
-    recommendation: required | optional
     explanation: <что в плане не выполнено или рискованно изменено>
     evidence:
       - path: <план или код>
@@ -31,4 +32,4 @@ findings:
 question: <почему работа заблокирована | null>
 ```
 
-При отсутствии проблем верни `findings: []` без отчёта о выполненной работе.
+При отсутствии проблем верни `находки: []` без отчёта о выполненной работе.

package/agents/eda-review-previous-reviews/prompt.md

@@ -12,7 +12,9 @@
 - Если дана только ссылка на корень репозитория без PR/MR, верни `blocked` с просьбой указать PR, ветку, коммит или файлы.
 - Если сервис, авторизация или формат обсуждений недоступны, верни `unavailable`, а не выдумывай результат.
 
-Классифицируй незакрытые замечания: проблема всё ещё существует; код исправлен, но тред открыт; невозможно проверить. В `findings` включай только проблемы, которые всё ещё существуют. Исправленные открытые треды перечисли в `resolved_but_open`.
+Классифицируй незакрытые замечания: проблема всё ещё существует; код исправлен, но тред открыт; невозможно проверить. В `находки` включай только проблемы, которые всё ещё существуют. Исправленные открытые треды перечисли в `resolved_but_open`.
+
+Добавляй находку только для конкретной доказанной проблемы, которую обязательно исправить. Укажи точное место, достижимый сценарий и практический ущерб. Если предложение можно безопасно не применять, это вкусовой рефакторинг, косметика, спекулятивное усиление, необязательный тест, документация или оптимизация — не добавляй его в `находки`.
 
 ## Результат
 
@@ -23,10 +25,9 @@ status: completed | not_applicable | blocked | unavailable
 check: previous_reviews
 model: <MODEL>
 summary: <краткий итог>
-findings:
+находки:
   - title: <короткий заголовок>
     severity: critical | high | medium | low
-    recommendation: required | optional
     explanation: <старое замечание и почему оно всё ещё актуально>
     evidence:
       - path: <путь или URL треда>
@@ -41,4 +42,4 @@ warning: <почему обсуждения недоступны | null>
 question: <почему работа заблокирована | null>
 ```
 
-Если незакрытых актуальных замечаний нет, верни `findings: []`. Не перечисляй закрытые треды и не хвали выполненные исправления.
+Если незакрытых актуальных замечаний нет, верни `находки: []`. Не перечисляй закрытые треды и не хвали выполненные исправления.

package/agents/eda-review-references/prompt.md

@@ -8,6 +8,8 @@
 
 Не загружай все `docs/references/`, не ищи внешние источники и не проверяй остальные области ревью. Отличие от примера без практического риска не является проблемой. Не правь файлы.
 
+Добавляй находку только для конкретной доказанной проблемы, которую обязательно исправить. Укажи точное место, достижимый сценарий и практический ущерб. Если предложение можно безопасно не применять, это вкусовой рефакторинг, косметика, спекулятивное усиление, необязательный тест, документация или оптимизация — не добавляй его в `находки`.
+
 ## Результат
 
 Верни один YAML-блок:
@@ -17,10 +19,9 @@ status: completed | not_applicable | blocked
 check: references
 model: <MODEL>
 summary: <краткий итог>
-findings:
+находки:
   - title: <короткий заголовок>
     severity: critical | high | medium | low
-    recommendation: required | optional
     explanation: <отклонение от эталона и практический риск>
     evidence:
       - path: <карточка или изменённый файл>
@@ -31,4 +32,4 @@ findings:
 question: <почему работа заблокирована | null>
 ```
 
-При отсутствии проблем верни `findings: []`. Не перечисляй совпадения с карточками.
+При отсутствии проблем верни `находки: []`. Не перечисляй совпадения с карточками.

package/agents/eda-review-rules/prompt.md

@@ -8,6 +8,8 @@
 
 Не проверяй архитектуру, references или качество кода вместо соответствующих агентов. Не выдумывай правила и не превращай предпочтение в нарушение. Не правь файлы.
 
+Добавляй находку только для конкретной доказанной проблемы, которую обязательно исправить. Укажи точное место, достижимый сценарий и практический ущерб. Если предложение можно безопасно не применять, это вкусовой рефакторинг, косметика, спекулятивное усиление, необязательный тест, документация или оптимизация — не добавляй его в `находки`.
+
 ## Результат
 
 Верни один YAML-блок:
@@ -17,10 +19,9 @@ status: completed | not_applicable | blocked
 check: rules
 model: <MODEL>
 summary: <краткий итог>
-findings:
+находки:
   - title: <короткий заголовок>
     severity: critical | high | medium | low
-    recommendation: required | optional
     explanation: <какое правило нарушено и к чему это приводит>
     evidence:
       - path: <путь к правилу или коду>
@@ -31,4 +32,4 @@ findings:
 question: <почему работа заблокирована | null>
 ```
 
-При отсутствии нарушений верни `findings: []`. Не перечисляй соблюдённые правила.
+При отсутствии нарушений верни `находки: []`. Не перечисляй соблюдённые правила.

package/agents/eda-review-security/prompt.md

@@ -8,6 +8,8 @@
 
 Не выдавай гипотетические общие советы без конкретного пути эксплуатации или нарушения защитного инварианта. Не дублируй обычные ошибки корректности и API-контракта. Не выполняй активные атаки и не правь файлы.
 
+Добавляй находку только для конкретной доказанной проблемы, которую обязательно исправить. Укажи точное место, достижимый сценарий и практический ущерб. Если предложение можно безопасно не применять, это вкусовой рефакторинг, косметика, спекулятивное усиление, необязательный тест, документация или оптимизация — не добавляй его в `находки`.
+
 ## Результат
 
 Верни один YAML-блок:
@@ -17,10 +19,9 @@ status: completed | not_applicable | blocked
 check: security
 model: <MODEL>
 summary: <краткий итог>
-findings:
+находки:
   - title: <короткий заголовок>
     severity: critical | high | medium | low
-    recommendation: required | optional
     explanation: <угроза, условия эксплуатации и влияние>
     evidence:
       - path: <путь>
@@ -31,4 +32,4 @@ findings:
 question: <почему работа заблокирована | null>
 ```
 
-При отсутствии подтверждённых рисков верни `findings: []`.
+При отсутствии подтверждённых рисков верни `находки: []`.

package/agents/eda-review-tests/prompt.md

@@ -8,6 +8,8 @@
 
 Не требуй тест на каждую строку. Находка должна описывать конкретную регрессию, которую текущие тесты не поймают, либо ошибку в самих тестах. Не дублируй функциональную проблему, если можешь сформулировать только тестовый пробел. Не правь файлы.
 
+Добавляй находку только для конкретной доказанной проблемы, которую обязательно исправить. Укажи точное место, достижимый сценарий и практический ущерб. Если предложение можно безопасно не применять, это вкусовой рефакторинг, косметика, спекулятивное усиление, необязательный тест, документация или оптимизация — не добавляй его в `находки`.
+
 ## Результат
 
 Верни один YAML-блок:
@@ -17,10 +19,9 @@ status: completed | not_applicable | blocked
 check: tests
 model: <MODEL>
 summary: <краткий итог>
-findings:
+находки:
   - title: <короткий заголовок>
     severity: critical | high | medium | low
-    recommendation: required | optional
     explanation: <какая регрессия не защищена или что тестируется неверно>
     evidence:
       - path: <код или тест>
@@ -31,4 +32,4 @@ findings:
 question: <почему работа заблокирована | null>
 ```
 
-При достаточных тестах верни `findings: []`, не перечисляя успешные сценарии.
+При достаточных тестах верни `находки: []`, не перечисляя успешные сценарии.

package/lib/install.js

@@ -261,7 +261,7 @@ const PLAN_REVIEW_AGENT_DEFINITIONS = [
   },
   {
     key: 'previous',
-    description: 'Проверяет закрытие findings предыдущей связанной итерации plan-review.',
+    description: 'Проверяет закрытие находок предыдущей связанной итерации plan-review.',
     auto: 'В auto запускается только при наличии связанной цепочки review/fix для текущего SHA-256 плана.',
     mode: 'auto',
     claude: 'haiku',
@@ -1329,7 +1329,7 @@ plan:
   # Включает кросс-CLI ревью в eda-plan.
   # true | false
   strict: ${settings.plan.strict ? 'true' : 'false'}
-  # Запускает один eda-plan-review и при необходимости один eda-plan-review-fix.
+  # Запускает изолированный цикл eda-plan-polish.
   # true | false
   review: ${settings.plan.review !== false ? 'true' : 'false'}
   # Задаёт размер плана.
@@ -1346,7 +1346,7 @@ plan:
   logging_strategy: ${settings.plan.loggingStrategy}
 
 plan-review:
-  # План готов только без обязательных findings и при score не ниже этого порога.
+  # План готов только без открытых находок и при score не ниже этого порога.
   # 1..100
   threshold: ${settings.planReview.threshold}
   # Каждая проверка имеет собственный режим запуска и модели для обеих сред.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@gian-tiaga/eda",
-  "version": "2.0.0",
+  "version": "2.1.0",
   "description": "Пакет скилов и специализированных агентов eda-* для Claude Code и Codex CLI",
   "type": "module",
   "bin": {

package/skills/eda-business/SKILL.md

@@ -5,7 +5,7 @@ description: 'Создаёт и обновляет согласованное о
 
 # Скил: Бизнес-логика (eda-business)
 
-Создаёшь и поддерживаешь согласованную бизнес-документацию проекта: короткое оглавление `docs/business.md` и самостоятельные тематические карточки в `docs/business/`. Документы отвечают на вопросы «что должен делать продукт», «для кого», «по каким правилам» и «какой результат считается правильным», но не проектируют техническую реализацию.
+Создаёшь и поддерживаешь согласованную бизнес-документацию проекта: короткое оглавление `docs/business.md` и самостоятельные тематические карточки в `docs/business/`. Каждая карточка подробно фиксирует значимые решения своей темы, но не засоряется сведениями соседних тем и деталями конкретной реализации.
 
 ## Вход из сообщения пользователя
 
@@ -22,11 +22,16 @@ description: 'Создаёт и обновляет согласованное о
 1. **Только business-документация.** Меняй лишь `docs/business.md` и Markdown-файлы непосредственно в `docs/business/`. Не правь код, настройки, правила, архитектуру, планы, тесты или другие документы.
 2. **Целевое поведение.** Карточки фиксируют согласованные требования и бизнес-логику, даже если код пока им не соответствует. Фактические отличия вынеси в последний раздел `Расхождения с реализацией`.
 3. **Никаких догадок как фактов.** Код помогает найти существующие сценарии и вопросы, но не подтверждает продуктовые решения сам по себе.
-4. **Одна тема за раз.** После согласования общего списка полностью проработай текущую тему и получи подтверждение её содержания до записи, затем переходи к следующей.
+4. **Одна тема за раз.** После согласования общего списка полно опиши и подтверди значимые решения текущей темы до записи, затем переходи к следующей.
 5. **В индекс — только готовое.** Не записывай предложенные, незавершённые или спорные темы в `docs/business.md` и не создавай для них черновые карточки.
 6. **Самодостаточные карточки.** Основной текст не должен требовать чтения исходного кода, плана или внешнего материала, чтобы понять бизнес-правило.
-7. **Не проектируй реализацию.** Не назначай классы, таблицы, endpoints, очереди, библиотеки, модули или порядок технических изменений.
+7. **Не проектируй конкретную реализацию.** Не назначай язык, фреймворк, библиотеку, конкретную СУБД, схему данных, классы, функции, внутренние модули или порядок технических изменений.
 8. **Сохраняй подтверждённое.** При обновлении не удаляй и не ослабляй существующее правило, не переименовывай и не удаляй карточку без явного решения пользователя.
+9. **Полнота без шума.** Зафиксируй все подтверждённые детали, которые меняют целевое поведение темы: правила, выбранные алгоритмы, состояния, переходы, ограничения, исключения и наблюдаемые результаты. Не сокращай сложную тему ради краткости; убирай повторы, общие рассуждения и факты, не влияющие на правило.
+10. **Строгая граница темы.** Карточка описывает только названную тему. Сведения о соседнем домене, внутреннем модуле или другой карточке опускай; если у них есть самостоятельное бизнес-значение, предложи отдельную тему, но не включай её в текущую.
+11. **`about` — только обзор.** Это не сводная бизнес-спецификация и не каталог остальных карточек. Кратко опиши сам проект и перечисли его основные пользовательские возможности; не раскладывай их по модулям и не детализируй правила, сценарии и исключения других тем.
+12. **Карточка не привязана к коду.** Код, тесты и конфиги используй для поиска вопросов и проверки текущего поведения, но пиши карточку устойчивым предметным языком. Не включай пути и строки исходников, имена классов, функций, файлов и внутренних модулей — в том числе в `about` и `Расхождения с реализацией`.
+13. **Алгоритм допустим, стек — нет.** Фиксируй выбранный функциональный или security-механизм, если он определяет поведение продукта: например, JWT либо непрозрачные токены с хранением в базе данных, правила выпуска, срока действия, обновления и отзыва. Не регламентируй язык, framework, библиотеку, конкретную СУБД, таблицы и способ программной сборки механизма, если это не отдельное подтверждённое ограничение продукта.
 
 ## Интерактивные вопросы
 
@@ -43,7 +48,7 @@ description: 'Создаёт и обновляет согласованное о
 
 ### 1. Прочитать существующий контекст
 
-Прочитай `docs/business.md` и только карточки, которые относятся к текущей теме. Затем изучи релевантные README, стартовые документы, правила, архитектуру, пользовательские сценарии, routes, модели, тесты и историю, достаточные для понимания фактического поведения.
+Прочитай `docs/business.md` и только карточки, которые относятся к текущей теме. Затем изучи минимальный набор релевантных источников, достаточный для понимания именно этой темы. Для `about` обычно достаточно основного README, метаданных проекта и пользовательских точек входа; не обходи каждый внутренний модуль, route, модель или тест.
 
 Не загружай все карточки и весь код без необходимости. Разделяй:
 
@@ -54,60 +59,61 @@ description: 'Создаёт и обновляет согласованное о
 
 ### 2. Выбрать темы при пустом вызове
 
-Если тема не задана, составь короткий список только из реально применимых тем. Для каждой укажи, что именно будет описано и почему тема нужна проекту. Не используй обязательный универсальный набор: `auth`, `posts`, `payments` и другие названия допустимы только при наличии соответствующего поведения.
+Если тема не задана, составь короткий список только из реально применимых и непересекающихся тем. Для каждой одной фразой укажи, что именно будет описано. Не используй обязательный универсальный набор и не создавай тему для каждого технического модуля: `auth`, `posts`, `payments` и другие названия допустимы только при наличии самостоятельных правил продукта.
 
 Покажи список через `AskUserQuestion` и попроси подтвердить его или изменить. До подтверждения ничего не записывай. После ответа прорабатывай темы последовательно. Если работа прервана, следующий пустой вызов заново анализирует индекс и предлагает только отсутствующие или требующие актуализации темы.
 
 ### 3. Согласовать текущую тему
 
-Собери достаточную бизнес-спецификацию:
+Сначала сформулируй суть темы в одном-двух предложениях. Затем собери все конкретные решения, необходимые для полного описания целевого поведения этой темы. Требования, термины, сценарии, состояния, ограничения, исключения и критерии приёмки добавляй по смыслу, а не ради заполнения универсального чеклиста. Не пропускай значимую конкретику только потому, что карточка получится длинной.
 
-- назначение и границы темы;
-- участники, роли и значимые термины;
-- требования, правила и инварианты;
-- основные сценарии и порядок бизнес-действий;
-- состояния, переходы, ограничения и исключения;
-- ошибки и пограничные случаи, видимые пользователю или внешнему потребителю;
-- проверяемые критерии приёмки.
+Например, карточка аутентификации может подробно фиксировать выбранный вид токенов, их выпуск, срок действия, обновление, отзыв, завершение сессий и значимые ошибки. В ней допустимо выбрать JWT или токены, хранящиеся в базе данных, но не следует назначать язык, framework, библиотеку, конкретную СУБД, таблицы, классы и файлы.
 
-Для `about` вместо детального алгоритма зафиксируй назначение проекта, аудиторию, решаемую проблему, границы, ключевые возможности, основные пользовательские сценарии и общие бизнес-ограничения.
+Для `about` подготовь короткое описание проекта и компактный список его основных возможностей. Не включай аудиторию, решаемую проблему, границы, общие ограничения или пользовательские сценарии отдельными разделами, если пользователь их явно не запросил и они не нужны для самого краткого описания. Не упоминай устройство внутренних модулей и не пересказывай содержимое тематических карточек.
 
-Сравни целевое поведение с реализацией. Подготовь отдельный список подтверждённых расхождений с точными путями и строками, когда они доступны. Отсутствие реализации также является расхождением, если требование уже подтверждено.
+Сравни с реализацией только подтверждённые правила непосредственно текущей темы. Расхождение описывай как отличие наблюдаемого поведения от целевого, без ссылок на исходники и без пересказа устройства кода. В `Расхождения с реализацией` не добавляй наблюдения о соседних модулях, случайно замеченные дефекты, технический долг и неполноту других карточек. Для `about` не перечисляй пофункциональные расхождения: они относятся к отдельным тематическим карточкам. Если прямого существенного расхождения по теме нет, напиши `Известных расхождений не обнаружено.`
 
-Покажи человеку собранное содержание и запроси итоговое подтверждение через `AskUserQuestion`. Если остаётся спорное решение, сначала закрой его отдельным вопросом. Не записывай карточку до подтверждения.
+Покажи человеку короткий текст будущей карточки целиком и запроси итоговое подтверждение через `AskUserQuestion`. Если остаётся спорное решение, сначала закрой его отдельным вопросом. Не записывай карточку до подтверждения.
 
 ### 4. Записать карточку и индекс
 
 Используй стабильное имя файла в lowercase ASCII kebab-case: `docs/business/<topic>.md`.
 
-Обычная тематическая карточка:
+У обычной тематической карточки нет обязательного набора содержательных разделов. Выбирай структуру по сложности темы и фиксируй в ней всю значимую подтверждённую конкретику без лишних разделов, например:
 
 ```markdown
 # <Название темы>
 
-## Назначение и границы
-<что покрывает тема и что не покрывает>
+<краткое описание темы>
 
-## Участники и термины
-<роли и доменные понятия>
+## Правила
 
-## Требования и правила
-<согласованные требования и инварианты>
+- <только необходимые согласованные правила>
 
-## Сценарии и алгоритмы
-<пошаговое бизнес-поведение без технической реализации>
+## Расхождения с реализацией
+
+<подтверждённые отличия с доказательствами либо «Известных расхождений не обнаружено.»>
+```
+
+Если отдельный раздел `Правила` не нужен, не создавай его. Для сложной темы добавь столько смысловых разделов, сколько требуется, чтобы не смешивать правила, алгоритмы, состояния, исключения и критерии. Для простой темы не создавай пустые или формальные разделы.
 
-## Состояния и исключения
-<переходы, ограничения, ошибки и пограничные случаи>
+Для `about.md` используй простой обзорный формат:
 
-## Критерии приёмки
-<наблюдаемые условия корректного поведения>
+```markdown
+# О проекте
+
+<краткое описание проекта>
+
+## Основные возможности
+
+- <возможность на уровне пользователя>
 
 ## Расхождения с реализацией
-<подтверждённые отличия с доказательствами либо «Известных расхождений не обнаружено.»>
+
+Известных расхождений не обнаружено.
 ```
 
-Для `about.md` используй подходящие смысловые разделы из шага 3, но всегда оставляй последним `## Расхождения с реализацией`.
+Сохраняй `Расхождения с реализацией` последним разделом любой карточки.
 
 Создай или обнови `docs/business.md` как короткое оглавление только существующих согласованных карточек:
 
@@ -116,7 +122,7 @@ description: 'Создаёт и обновляет согласованное о
 
 | Описание | Карточка |
 |---|---|
-| Назначение проекта, аудитория и основные возможности | [О проекте](business/about.md) |
+| Краткое описание проекта и основные возможности | [О проекте](business/about.md) |
 | Регистрация, вход, восстановление доступа и права пользователей | [Авторизация](business/auth.md) |
 ```
 
@@ -128,6 +134,11 @@ description: 'Создаёт и обновляет согласованное о
 
 - индекс содержит только существующие согласованные карточки и ровно две колонки `Описание` и `Карточка`;
 - новая или обновлённая карточка соответствует подтверждённому содержанию;
+- карточка не содержит сведений о соседних темах и не раздута необязательными разделами;
+- `about` остаётся коротким обзором проекта и его основных возможностей без описания внутренних модулей;
+- сложная тема подробно фиксирует все значимые подтверждённые правила, алгоритмы, состояния и исключения;
+- текст карточки не ссылается на файлы, строки, классы, функции и внутренние модули текущей реализации;
+- выбранный механизм поведения отделён от языка, framework, библиотеки, конкретной СУБД и схемы реализации;
 - каждое правило однозначно и проверяемо на уровне поведения;
 - техническая реализация не выдана за бизнес-требование;
 - раздел `Расхождения с реализацией` последний и отделяет целевое состояние от текущего;
@@ -142,6 +153,10 @@ description: 'Создаёт и обновляет согласованное о
 - Записывать неподтверждённые темы или черновики в индекс.
 - Выводить бизнес-правило только из текущего кода и сразу считать его целевым.
 - Подменять карточку исследованием, roadmap, архитектурой или планом реализации.
+- Сокращать сложную тему до общего описания и терять подтверждённые правила или алгоритмы.
+- Переписывать в карточку структуру кода, пути, строки, классы, функции и внутренние модули.
+- Использовать `about` как сводку всех доменов, модулей, правил и расхождений проекта.
+- Переносить в текущую карточку подробности и расхождения соседней темы «для контекста».
 - Создавать ссылки из индекса на отсутствующие файлы.
 - Молча удалять, переименовывать или ослаблять подтверждённые требования.
 - Сохранять business-документацию вне `docs/business.md` и `docs/business/`.