как читать реестр
Единица работы — отдельная способность
Не начинаем с большого агента. Сначала проверяем вход, результат, ограничения и воспроизводимость. Ссылки в таблице ведут на уже собранный корпус материалов.
Правило эксперимента
Один тест — одна функция: ссылка, файл или промпт на входе; сохранённый артефакт и отчёт на выходе.
Правило доказательства
Фиксируем источник, запрос, параметры, ошибки, стоимость/время и критерии «принято / доработать / невозможно».
порядок сборки
От ручной проверки к автоматизации
01 · Inputs
Ссылки, HTML, PDF, изображения, документы, ручные указания.
02 · Skills
Извлечение, анализ, написание, графика, структурирование, проверка.
03 · Pipelines
Очереди, версии, повторные запуски, human-in-the-loop и журналирование.
04 · Product
CMS, публикация, личные кабинеты, поиск, аналитика и коммерческий контур.
handoff для коллеги и ИИ
Как брать механику в работу
Выберите ID в реестре. Страница механики содержит контракт входа и выхода, критерии приёмки, структуру файлов и шаблон отчёта. Реализацию начинайте после чтения контекста проекта.
1. Выбрать ID
Открыть отдельную страницу механики, например SRC-04.
2. Собрать fixture
Положить исходные данные в fixtures/ID и описать тест.
3. Реализовать изолированно
Код — в experiments/ID, результаты — в artifacts/ID, отчёт — в reports/ID.md.
4. Вернуть доказательство
Обновить статус и приложить фактический результат. Только после этого обсуждать интеграцию.
master register
Реестр возможностей для поэтапной отработки
Начальный статус означает «нужно проверить», а не обещание реализации.
| ID | Возможность | Что проверяем | Вход | Выход / артефакт | Критерий приёмки | Источники | Статус |
|---|---|---|---|---|---|---|---|
| SRC-01 | Извлечение текста с портала | Можно ли получить основной текст, заголовок, дату, автора и структуру без меню и рекламы. | URL страницы | Чистый Markdown/JSON с сохранённым URL и временем. | Не потеряны смысловые блоки; мусор отделён. | IA, machine-readable | готово к тесту |
| SRC-02 | Извлечение графики | Найти изображения, подписи, alt, оригинальные URL, размеры и тип лицензии. | URL страницы | Реестр assets + локальные копии разрешённых файлов. | Каждый asset связан с источником и ролью. | политика ссылок | запланировано |
| SRC-03 | Извлечение таблиц и списков | Сохранить табличные данные и иерархические списки. | HTML/PDF/скриншот | CSV/JSON/Markdown с привязкой к источнику. | Структура и единицы измерения не искажены. | structured data | запланировано |
| SRC-04 | Сбор нескольких источников | Собрать материалы по теме из списка URL и не смешать источники. | Тема + URLs | Пакет evidence: фрагменты, ссылки, даты, конфликтующие факты. | Каждое утверждение имеет traceable source. | verification | запланировано |
| SRC-05 | Работа с недоступным источником | Обработать robots, paywall, JS-only, captcha, timeout и блокировки. | URL + ошибка | Диагностический отчёт без обхода ограничений. | Система честно сообщает, что извлечь нельзя. | robots/crawlers | запланировано |
| SRC-06 | Дедупликация источников | Определить повторы URL, текста, изображений и почти одинаковых материалов. | Набор источников | Duplicate report + canonical candidate. | Дубликаты объяснимы, оригинал не теряется. | M44-075 | описано |
| MED-01 | Подбор изображения к тезису | Связать визуальный asset с конкретным блоком статьи. | Текстовый блок | Роль изображения, alt, caption, prompt или source. | Изображение усиливает смысл, а не украшает случайно. | типы материалов | запланировано |
| MED-02 | Генерация изображения по prompt | Воспроизводимо отрендерить asset через утверждённый workflow. | Prompt + параметры | Изображение, seed, модель, steps, workflow-id. | Есть журнал параметров и повторяемый результат. | Design System | есть прототип |
| MED-03 | Контроль качества изображения | Проверить артефакты, гладкие поверхности, текст, композицию и соответствие prompt. | Изображение + prompt | Оценка, замечания, pass/fail, рекомендации по параметрам. | Понятно, можно ли публиковать asset. | champion tests | запланировано |
| MED-04 | Оптимизация графики | Сделать WebP/AVIF, thumbnails, responsive widths и проверить вес. | Оригинал | Набор производственных вариантов + metadata. | Качество приемлемо, размер в бюджете страницы. | архитектура | запланировано |
| MED-05 | Процедурная графика | Заменить тяжёлые декоративные изображения SVG/CSS/canvas-математикой. | Описание визуального эффекта | Детерминированный SVG/CSS/JS asset. | Легко, масштабируемо, доступно без внешнего ресурса. | бренд и дизайн | запланировано |
| MED-06 | Индекс изображений | Найти asset по статье, роли, формату, размеру, hash и статусу. | Медиатека | DB metadata + hash-based storage key. | Нет миллионов файлов в одной директории; asset traceable. | architecture | запланировано |
| EDT-01 | Сборка статьи из материалов | Собрать связный draft из URL, заметок, цитат и изображений. | Research packet | Draft article с блоками и ссылками на evidence. | Нет неподтверждённых фактов и потерянных источников. | AI editor | запланировано |
| EDT-02 | Шаблон типа материала | Применить разные композиции: guide, case, обзор, сравнение, news, how-to. | Тип + тема | Структурированный outline. | Блоки соответствуют типу, задача читателя ясна. | templates | запланировано |
| EDT-03 | Эмоциональная карта текста | Спроектировать hook, интригу, разворачивание, кульминацию и вывод. | Outline/draft | Карта по блокам + назначение каждого абзаца. | Эмоциональная динамика видима и не разрушает точность. | редакционная политика | запланировано |
| EDT-04 | Редактура стиля | Переписать текст под заданный голос, темп, длину и аудиторию. | Draft + style profile | Версия статьи + diff + style notes. | Смысл сохранён; стиль воспроизводим. | brand/design | запланировано |
| EDT-05 | Сжатие и расширение | Сделать короткую, стандартную и глубокую версии. | Draft + target length | Несколько версий с общим source map. | Версии не противоречат друг другу. | reader product | запланировано |
| EDT-06 | Структурирование для ИИ | Сделать текст читаемым для другой ИИшки: заголовки, факты, статусы, связи. | HTML/Markdown | llms.txt, manifest, stable document URLs. | Другой агент находит нужный материал без визуального чтения. | llms.txt, machine readability | есть корпус |
| VAL-01 | Проверка фактов | Сопоставить claims статьи с evidence и выявить неподтверждённое. | Draft + sources | Claim/evidence matrix. | Каждый важный claim имеет источник и дату. | verification | запланировано |
| VAL-02 | Проверка ссылок | Проверить URL, canonical, redirect, анкор, внешние и внутренние ссылки. | Article HTML | Link report + исправления. | Нет битых и неуместных ссылок. | link policy | запланировано |
| VAL-03 | Безопасность и политика | Найти вредоносные инструкции, опасные советы, приватные данные и policy violations. | Draft/source | Risk labels + moderation decision. | Опасные места объяснимо остановлены или переданы человеку. | security, precheck | запланировано |
| VAL-04 | Дубликаты и каннибализация | Понять, не повторяет ли новая статья существующую и какую URL выбрать. | Draft + corpus | Similarity report + recommendation. | Редактор видит конфликт до публикации. | IA | запланировано |
| VAL-05 | Проверка публикационной готовности | Проверить title, description, headings, images, structured data, accessibility и вес. | Candidate article | Publication Health snapshot. | Есть прозрачный checklist и score. | Publication Health | запланировано |
| PUB-01 | CMS draft и версии | Создать draft, сохранить версии, diff и историю решений. | Structured article | Versioned publication record. | Любое изменение обратимо и объяснимо. | CMS | запланировано |
| PUB-02 | Модерация и human approval | Провести AI precheck, затем назначить решение редактора. | Draft + reports | State machine: draft/review/approved/published/rejected. | AI не публикует неразрешённый материал самостоятельно. | workflow | запланировано |
| PUB-03 | Генерация публичного HTML | Собрать быструю читаемую страницу с графикой и metadata. | Approved blocks | Stable URL + static/SSR HTML. | Страница быстро читается без тяжёлого JS. | technical architecture | запланировано |
| PUB-04 | SEO/GEO/AI visibility | Подготовить JSON-LD, sitemap, robots, IndexNow и AI-readable representation. | Published article | Structured data + machine endpoints. | Поисковик и ИИ правильно понимают сущности и связи. | structured data, crawlers | запланировано |
| AI-01 | Исследовательский агент | Запустить исследование по теме, собрать источники и промежуточные выводы. | Тема/brief | Research packet + provenance. | Агент не перескакивает сразу к статье. | M44-066 | запланировано |
| AI-02 | Writer agent | Собрать черновик по утверждённому outline и source map. | Research packet | Draft с блоками, ссылками и prompt log. | Повторяемость и отсутствие выдуманных источников. | M44-067 | запланировано |
| AI-03 | Critic/editor agent | Критиковать факты, логику, стиль, структуру и эмоциональную карту. | Draft + rubric | Review report + patch suggestions. | Критика проверяема и привязана к фрагментам. | M44-068 | запланировано |
| AI-04 | Оркестрация агентов | Связать исследование, написание, критику, проверку и публикацию очередью. | Job + policy | Run ledger, шаги, retries, human gates. | Каждый запуск воспроизводим и может быть остановлен. | M44-071 | запланировано |
| AI-05 | AI provider/tool gateway | Маршрутизировать модели и инструменты через единый typed gateway. | Task + policy | Provider adapter + cost/privacy record. | Модель не выбирается случайно; есть лимиты. | M44-060–065 | запланировано |
| OPS-01 | Очередь и повторные запуски | Поставить тяжёлые операции в очередь: сбор, генерация, ресайз, анализ. | Job payload | Queue state, retry policy, dead-letter record. | Повтор не создаёт дубликатов и не ломает данные. | architecture | запланировано |
| OPS-02 | Мониторинг и Publication Health | Наблюдать качество публикаций, ошибки, задержки и очереди. | Events/metrics | Health snapshot, timeline, alert. | Проблема обнаруживается до жалобы пользователя. | Publication Health, monitoring | запланировано |
| OPS-03 | Безопасность, backup, incident | Сохранить данные, права, audit trail и план восстановления. | System events | Backup status, audit log, incident runbook. | Можно восстановить проект и объяснить действие агента. | security, SLA | запланировано |
| OPS-04 | Capacity и деградация | Не дать AI-задачам вытеснить публичное чтение и существующие сервисы. | Metrics + limits | Load policy, backpressure, graceful degradation. | При пике портал остаётся читаемым. | server capacity, architecture | запланировано |
| PROD-01 | Reader product | Проверить витрину, навигацию, чтение, сохранение и возвращение к материалу. | Published corpus | Reader journey + analytics events. | Читатель быстро понимает, что читать дальше. | Reader Product | запланировано |
| PROD-02 | Компания/эксперт/workspace | Проверить кабинет компании, роли, публикацию и verification. | Organization + article | Workspace, permissions, public entity page. | Разные организации не видят чужие данные. | cabinet, workspace | запланировано |
| PROD-03 | Distribution и рекомендации | Предложить следующий материал, канал и момент публикации. | Corpus + metrics | Next Best Publication + distribution plan. | Рекомендация объяснима и связана с целью. | Distribution, Next Best | запланировано |
| PROD-04 | Платежи и unit economics | Отдельно проверить тарифы, credits, billing, refund и ledger. | Plan/order | Idempotent payment workflow + report. | Финансовые операции не теряются и не дублируются. | unit economics, billing | запланировано |
| ED-01 | Редакторский дашборд | Показать общую картину: найдено, пишется, проверяется, ждёт публикации и опубликовано. | Состояния jobs и публикаций | Сводные KPI по статьям, темам, очередям и действиям. | Редактор понимает состояние системы за несколько секунд. | master plan | запланировано |
| ED-02 | Журнал «Что происходит сейчас» | Показать живую деятельность автономной системы человеческим языком. | События агентов и workers | Лента: источники, темы, фактчекинг, генерация, публикация. | Есть понятный event log без технических логов. | monitoring | запланировано |
| ED-03 | Календарь публикаций | Планировать утренние/вечерние слоты, переносить и публиковать немедленно. | Готовые материалы + расписание | Timeline, календарь, publish/reschedule actions. | Изменение слота не теряет версию и аудит. | вечная публикация | запланировано |
| ED-04 | Редакционный kanban | Показать поток: темы → исследование → черновик → проверка → готово → опубликовано. | Publication state machine | Колонки и карточки с перемещением. | У каждой статьи ровно одно объяснимое состояние. | CMS workflow | запланировано |
| ED-05 | Карточка состояния статьи | Показать тему, даты, качество, источники, итерации и причину выбора. | Publication record | Traceable article card + decision history. | Редактор понимает, почему система выбрала материал. | entity graph | запланировано |
| ED-06 | Новые темы до запуска производства | Повысить приоритет, отклонить, запретить или отправить тему в работу. | Topic candidates | Topic queue + editor decision. | Редактор может вмешаться до дорогого исследования. | Next Best | запланировано |
| ED-07 | Требует внимания | Собрать конфликты источников, ошибки изображений, застрявшие jobs, деплой и индексацию. | Warnings, failures, SLA | Приоритизированная attention queue. | Проблема имеет владельца, причину и следующее действие. | incidents | запланировано |
| ED-08 | Ежедневная сводка «Сегодня» | Сформировать человеческий отчёт о темах, статьях, публикациях и проблемах за сутки. | Daily events | Brief + required editor actions. | Отчёт отвечает: что сделано, что дальше, где нужно решение. | Publication Health | запланировано |
| ED-09 | Динамика и Autonomy Rate | Измерить темы, публикации, конверсию и долю циклов без человека. | Historical events | 7/30/90-day charts + autonomy metric. | Метрики считаются по единой формуле и версиям. | metrics | запланировано |
| ED-10 | Контроль качества редакции | Показать фактологию, источники, оригинальность, читаемость, SEO и графику. | Validation reports | Quality score + dimension breakdown. | Снижение качества видно до публикации. | health | запланировано |
| ED-11 | Здоровье источников | Показать отслеживаемые порталы, полезность, ошибки парсинга и доступность. | Source registry + fetch runs | Source health dashboard. | Источник можно отключить или отправить на диагностику. | sources/evidence | запланировано |
| ED-12 | Коммерческий редакционный контур | Связать заказные публикации, обязательства, оплаты и редакционные слоты. | Order + publication | Commercial queue inside editorial panel. | Платный материал не теряется среди органических. | billing | запланировано |
| REF-01 | Реестр интересующих порталов | Хранить список сайтов, тематики, приоритеты, правила доступа и частоту проверки. | Portal URL + policy | Source watchlist. | Система знает, что и зачем отслеживать. | IA | запланировано |
| REF-02 | Чтение материалов референсных порталов | Извлекать текст и структуру для исследования, не копируя статью как публикацию. | URL watchlist | Source packet + provenance. | Новая статья создаётся на основе синтеза, а не копирования. | editorial policy | запланировано |
| REF-03 | Сбор графических референсов | Собрать разрешённые/служебные ссылки на изображения для анализа стиля и качества. | URL + image metadata | Reference board, style notes, rights status. | Референс не выдаётся за собственный asset. | link policy | запланировано |
| REF-04 | Синтез и provenance новой статьи | Соединять, разделять и перерабатывать материалы с картой происхождения утверждений. | Несколько source packets | Новый материал + claim/source map. | Можно объяснить вклад каждого источника и отличия от оригинала. | verification | запланировано |
наша рабочая единица
Карточка будущего теста
Для каждой строки позже создаём отдельный test case: ID → цель → входные данные → разрешённые инструменты → шаги → ожидаемый результат → фактический результат → ошибки → артефакты → оценка → решение → следующий эксперимент.
Порядок старта: SRC-01 извлечение текста → SRC-02 графика → EDT-01 сборка статьи → EDT-03 эмоциональная карта → MED-02/03 картинка и контроль качества → VAL-01/05 проверка → PUB-01/03 публикация.