Blueprints—следующий уровень после Skills

Полгода назад мы узнали про Agent Skills. Формат SKILL.md от Anthropic—пакет инструкций, который превращает AI-агента в специалиста по конкретной задаче. Один раз написал—переиспользуешь бесконечно.

И мы начали. Написали десятки скилов. Компиляция wiki, генерация постов, ревью кода, деплой по команде. Мой Claude Code оброс навыками как швейцарский нож на стероидах—лезвиями и штопорами.

А потом друг попросил: "Скинь мне свой скил для wiki, хочу у себя такое же."

Я скинул. Он открыл. И написал: "Бро, тут всё завязано на твои папки, твои агенты и твою структуру vault. Мне это бесполезно."

Он был прав.

Почему скилы не масштабируются

Скилы решили огромную проблему. Вместо одноразовых промптов—повторяемые workflow. Вместо "объясни модели каждый раз"—"модель уже знает, как это делать".

SKILL.md стал стандартом. Его поддерживают Claude Code, OpenAI Codex, Cursor, Gemini CLI. Vercel запустил skills.sh—маркетплейс скилов. Microsoft интегрировал в Agent Framework. Всё прекрасно.

Но есть нюанс.

Чем мощнее скил—тем сильнее он привязан к контексту автора.

Простой скил ("сгенерируй commit message по conventional commits") работает у всех. Он атомарный, у него нет зависимостей.

Сложный скил ("скомпилируй wiki из сырых заметок в моём vault")—это другая история. Он знает мои папки (510 Input/, 540 Research/). Он знает мой формат метаданных. Он знает, какой агент что делает. Забери его из моего контекста—и он мёртвый.

Это как рецепт. "Возьмите 200г муки"—работает у всех. "Возьмите тесто из третьего ящика моего холодильника"—работает только у меня.

И вот парадокс: самые ценные скилы—те, которые нельзя передать другому. Потому что их ценность в том, что они точно настроены под тебя.

Три уровня передачи знаний

Что было до скилов? Что будет после? Если выстроить в ряд—видна лесенка:

Промпты (2023–2024)—одноразовые инструкции. Скопировал, вставил, получил результат. Портируемость максимальная—это просто текст. Повторяемость минимальная—результат зависит от контекста, модели, фазы луны. Передача знаний: "скопируй этот текст."

Промпты решили проблему входа: любой человек мог начать использовать AI. Но они не масштабируются. Чем сложнее задача, тем длиннее промпт, тем хрупче результат.

Скилы (2025–2026)—повторяемые workflow. Формат стандартный (SKILL.md), работает в Claude Code, Codex, Cursor, Gemini CLI. Повторяемость высокая—одинаковый процесс каждый раз. Но портируемость контекста низкая: лучшие скилы привязаны к окружению автора. Передача знаний: "установи этот пакет."

Скилы решили проблему повторяемости. Но у них есть потолок—и я описал его выше.

Blueprints (2026+)—архитектурные описания систем. Портируемость полная: принципы и архитектура, не привязанные к конкретным путям и инструментам. Результат—рабочая система, собранная под конкретного пользователя. Сложность задач—целые системы и процессы. Передача знаний: "дай это своему агенту, он соберёт."

Blueprint—это не скил. Это документ, по которому агент создаёт скилы, настроенные под конкретного пользователя. Blueprint не исполняется напрямую—он порождает навыки, конфигурации и автоматизации через диалог между человеком и агентом.

Ключевое отличие от Skill

	Skill	Blueprint
Что описывает	Конкретный workflow	Архитектуру системы
Исполняется	Да, напрямую агентом	Нет—порождает skills и конфигурации
Привязан к контексту	Да (пути, инструменты, соглашения)	Нет (принципы и паттерны)
Результат копирования	Работает, если совпал контекст	Работает всегда—адаптируется

Skill говорит: "вот как я компилирую wiki—сканируй Input/, запиши в Wiki/, используй такой-то агент".

Blueprint говорит: "вот как устроена LLM-компилируемая wiki—источники, компилятор, линтер, индекс. Собери у себя из того, что есть".

Анатомия Blueprint

Blueprint—документ для двоих. Человек читает его, чтобы понять идею и решить "хочу ли я это у себя". Агент читает его, чтобы понять архитектуру и помочь человеку собрать систему. Поэтому каждая секция работает на обоих читателей.

Обязательные секции

1. Когда использовать Конкретные ситуации, в которых этот паттерн решает проблему. Человек читает и понимает—это про него или нет. Агент использует эту секцию, чтобы предложить Blueprint, когда видит подходящую ситуацию.

2. Ключевая идея Одно-два предложения: в чём суть подхода. Разделение ролей: что делает человек, что делает AI. Для агента это контракт—что от него ожидается.

3. Архитектура Визуальная схема компонентов и потоков данных. Абстрактная, без привязки к конкретным инструментам. Агент использует её как карту: какие части системы нужно создать.

4. Ключевые принципы Правила, которые делают систему рабочей. Не "как нажимать кнопки", а "почему именно так". Для агента это constraints—ограничения, которые нельзя нарушать при адаптации.

5. Workflow Пошаговые процессы для типичных сценариев. Описаны абстрактно—"источники", "компилятор", "индекс". Агент адаптирует их под конкретные папки, инструменты и соглашения пользователя.

6. Компоненты Описание каждого функционального блока: что на входе, что на выходе, какие требования. Агент использует это как спецификацию для создания конкретных skills и конфигураций.

7. Как применить Точка входа для пользователя: где запустить агента, что ему сказать, какой контекст нужен. Некоторые Blueprints работают в одном контексте (всё в vault), другие требуют нескольких (vault + code project). Эта секция убирает неопределённость: человек читает и сразу знает, с чего начать. Для агента—понимание, в каком рабочем окружении он находится и к чему ещё ему нужен доступ.

8. Вопросы для адаптации Список вопросов, которые агент должен задать пользователю перед сборкой. Это ключевая секция для agent-driven подхода. Примеры:

"Где у тебя хранятся сырые заметки?"
"Какой инструмент ты используешь для автоматизации?"
"Плоская структура или иерархия?"
"Нужна автоматизация по расписанию или ручной запуск?"

Вопросы покрывают все decision points, где архитектура допускает варианты.

9. Нюансы и грабли Типичные ошибки, edge cases, неочевидные решения. Для человека—предупреждение. Для агента—guardrails при реализации.

Опциональные секции

Метаданные YAML frontmatter с типом, датой, тегами.

Масштабирование В каких ещё доменах этот паттерн применим. Помогает человеку и агенту увидеть возможности шире конкретного примера.

Реализация-пример Одна конкретная реализация—универсальная, без привязки к автору. Таблица "компонент → чем можно реализовать". Показывает, что Blueprint реален, а не теоретический.

Выходные артефакты Что именно агент должен создать по итогам сборки: skills, папки, конфигурации, индексные файлы. Чеклист для верификации—всё ли на месте.

Как Blueprint работает на практике

Создание (автор)

Автор строит систему у себя
        │
        ▼
Извлекает принципы, архитектуру, грабли
        │
        ▼
Формулирует вопросы для адаптации
(decision points, где контекст влияет на реализацию)
        │
        ▼
Пишет Blueprint — без привязки к своему контексту
        │
        ▼
Публикует

Использование (человек + агент)

Человек находит Blueprint
        │
        ▼
Отдаёт агенту: "Собери мне это"
        │
        ▼
Агент читает Blueprint ─────────────────────────┐
        │                                       │
        ▼                                       │
Агент задаёт вопросы из секции                  │
"Вопросы для адаптации"                         │
        │                                       │
        ▼                                       │
Человек отвечает про свой контекст:             │
папки, инструменты, соглашения                  │
        │                                       │
        ▼                                       │
Агент строит систему:                           │
├── создаёт папки и файлы                       │
├── генерирует skills под этот контекст         │
├── настраивает автоматизацию               Принципы и
└── проверяет по секции                     constraints
    "Нюансы и грабли"                       как guardrails
        │                                       │
        ▼                                       │
Рабочая система, персонализированная ◄──────────┘
под конкретного пользователя

Человек находит Blueprint и отдаёт агенту: "Собери мне это"
Агент читает Blueprint—понимает архитектуру, принципы, constraints
Агент задаёт вопросы из секции "Вопросы для адаптации"
Человек отвечает про свой контекст: папки, инструменты, соглашения
Агент строит систему: создаёт папки, генерирует skills, настраивает автоматизацию
Агент проверяет результат по секции "Нюансы и грабли" как guardrails
Результат—рабочая система, персонализированная под конкретного пользователя

Ключевой сдвиг: человек не читает Blueprint как мануал и не строит систему руками. Он передаёт Blueprint агенту и отвечает на вопросы. Агент делает тяжёлую работу—адаптацию, создание артефактов, проверку constraints.

Blueprint—это мост между "у меня работает" и "у тебя тоже заработает". Но мост проходится не ногами, а вместе с агентом.

Что НЕ является Blueprint

Туториал—пошаговая инструкция "сделай вот это в конкретном инструменте". Туториал устаревает при обновлении интерфейса. Blueprint описывает принципы, которые переживают смену инструментов.
Шаблон (template)—заготовка файла для заполнения. Шаблон—это часть реализации. Blueprint может порождать шаблоны, но сам шаблоном не является.
Документация инструмента—как пользоваться конкретным продуктом. Blueprint инструмент-агностичен.
Prompt / Skill—исполняемая инструкция. Blueprint не исполняется напрямую—он читается агентом, который через диалог с человеком порождает исполняемые артефакты (skills, конфигурации, структуры).
System prompt / CLAUDE.md—конфигурация поведения агента. Blueprint не настраивает агента—он даёт агенту знание о том, какую систему строить.

Уровни абстракции

                    Портируемость
                    ▲
  Blueprint --------●  Полная (принципы + архитектура)
                    │
                    │
  Skill ------------●  Формат портируем, контекст — нет
                    │
                    │
  Prompt -----------●  Текст копируется, результат не гарантирован
                    │
                    └──────────────────────► Конкретность исполнения

Чем выше по оси—тем больше людей могут воспользоваться. Чем правее—тем точнее результат для конкретного пользователя. Blueprint жертвует конкретностью ради универсальности. Skill жертвует универсальностью ради конкретности. Они не конкурируют—они работают на разных уровнях.