Agent Readiness Kit · v0.1

Не больше правил. Лучше управляемость

Практики, шаблоны и маленькие инструменты для команд, которые хотят получать от coding agents проверяемый результат, а не просто много сгенерированного кода.

Первые практики

Контекст — это часть инженерной системы

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

01always-on

Короткий AGENTS.md

Команды сборки, границы безопасности, definition of done и порядок проверки. Постоянный контекст должен помогать, а не съедать окно модели.

02on-demand

Навык под задачу

Рефакторинг, миграция, security review и browser QA подключаются по триггеру. Один навык — одна процедура — один отчёт с доказательствами.

03fail-closed

Гейты вместо обещаний

Опасные операции блокируются по умолчанию. Lint, typecheck, tests, build и проверка поведения должны быть исполняемыми, а не декларативными.

04scoped context

Не смешивать контексты

Одна задача — одна ветвь — один PR. Правила привязаны к стеку и путям, а параллельные сессии не получают лишний контекст. Это снижает конфликтность и делает результат воспроизводимым.

05evidence

Показывать не слова, а след

Отчёт должен содержать команду, результат, ссылку или screenshot. Если проверка не пройдена — статус PARTIAL, а не красивый PASS. Так устроены мои RAG evaluation и product delivery.

Рабочий цикл

От идеи к автономной проверке

01

Описать цель и границы.

02

Задать контракт и команды.

03

Выбрать узкий навык.

04

Запустить QA и гейты.

05

Сохранить evidence.

Принцип: агент ускоряет реализацию, но не получает право незаметно менять критерии приёмки, безопасность или production-состояние. Человек задаёт контракт и принимает evidence.
Проверено на живых проектах

Практика должна заканчиваться работающим результатом

Product

MiroBoard

Визуальная доска, BPMN 2.0, deterministic token runner, Monte Carlo, SLA и Rust/WASM core. Отдельная product page показывает границу между работающим test build и roadmap.

RAG

Vibe Content Lab

RAG-пайплайн с retrieval evaluation, Dify workflow и строгим grounding. 7/8 ручных acceptance-тестов PASS, один retrieval gap оставлен PARTIAL.

Open source foundation

Не копируем чужую работу без контекста

Эта площадка будет постепенно собирать собственные адаптации, тесты и практические выводы. Для исходных коллекций сохраняем attribution и лицензии: