- Зачем:
- код и конфигурации читают люди с разным уровнем экспертизы, текст должен быть доступен без дополнительных пояснений.
- Что:
- добавлен абзац про простые слова, короткие фразы и пояснение сложных мыслей при первом упоминании.
- Проверка:
- cat AGENTS.md — новый абзац присутствует в разделе «Язык и рассуждения».
- Зачем:
- `{baseDir}` не является стандартным placeholder и может сбить с толку.
- Что:
- путь заменён на `references/patterns.md` с пояснением «в папке этого скилла».
- Проверка:
- cat agents/.agents/skills/ai-text-lint/SKILL.md | grep patterns
- Зачем:
- автоматизировано создание ~/.env.secrets при chezmoi apply на Windows.
- Что:
- добавлен chezmoi/create_dot_env.secrets с заглушками для CONTEXT7_API_KEY и ZAI_API_KEY.
- Проверка:
- chezmoi apply и проверка наличия ~/.env.secrets
- Зачем:
- устранена дублирующая сводная матрица severity, которая устаревала при изменении паттернов.
- улучшена навигация по документу за счёт группировки паттернов в категории.
- Что:
- добавлены разделы категорий: Структура и форматирование, Тон и авторская позиция, Резюме-специфичные паттерны.
- переупорядочены паттерны S05 и S06 внутри категории Структура.
- обновлена ссылка на severity в SKILL.md с указанием inline-таблиц.
- Проверка:
- git diff agents/.agents/skills/ai-text-lint/
- Зачем:
- гравитация скилла тянула к «выдать артефакт»; управляющие документы
раздувались деталями реализации (диагностировано на живом тесте — ADR
с инлайном SQL).
- Что:
- gate/stop: «готово» = общее понимание + рекомендованное направление,
записанное минимально-достаточно, а не «артефакт произведён»; определение
в одном месте (stop_condition), gate на него ссылается.
- core_rules: минимально-достаточный артефакт + барьер высоты (без инлайна
исполняемых артефактов) + single source of truth; приоритет над
конвенциями репозитория.
- шаг 2: артефакт(ы) выбираются ПОСЛЕ понимания, набором по жанрам.
- adr.md/spec.md: Lifetime test → Scope test (ADR↔spec по охвату, не сроку);
detailed plan — transient и вне scope скилла.
- description + README: формулировки-цели ведут пониманием, не артефактом.
- Проверка:
- grep: старый framing (lifetime/transient) убран; cross-ref Scope test
сходится; определение «готово» не дублируется; витрина не artifact-first.
Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
Dmitriy DementievandClaude Fable 5