# 🛠️ SKILLS RUNBOOK — портативный мануал для всех проектов Дмитрия Васильева > **Цель этого файла:** загрузить в любой новый проект (Cowork / Claude Code / ChatGPT / любой агент) — и он сразу знает какие скиллы вызывать, где лежит память, куда писать логи, какие доп проверки применять. > > **Использование:** положи этот файл рядом с `BRIEF_PORTABLE_для_других_проектов.md` в корень нового проекта. Первая команда агенту: «Прочитай BRIEF_PORTABLE и SKILLS_RUNBOOK — работаем по ним». > > **Версия:** 1.0 · Дата: 09.04.2026 --- ## 🧭 БЛОК 0 — ПЕРВЫЕ ДЕЙСТВИЯ АГЕНТА В НОВОМ ПРОЕКТЕ При старте сессии в новом проекте AI-агент обязан: 1. Прочитать `BRIEF_PORTABLE_для_других_проектов.md` (контекст Дмитрия и архитектура) 2. Прочитать этот файл (`SKILLS_RUNBOOK.md`) — список скиллов и правил 3. Проверить `.auto-memory/MEMORY.md` — если есть, загрузить записанные факты 4. Проверить наличие папки `_logs/` — если нет, создать 5. Приветствие: «Принято, контекст загружен. Что делаем?» 6. Не задавать вопросов про базу — всё должно быть понятно из брифа --- ## 📦 БЛОК 1 — ПОЛНЫЙ КАТАЛОГ СКИЛЛОВ ДМИТРИЯ ### 1.1 Собственные скиллы (созданы для Дмитрия) Лежат в `5_БАЗА_ЗНАНИЙ/Инструменты/` основного проекта 2026. | Скилл | Триггеры (что писать) | Что делает | Когда применять | |---|---|---|---| | `conversion-audit` | «аудит лендинга», «проверь конверсию», «audit» | 15-пунктовый чек-лист: hero, inline CTA, trust signals, мобильный, формы | Перед публикацией любой маркетинговой страницы | | `client-deliverable-audit` | «проверь файл клиенту», «client audit», «готово к отправке?» | 7 параллельных проверок: конверсия + грамматика + факты + ссылки + SEO + a11y + тон | Перед отправкой ЛЮБОГО файла клиенту | | `devils-advocate` | «критика», «адвокат дьявола», «разгроми», «что не так» | 3-5 неудобных вопросов, 7 углов атаки, вердикт 🟢/🟡/🔴 | Финальная проверка стратегических решений и текстов | | `post-mortem` | «работа над ошибками», «разбор провала», «почему не сработало» | 6-шаговый разбор провальных клиентских взаимодействий + обязательный upgrade других скиллов | После любого проигранного клиента/сделки | | `council-of-experts` | «совет экспертов», «совет из 5», «персоны», «разные мнения» | Параллельные субагенты-персоны (Levine/Long/Byrne для крипты; Naval/Ogilvy/Sutherland для бренда; Dershowitz/Bharara/Popehat для юридики) | Стратегические решения где нужен разноголосый взгляд | | `crypto-compliance-audit` | «проверь комплаенс», «regulatory аудит», «OFAC», «licensing» | 6 линз regulatory проверки: FATF, OFAC, BSA, Licensing, Securities, Claims | Любой материал упоминающий банки/токены/yield/custody | | `daily-review` | «daily», «дневной отчёт», «работа над ошибками» | Ежедневный отчёт и контекстный чекап | Утро/начало сессии | | `perplex` | «найди в инете», «свежие новости», «что пишут про» | Web search через Perplexity Sonar API (~$0.006/query) | Только по явной команде, не автоматически | ### 1.2 Установленные сторонние скиллы Лежат в `5_БАЗА_ЗНАНИЙ/Инструменты/_INSTALL_QUEUE/` (ожидают переноса в `~/.claude/skills/`). **Superpowers (`obra/superpowers`)** — 14 скиллов + 3 slash-команды: - `/brainstorm` — уточняющие вопросы по задаче перед реализацией - `/write-plan` — разбивка задачи на подзадачи 2-5 минут - `/execute-plan` — параллельные субагенты с изолированным контекстом - `brainstorming` — обдумывание перед кодом - `dispatching-parallel-agents` — паттерн параллельного запуска - `executing-plans` — выполнение планов - `finishing-a-development-branch` — завершение работы в ветке - `receiving-code-review` / `requesting-code-review` — ревью - `subagent-driven-development` — разработка через субагентов - `systematic-debugging` — методичный дебаг - `test-driven-development` — TDD - `using-git-worktrees` — изоляция задач через worktrees - `using-superpowers` — мета-руководство - `verification-before-completion` — финальная проверка - `writing-plans` — создание планов - `writing-skills` — создание новых скиллов **Claude SEO (`AgriciDaniel/claude-seo`)** — 13 sub-агентов для SEO аудита: - `seo-backlinks` — анализ ссылочной массы - `seo-content` — контент-анализ - `seo-dataforseo` — интеграция DataForSEO - `seo-geo` — географическое SEO - `seo-google` — Google-специфика - `seo-image-gen` — оптимизация изображений - `seo-local` — локальное SEO - `seo-maps` — Google Maps SEO - `seo-performance` — Web Vitals - `seo-schema` — schema.org разметка - `seo-sitemap` — sitemap генерация - `seo-technical` — технический аудит - `seo-visual` — визуальные элементы ### 1.3 Официальные Claude Code скиллы (Anthropic) Уже доступны в Cowork: - `pdf` — обработка PDF - `docx` — Word документы - `xlsx` — Excel спредшиты - `pptx` — PowerPoint презентации - `skill-creator` — создание новых скиллов - `youtube-transcript` — транскрипты видео - `schedule` — создание scheduled задач - `setup-cowork` — настройка Cowork **Рекомендуется доставить (из `github.com/anthropics/skills`):** - `frontend-design` — генерация UI из одного предложения - `theme-factory` — батч-генерация цветовых палитр - `brand-guidelines` — автоматизация бренд-стандартов - `mcp-builder` — создание MCP серверов - `webapp-testing` — Playwright тесты ### 1.4 Рекомендуемые community скиллы - `davila7/claude-code-templates/copywriting` — Seven Sweeps framework для текстов - `PleasePrompto/notebooklm-skill` — мост к Google NotebookLM - Vercel guidelines skills — аудит UI/UX по 100+ правилам --- ## 🔗 БЛОК 2 — ЦЕПОЧКИ СКИЛЛОВ (когда какие вместе) ### Цепочка A — «Публикация лендинга/сайта клиенту» ``` conversion-audit → client-deliverable-audit → crypto-compliance-audit → devils-advocate ``` Применять параллельно через Task tool (4 субагента в одном сообщении). ### Цепочка B — «Стратегическое решение» ``` brainstorming → council-of-experts → devils-advocate → writing-plans ``` Сначала обдумать, потом получить разноголосый взгляд, потом критику, потом план. ### Цепочка C — «Клиентское письмо / offering» ``` copywriting (Seven Sweeps) → crypto-compliance-audit → council-of-experts (LEGAL) → client-deliverable-audit ``` ### Цепочка D — «Провал / разбор ошибки» ``` post-mortem → (upgrade conversion-audit + client-deliverable-audit + devils-advocate по результатам) ``` Post-mortem обязательно должен записать новые правила в другие скиллы. ### Цепочка E — «Новый SEO проект» ``` seo-technical → seo-content → seo-schema → seo-performance → seo-backlinks ``` Через Claude SEO subagents. ### Цепочка F — «Код / разработка» ``` brainstorming → writing-plans → test-driven-development → execute-plan → verification-before-completion ``` Через Superpowers. --- ## 🧠 БЛОК 3 — СИСТЕМА ПАМЯТИ (где агент ищет и пишет) ### 3.1 Источники памяти (читать при старте) В порядке приоритета: 1. **`.auto-memory/MEMORY.md`** — глобальная auto-memory Claude Code, index всех фактов 2. **`.auto-memory/feedback_*.md`** — правила поведения (формат ответов, что нельзя, что обязательно) 3. **`.auto-memory/user_*.md`** — факты о Дмитрии (локация, таймзона, инструменты, стиль) 4. **`.auto-memory/project_*.md`** — факты о текущих проектах (Сталь, GW, дело Riedella, боты) 5. **`.auto-memory/reference_*.md`** — ссылки на внешние ресурсы, токены, ключи 6. **`BRIEF_PORTABLE_для_других_проектов.md`** — полный контекст бренда (этот файл лежит рядом) 7. **`CLAUDE.md`** (глобальный) — правила работы с Дмитрием, нумерация, темы, форматирование 8. **`CLAUDE.md`** (проектный) — специфика конкретного проекта ### 3.2 Формат записи новой памяти Когда агент узнаёт что-то важное, он создаёт файл в `.auto-memory/`: ```markdown --- name: короткое-имя-кебаб-кейс description: одна строка для поиска — что это за факт type: feedback | user | project | reference --- Тело памяти. Для feedback/project добавить: **Why:** [причина / контекст] **How to apply:** [когда и как применять это знание] ``` И добавляет строку в `.auto-memory/MEMORY.md`: ``` - [name](file.md) — одна строка хук ``` ### 3.3 Правила записи - **НЕ писать** в память: код, git history, архитектуру (выводится из файлов) - **НЕ писать** sensitive данные: SSN, банковские счета, медицинское, пароли - **Писать** только то, что полезно в БУДУЩИХ разговорах - **Обновлять** существующие записи, не создавать дубли - **Удалять** устаревшие факты ### 3.4 Когда обращаться к памяти - Явная команда: «вспомни», «проверь память», «что ты помнишь» - Перед ответом на вопрос где релевантен прошлый контекст - При старте сессии — быстрый скан MEMORY.md - ВЕРИФИЦИРОВАТЬ факты из памяти перед действиями — память может устареть --- ## 📝 БЛОК 4 — СИСТЕМА ЛОГОВ (куда агент пишет что сделал) ### 4.1 Структура папки `_logs/` ``` _logs/ ├── daily/ │ └── 2026-04-09.md ← сводка действий за день ├── skills/ │ ├── conversion-audit/ │ │ └── 2026-04-09_vda-vc-hero.md ← результат применения скилла │ └── crypto-compliance-audit/ │ └── 2026-04-09_gw-pricing.md ├── clients/ │ ├── stal/ │ │ └── 2026-04-09_meeting-notes.md │ └── gw/ │ └── 2026-04-09_compliance-report.md └── errors/ └── 2026-04-09_audit-failed.md ← лог провалов и фиксов ``` ### 4.2 Формат daily лога Создаётся автоматически при запуске `daily-review` или при завершении сессии: ```markdown # Daily Log — 2026-04-09 ## Что сделано - [skill] создан crypto-compliance-audit - [client:gw] gw-pricing.html обновлён - [memory] добавлено правило question-mark-rule ## Что не удалось - Не найдены оригинальные цвета SGB (домен припаркован) ## Решения принятые - Council-of-experts паттерн = через Task tool + персональные промпты - 0 в меню = выполнить все пункты сразу ## Открытые задачи - GW редизайн в светлом голубом - Создать gw-compare.html - Доставить superpowers в ~/.claude/skills/ ## Метрики - Скиллов создано за день: 3 - Файлов записано: 8 - Токенов потрачено: [estimated] ``` ### 4.3 Формат лога применения скилла ```markdown # Skill: conversion-audit ## Target: vda-vc-hero.html ## Date: 2026-04-09 ## Verdict: 🟡 FIX YELLOWS FIRST ### Green (passed) - Hero имеет один primary CTA - Mobile-first layout присутствует ### Yellow (fix needed) - Trust signals отсутствуют в viewport mobile - Inline CTA только один ### Red (stop) - (нет) ## Actions taken - Добавлены trust badges в hero mobile - Добавлен inline CTA в секцию услуг ``` ### 4.4 Когда писать в логи - После каждого применения любого скилла — обязательно - При провале — в `_logs/errors/` с fix description - При важном решении — краткая запись в `_logs/daily/` - При работе с клиентом — `_logs/clients/{name}/` --- ## ✅ БЛОК 5 — ДОП ПРОВЕРКИ (gates перед публикацией/отправкой) ### 5.1 Обязательный gate «Перед отправкой клиенту» Перед словами «готово», «отправляю», «запушено», «можно показывать» для ЛЮБОГО файла: 1. `conversion-audit` — механический чек-лист 2. `client-deliverable-audit` — 7 параллельных проверок 3. `crypto-compliance-audit` — если есть упоминание финансовых продуктов 4. `devils-advocate` — финальный критический взгляд Все ВХОДЯТ в один субагент-вызов (параллельно через Task tool). Если ЛЮБОЙ возвращает 🔴 — не отправлять, показать отчёт. ### 5.2 Обязательный gate «Перед публикацией публично» Дополнительно к 5.1: 5. **NFA disclaimer check** — при любом упоминании финансов обязательно должен быть «This is not financial advice» 6. **Jurisdiction disclaimer** — «Available to non-US persons only» для всех клиентских крипто-продуктов 7. **Source citation check** — любые числа должны иметь ссылку на источник ### 5.3 Обязательный gate «Перед записью в память» 1. Это полезно для БУДУЩИХ разговоров? 2. Это не дублирует существующую запись? 3. Это не sensitive (SSN, пароль, медицина, домашний адрес)? 4. Если feedback — есть ли «Why» и «How to apply»? Если хоть одно «нет» — не записывать. ### 5.4 Обязательный gate «Перед git push» 1. `git status` — есть ли неожиданные файлы? 2. Нет ли секретов в diff? (токены, пароли, ключи) 3. Commit message описывает «почему», не «что»? 4. Если это `index.html` — получено ли явное разрешение от Дмитрия? --- ## 🎛️ БЛОК 6 — КАК ЭФФЕКТИВНО ВЫЗЫВАТЬ СКИЛЛЫ ### 6.1 Правила вызова - **Молча** — не объяснять Дмитрию какой скилл применил, просто применять - **Параллельно** — 3+ скилла через Task tool в одном сообщении - **По триггерам** — из description поля скилла автоматически при совпадении слов - **Цепочками** — из блока 2 этого runbook ### 6.2 Task tool паттерн (параллельные субагенты) ``` [сообщение с 4 Task tool вызовами в одном блоке] Task 1: subagent_type="general-purpose", prompt="Apply conversion-audit to X" Task 2: subagent_type="general-purpose", prompt="Apply client-deliverable-audit to X" Task 3: subagent_type="general-purpose", prompt="Apply crypto-compliance-audit to X" Task 4: subagent_type="general-purpose", prompt="Apply devils-advocate to X" ``` Результаты собираются в сводный отчёт с объединённым вердиктом. ### 6.3 Council of Experts паттерн Для задач требующих разноголосого взгляда: ``` Task 1: general-purpose, prompt="Ты Matt Levine. Задача: [...]. Ответь в своём стиле 5 предложений." Task 2: general-purpose, prompt="Ты Caitlin Long. Задача: [...]." Task 3: general-purpose, prompt="Ты Preston Byrne. Задача: [...]." ``` Затем сборка в формат «где согласны / где конфликтуют / итог». ### 6.4 Когда НЕ использовать скиллы - Простые факт-вопросы («какой сегодня день») - Разговорные реплики - Когда Дмитрий явно сказал «быстро / без аудита / черновик» - В режиме черновика — накапливать до команды «собирай/применяй» --- ## 🗂️ БЛОК 7 — СТРУКТУРА НОВОГО ПРОЕКТА Когда Дмитрий создаёт новый проект (entertainment / Pintopay / SaaS / etc.), агент должен сразу создать такую структуру: ``` project-name/ ├── BRIEF_PORTABLE_для_других_проектов.md ← контекст Дмитрия (копия) ├── SKILLS_RUNBOOK_для_других_проектов.md ← этот файл (копия) ├── CLAUDE.md ← правила конкретного проекта ├── .auto-memory/ │ └── MEMORY.md ← index памяти ├── _logs/ │ ├── daily/ │ ├── skills/ │ ├── clients/ │ └── errors/ ├── src/ ← код/HTML/контент ├── docs/ ← документация └── README.md ``` ### 7.1 Минимальный CLAUDE.md для нового проекта ```markdown # Проект: [название] ## Контекст Читать `BRIEF_PORTABLE_для_других_проектов.md` и `SKILLS_RUNBOOK_для_других_проектов.md`. ## Цель проекта [одно предложение] ## Специфика - Аудитория: [кто] - Ключевая метрика: [что считаем] - Табу: [что нельзя говорить/делать] - Обязательно: [что должно быть в каждом выходе] ## Скиллы которые применять [из SKILLS_RUNBOOK, цепочка подходящая проекту] ``` --- ## 🔄 БЛОК 8 — ОБНОВЛЕНИЕ RUNBOOK Этот файл — живой. Обновляется когда: 1. Создаётся новый скилл → добавить в каталог (блок 1) 2. Обнаруживается новая эффективная цепочка → добавить в блок 2 3. Изменяется структура памяти/логов → блоки 3-4 4. Post-mortem выявил пробел в проверках → блок 5 5. Найден новый полезный community скилл → блок 1.4 **Правило обновления:** каждое обновление = новая версия + дата в шапке. --- ## 📋 БЛОК 9 — ЧЕК-ЛИСТ ПРИ СТАРТЕ В НОВОМ ПРОЕКТЕ Агент при первом запуске в новом проекте должен ответить «Да» на все: - [ ] Прочитан `BRIEF_PORTABLE`? - [ ] Прочитан `SKILLS_RUNBOOK` (этот файл)? - [ ] Создана папка `.auto-memory/` (если не было)? - [ ] Создана папка `_logs/daily|skills|clients|errors/`? - [ ] Создан или прочитан `CLAUDE.md` проекта? - [ ] Проверено что ключевые скиллы доступны (conversion-audit, devils-advocate, council-of-experts)? - [ ] Понятна специфика проекта (аудитория, метрика, табу)? - [ ] Готов блок «💡 Куда двигаться дальше?» с правильной нумерацией? Только после всех галочек — агент начинает работу. --- ## 📎 БЛОК 10 — КРИТИЧЕСКИЕ ПРАВИЛА (не нарушать) 1. **Нумерация идей сквозная** — не сбрасывать между сессиями 2. **0 в меню** = выполнить ВСЕ пункты, не один 3. **`цифра+?`** (например `37?`) = развернуть, объяснить, не выполнять пункт 4. **Светлые темы по умолчанию** — никогда dark как default 5. **Не перезаписывать** существующие версии сайтов — создавать `v2.html`, `v3.html` 6. **Telegram не отправлять автоматически** — только по явной команде 7. **Скиллы применять молча** — не объяснять Дмитрию 8. **Русский язык** — даже если вопрос по-английски 9. **Минимум форматирования** — без жирных блоков, пункты в столбик 10. **Режим черновика** — накапливать правки, применять по команде «собирай» 11. **Гейт перед публикацией** — conversion-audit + client-deliverable-audit + devils-advocate (+ crypto-compliance-audit если применимо) 12. **Память обновлять** при изучении новых фактов, но с фильтром «полезно в будущем» 13. **Логи писать** после каждого применения скилла 14. **Post-mortem** после любого провала — и обязательно upgrade других скиллов --- *Runbook v1.0 · 09.04.2026 · Автор: DEMI(Бот) для Дмитрия Васильева*