Все правила скилла целиком и точным текстом — как ИИ-агент должен писать сообщения, чтобы человек с СДВГ принял по ним решение и ответил сразу. Эта страница нужна, чтобы изучить методику и решить, что доработать.
Проект. Мы исследуем аудиторию Instagram-аккаунта @_farandaway и работаем с ИИ-агентом в текстовом чате. В команде два сотрудника, у обоих СДВГ (синдром дефицита внимания: частые отвлечения, тяжело удерживать контекст). Между вопросом и ответом агента случается звонок, встреча, другой проект — и, вернувшись, человек уже не помнит ни свой вопрос, ни термины, ни что обсуждали.
Скилл adhd-check — это набор правил и проверок, который заставляет каждый ответ
агента быть понятным сам по себе: всё досказано на месте, термины объяснены, файлы открываются
по ссылке, на вопросы можно ответить, не перечитывая переписку.
Четыре слоя проверки — два работают «в голове» агента до отправки, два считаются автоматически после:
Как читать эту страницу. Ниже — оглавление и карточки документов. В каждой карточке: название и суть файла, две ссылки (💻 локальная markdown-копия и 🔗 GitHub) и сам текст правила, отрисованный для удобного чтения. Кнопка «📄 Показать исходный текст» открывает сырой markdown — для сверки.
Откуда берётся содержимое. Страницу собирает скрипт
python3 scripts/build-methodology-page.py: он вшивает точный текст файлов-правил без перепечатки — поэтому здесь
всегда оригинал, не пересказ.
Как устроен скилл целиком: где лежат правила, аудиты, рубрики, скрипты, журнал инцидентов и сама эта страница. Дерево собирает скрипт из файловой системы — поэтому оно всегда отражает реальное содержимое и не отстаёт.
adhd-check/ ← скилл целиком (у пачек однотипных папок один реальный пример развёрнут целиком, остальные свёрнуты строкой «ещё N»; .DS_Store и __pycache__ не показаны) ├── _meta/ ← поддержка скилла: журнал, решения, инциденты, правила сопровождения │ ├── decisions/ ← карточки архитектурных решений: почему так сделано │ │ ├── _TPL-decision.md ← шаблон-рыба (TPL): скопируй для нового решения (5 разделов + Статус) │ │ ├── CLAUDE.md ← точка входа для агента по этой папке │ │ ├── README.md ← короткая карта папки для людей │ │ ├── RULES-how-to-write-a-decision.md ← как оформлять карточку-решение │ │ ├── 2026-06-12-subagent-task-examples-collection.md ← реальный пример (свежая запись этого типа) │ │ └── (ещё 6 решений ГГГГ-ММ-ДД-*.md в том же формате) │ ├── incidents/ ← журнал реальных осечек и их разбор — петля улучшения скилла │ │ ├── _TPL-incident/ ← шаблон-рыба (TPL): скопируй для нового инцидента (01-log/02-analysis/03-rule) │ │ │ ├── 01-log.md ← что случилось + цитата пользователя │ │ │ ├── 02-analysis.md ← почему так вышло, корень │ │ │ └── 03-rule.md ← правило-исправление на будущее │ │ ├── processed/ ← разобранные инциденты — правило уже внесено в скилл │ │ │ ├── README.md ← короткая карта папки для людей │ │ │ ├── 2026-06-14-falsely-required-api-pre-run-for-local-data-processing/ ← реальный пример — развёрнут целиком, ниже что внутри │ │ │ │ ├── 01-log.md ← что случилось + цитата пользователя │ │ │ │ ├── 02-analysis.md ← почему так вышло, корень │ │ │ │ └── 03-rule.md ← правило-исправление на будущее │ │ │ └── (ещё 20 разобранных инцидентов в том же формате) │ │ ├── CLAUDE.md ← точка входа для агента по этой папке │ │ ├── README.md ← короткая карта папки для людей │ │ ├── RULES-how-to-handle-incidents.md ← как заводить и разбирать инцидент (01-log/02-analysis/03-rule) │ │ ├── 2026-06-17-sections-without-real-data-examples/ ← реальный пример — развёрнут целиком, ниже что внутри │ │ │ ├── 01-log.md ← что случилось + цитата пользователя │ │ │ ├── 02-analysis.md ← почему так вышло, корень │ │ │ └── 03-rule.md ← правило-исправление на будущее │ │ └── (ещё 48 неразобранных инцидентов в том же формате (01-log/02-analysis/03-rule)) │ ├── proposed-rules/ ← зал ожидания: важные правки правил ждут проверки и «ок» Ирины, пока неактивны │ │ ├── applied/ ← история применённых черновиков правок (как processed у инцидентов) │ │ │ ├── 2026-06-13-quick-audit-clarity-rework/ ← реальный пример — развёрнут целиком, ниже что внутри │ │ │ │ ├── 00-proposal.md ← что и зачем меняем; какие живые файлы изменятся │ │ │ │ ├── 10-before.md ← текст «как было» — дословно │ │ │ │ ├── 20-after.md ← текст «как станет» — готов к переносу │ │ │ │ ├── 22-after-audit-quick-cards.md │ │ │ │ ├── 30-fact-preservation-map.md ← карта: каждый факт из «до» → где он в «после» │ │ │ │ ├── 40-review.md ← вердикт независимого рецензента │ │ │ │ ├── 41-clarity-cold-read.md │ │ │ │ ├── 42-review-cards.md │ │ │ │ └── 43-cold-read-headings-2models.md │ │ │ └── (ещё 1 применённых черновиков в том же формате) │ │ ├── CLAUDE.md ← точка входа для агента по этой папке │ │ ├── README.md ← короткая карта папки для людей │ │ ├── RULES-rule-change-gate.md ← правила гейта: что важное, жизненный цикл черновика, формат пакета │ │ ├── 2026-06-14-skill-header-and-routing-rework/ ← реальный пример — развёрнут целиком, ниже что внутри │ │ │ ├── 00-proposal.md ← что и зачем меняем; какие живые файлы изменятся │ │ │ ├── 10-before.md ← текст «как было» — дословно │ │ │ ├── 20-after.md ← текст «как станет» — готов к переносу │ │ │ ├── 21-after-full-skill-md.md ← весь SKILL.md «как станет» (доп. к 20-after) │ │ │ ├── 30-fact-preservation-map.md ← карта: каждый факт из «до» → где он в «после» │ │ │ └── 40-review.md ← вердикт независимого рецензента │ │ └── (ещё 1 черновиков правок в том же формате (00 → 10 → 20 → 30 → 40)) │ ├── changelog.md ← журнал изменений скилла (свежее сверху) │ ├── CLAUDE.md ← точка входа для агента по этой папке │ ├── README.md ← короткая карта папки для людей │ └── RULES-skill-maintenance.md ← как менять и поддерживать скилл, не ломая канон ├── demo/ ← страницы для людей (публикуются на pechenkometr.pages.dev) │ ├── metodika/ ← страница «Методика» — эта самая │ │ └── index.html ← собирается скриптом build-methodology-page.py │ └── index.html ← главная «Печенькометр»: объясняет скилл и печеньки + живой журнал оценок ├── references/ ← материалы, подгружаемые по надобности: чек-листы, рубрики, шаблоны, примеры │ ├── message-examples-cases/ ← полноразмерные реальные ответы парами «эталон против плохого» │ │ ├── _needs-work-candidates/ ← черновики-кандидаты в кейсы (ещё не оформлены) │ │ │ ├── 2026-06-10-plan-paid-api-run-part-1-of-2.md │ │ │ ├── 2026-06-10-progress-update-during-work.md │ │ │ ├── CLAUDE.md ← точка входа для агента по этой папке │ │ │ └── README.md ← короткая карта папки для людей │ │ ├── README.md ← короткая карта папки для людей │ │ ├── case-04-confirm-db-data-plan-export-ask-ok/ ← реальный пример — развёрнут целиком, ниже что внутри │ │ │ ├── 00-context-what-user-asked.md ← на что отвечаем (контекст запроса) │ │ │ ├── 01-good-example-ideal.md ← эталонный ответ + разбор, почему хорош │ │ │ └── 02-bad-example-poor-formatting.md ← тот же ответ с типичными промахами │ │ └── (ещё 5 кейсов в том же формате (case-NN-тип/ — 00-context → 01-good → 02-bad)) │ ├── subagent-task-examples/ ← коллекция ТЗ для субагентов: эталоны, чек-лист, кандидаты │ │ ├── _needs-work-candidates/ ← черновики-кандидаты в ТЗ-кейсы (ещё не оформлены) │ │ │ └── README.md ← короткая карта папки для людей │ │ ├── case-01-paid-api-collection-run/ ← кейс ТЗ платного сбора: контекст + эталон + антипример │ │ │ ├── 00-context-what-task-needed.md ← какая задача стояла — для чего это ТЗ │ │ │ ├── 01-good-example-ideal.md ← эталонное ТЗ + разбор, почему образец │ │ │ └── 02-bad-example-lost-raw-data.md ← то же ТЗ раньше: теряло сырьё на каждом платном запросе │ │ ├── checklist-good-subagent-task.md ← чек-лист хорошего ТЗ (10 пунктов из реальных осечек) │ │ └── README.md ← короткая карта папки для людей │ ├── audit-full.md ← полный аудит документов: блок «Контекст», термины, ссылки, полнота │ ├── audit-quick.md ← быстрый аудит (10 пунктов) с пояснениями «почему» и примерами осечек │ ├── files-to-review-templates.md ← форматы блока «Файлы к проверке» (сухой и расширенный) │ ├── judge-rubric.md ← рубрика ИИ-судьи 🤖: смысловая оценка нейросетью (4 критерия) │ ├── links-formatting-and-rules.md ← зачем ссылка-для-проверки и короткое «(открыть)» к длинному URL │ ├── message-examples-good.md ← мини-образцы «плохо → хорошо», по одному приёму │ ├── message-template.md ← готовый шаблон СДВГ-дружелюбного ответа — бери и заполняй │ └── scoring-rubric.md ← рубрика печенек 🍪: за что механический счётчик даёт баллы (8 правил) ├── scripts/ ← скрипты: авто-оценка ответов, ИИ-судья, сборка страниц │ ├── build-methodology-page.py ← ЭТОТ скрипт: собирает страницу «Методика» (режимы --check, --deploy) │ ├── jargon-list.txt ← словарик терминов для проверки «термин + расшифровка» │ ├── judge-message.py ← ИИ-судья 🤖 через нейросеть Haiku (хук Stop) │ ├── score-message.py ← механический счётчик печенек 🍪 (хук Stop) │ ├── statusline-cookies.sh ← строка состояния внизу окна: показывает свежую оценку │ └── update-demo-page.py ← вшивает свежий журнал оценок в главную demo/index.html и публикует ├── RULES-adhd-friendly-messages.md ├── RULES-agent-message-informativeness.md ├── RULES-agent-working-protocol.md └── SKILL.md ← тело скилла: главный принцип, два режима, быстрый аудит из 10 пунктов, авто-оценка