convez.ai
AgenteAutomaçãoAvançado
glebis

PrintProof Agent — Corretor Automático para Tipografia

glebis/print-proof-agent

Automação de correção tipográfica com pipeline rule/LLM/vision e aprovação auditável

Ver no GitHub
InicialPluginScore · de 0 a 100

Agent autônomo baseado no Claude Agent SDK para correção de provas tipográficas (folhetos, livretos, layouts finais) em um dia em vez de uma semana. Implementa um pipeline em cascata (regras determinísticas → LLM → visão computacional) com rastreamento de provenance para cada sugestão, permitindo que gerentes de tipografia revisem e aprovem mudanças com transparência total antes da impressão.

Instalação

$npx convez-ai glebis/print-proof-agent

1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.

Métricas

Estrelas
1
Forks
2
Acompanhando
0
Saúde
42%
Último commit
há 5 meses
Versão
—
Issues abertas
0
Contribuidores
1

Casos de uso

  • Acelerar ciclo de correção de provas em tipografias e gráficas
  • Rastrear origem de cada alteração (rule, LLM ou análise visual) para auditoria
  • Validar automaticamente ortografia, pontuação, espaçamento e formatação antes da impressão
  • Detectar problemas de layout (blocos sobrepostos, legibilidade) em PDFs e imagens

Veredito

Projeto técnico robusto: pipeline bem arquitetado, testes unitários abundantes (83+), integridade de offsets via CRDT, vision-snapping para PDFs. Caso de uso real (tipografia) com UX pensado para revisor humano, não para co-autoria. Produção-ready com bom design de erros e rastreabilidade.

README

A tradução para o português deste README ainda está na fila.

PrintProof — агент-корректор для типографии

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

Пилотное приложение на Claude Agent SDK, построенное в Claude Code Lab (когорта 5) как сквозной пример: от JTBD-интервью и аудита архитектуры до работающего приложения с 83 юнит-тестами, проверенного в браузере.

Часть Claude Code Lab License: MIT


Задача (Job to Be Done)

Менеджер типографии: срочные заказы упираются в этап корректуры (~неделя при цели «день») — поиск свободного корректора, ожидание правок, переговоры о сроках и цене через почту, мессенджеры и Excel, которые «не сходятся».

«Когда заказ доходит до корректуры, я хочу получить вычитанный текст без уговоров и переговоров с людьми — чтобы это занимало день вместо недели, а срок и цена были известны заранее».

Главный UX-принцип: приложение оптимизировано под человека-проверяющего, а не под соавторство. Каждая правка несёт provenance — какой модуль её сделал, на каком основании, с какой уверенностью. Каждое действие объясняет последствия до клика. Ошибка в тираже необратима, поэтому ничего не уходит в печать без явной приёмки менеджером.

Как это работает: каскад B-lite

Архитектура выбрана после внешнего аудита (вместо «оркестратор + параллельные субагенты по категориям» — категории живут в данных и UI, а не в runtime):

Загрузка (DOCX / TXT / MD / PDF / PNG / JPEG)
  ↓ нормализация в immutable-текст rev.1
Оценка — объём, время, цена сразу (предсказуемость = продукт)
  ↓
┌─ Rule-pass    детерминированно, 0 токенов: тире, кавычки-ёлочки, пробелы, словарь клиента
├─ LLM-pass     один query() Agent SDK: орфография, пунктуация, стиль → Edit[]
└─ Vision-pass  только PDF/картинки: налезающие блоки, читаемость → задание дизайнеру
  ↓ Resolver (код): дедуп, конфликты по span, сортировка
Приёмка менеджером — поштучно / категорией / все; хоткеи; word-diff; фильтры; поиск
  ↓ только accepted, сборка курсором по immutable-базе
Экспорт: Markdown · DOCX · протокол приёмки · CSV · задание дизайнеру · архив (JSON)

Ключевые инженерные решения

  • Целостность правок. Все span-координаты — в неизменяемом тексте одной ревизии; экспорт собирает результат курсором по отсортированным принятым правкам, а не применяет их по одной с пересчётом offsets (классический баг текстовых редакторов; принцип как в CRDT/git).
  • LLM не считает координаты. llm-pass возвращает фрагмент + контекст, позицию вычисляет код; галлюцинированные фрагменты отбрасываются.
  • snap-to-text для PDF. Vision оценивает bbox «на глаз» (±10%); для PDF рамки уточняются по точной геометрии текстового слоя — каждое замечание ложится на своё слово.
  • Подписка, не API-ключ. В пилоте Agent SDK работает под подпиской Claude Code (ANTHROPIC_API_KEY снят перед вызовами).
  • Тестируемая архитектура. Бизнес-логика — чистые функции в src/lib/, покрытые юнит-тестами (мс, без браузера и LLM); интеграция в роуты/UI остаётся тонкой.

Возможности

ОбластьЧто есть
Корректураrule-pass (типографика + словари), llm-pass (орфография/пунктуация/стиль), vision-pass (макеты)
Приёмкаprovenance-тултипы, word-diff, навигация ‹ ›, мигание цели, хоткеи (j/k/a/r, RU-раскладка), фильтры по статусу/категории, поиск, сортировка, предпросмотр итогового текста
Макетымногостраничные PDF, bounding-boxes на изображении, клик-по-рамке → замечание, быстрое принять/отклонить
Профили клиентовдетерминированные правила + стилевой промпт + few-shot примеры; редактирование через чат-агент (Vercel AI SDK + умные виджеты) и напрямую формой; самообучение словаря из повторяющихся правок
Автоматизацияавто-принятие безопасных правок (opt-in, только rule-pass/profile, не «важные»), перепроверка с сохранением решений, очередь проверок
Контроль и аудитпротокол приёмки (кто/что/когда), фактический расход токенов и стоимость, оценка vs факт, SLA-бейдж, детектор дубликатов, валидация загрузки
ЭкспортMarkdown, DOCX, протокол, CSV (Excel-ru), задание дизайнеру, полный архив заказа (JSON)
ДоступACL: admin / manager / client / designer; админка пользователей и клиентов

Стек

  • Next.js 15 (App Router) + TypeScript + React 19
  • Claude Agent SDK (@anthropic-ai/claude-agent-sdk) — LLM и vision проходы, чат-агент профилей через in-process MCP-инструменты
  • Vercel AI SDK (ai + @ai-sdk/react) — чат-интерфейс профилей с generative-UI виджетами
  • better-sqlite3 — встроенная БД
  • mammoth (DOCX), pdf-parse v2 (текст + рендер страниц), docx (экспорт)
  • vitest — 83 юнит-теста

Запуск

# зависимости
npm install

# Agent SDK под подпиской Claude Code — снять API-ключ
unset ANTHROPIC_API_KEY

# дев-сервер (порт 3742)
npm run dev

# тесты
npm test

Откройте http://localhost:3742. В шапке — демо-переключатель пользователя (роли). Загрузите файл, дождитесь каскада, примите правки, экспортируйте.

Пилот, не продакшн. Зафиксированные ограничения: DOCX-экспорт без сохранения оригинальной вёрстки; vision до 10 страниц PDF; демо-аутентификация без паролей; хранение файлов на диске.

Дорожная карта до продакшна

Приложение прошло внешний аудит реализации (Codex). Закрытые по итогам баги: object-level ACL, защита приёмки от чужих правок, fail-closed при ошибке Agent SDK. Осталось до реального потока заказов в типографии:

  • Print preflight (детерминированный) — PDF/X, размер страницы, bleed/safe area, DPI, RGB/CMYK, встроенные шрифты, overset text. Vision-pass не заменяет prepress-проверку.
  • Durable-очередь — атомарный claim задания в SQLite (UPDATE … RETURNING / отдельная таблица jobs), lease/lock, retry/backoff, cancellation, heartbeat воркера. Текущий spawn('npx tsx') — пилотный.
  • Версионный workflow — комментарии к правкам, назначение дизайнеру/менеджеру, финальное approve клиента, история ревизий, diff между прогонами.
  • Эксплуатация — деплой, настоящая аутентификация (пароли/magic-link), S3-хранилище, переход с подписки на API-ключ.
  • Расширения корректуры — OCR бумажных правок корректора, точный DOCX-патчинг с сохранением вёрстки.

Структура

src/
├── agent/        каскад: rules, proofread (llm), layout-inspect (vision),
│                 resolver, auto-accept, pdf-anchors (snap-to-text), check (оркестрация)
├── lib/          чистая бизнес-логика (23 модуля): export, edit-filter, search-sort,
│                 word-diff, dictionary-suggest, usage, sla, cost-delta, archive, auth, db…
├── app/
│   ├── api/      17 роутов: orders, decide, export, recheck, profiles, admin, auth, stats…
│   ├── orders/   экран приёмки
│   ├── profiles/ профили + чат-агент
│   └── admin/    пользователи и клиенты
└── components/   UserBar
tests/            24 файла, 83 юнит-теста

Происхождение

Построено за одну серию сессий в Claude Code Lab по сквозному маршруту: JTBD-интервью (/jtbd) → аудит архитектуры внешней моделью (Codex) → SVG-прототипы с provenance-тултипами → TDD-ядро → работающее приложение, проверенное реальным браузером (browser-mate) → итеративные фичи по 5–10 за раунд, каждая через TDD.

Дизайн-документ: docs/DESIGN.md.

Авторство и лицензия

MIT — см. LICENSE. Архитектура и дизайн — человеческие; реализация ассистирована Claude и отревьюена с Codex под человеческим руководством. Подробности в AUTHORSHIP.md.

— Gleb Kalinin, Berlin · agency-lab.glebkalinin.com

Ver o original no GitHub

Bom para

Relacionados