Райан Лопополо предлагает неочевидный способ радикально улучшить работу кодовых агентов: не менять модель, а перестроить окружение. Он называет это harness engineering — инженерная практика, где сама модель и код агента остаются чёрным ящиком, а вы меняете только два внешних рычага: контекст и инструменты.
Окружение должно давать агенту пять вещей: восстанавливать замысел задачи, работать с реальной системой, подчиняться иерархии, доказывать результат и оставлять следующему запуску лучшие условия. Главная цель такого подхода — передать в код нефункциональные требования организации: надёжность, безопасность, совместимость, поддерживаемость, производительность, управляемость, риск-профиль и полировку. А ещё — локальные решения о приоритетах и компромиссах. Лопополо позаимствовал системный взгляд с конференции [un]prompted 2026 года: вся вселенная нефункциональных требований должна быть закодирована.
Make the Repository Teach the Agent — ключевая идея: репозиторий становится средой, которая через контекст, примеры, инструменты и исполняемые ограничения передаёт агенту, как именно нужно работать. Поскольку разработка — это итеративная игра, обвязка делает организационную экспертизу накопительной. Уроки принятых правок, исправлений, сбоев и реакций пользователей превращаются в границы, инструменты, примеры и проверки для будущих траекторий. Так когерентность артефактов накапливается сама собой.
Код для агента — внутренний язык действий. Он выдаёт надёжные предметные результаты людям, которые никогда не заглядывают в реализацию, если last-mile deployment подкладывает организации контекст, возможности, полномочия и доказательства. Веса общей модели — лишь видимая верхушка айсберга process-data. Под водой — текущее состояние системы, локальная онтология, планка качества, процедуры, история исключений и отношения полномочий. Без этого агент не сделает конкретную работу. Организация не может полагаться, что приватные изменчивые данные уже есть в весах модели, или что агент догадается, что из них важно. Harness engineering — последняя миля, которая делает эти данные доступными через контекст и инструменты.
Точка входа — файл AGENTS.md в репозитории. Он направляет задачу к нужным аргументам, кейсам и доказательствам. Для чтения — thesis index, для применения — playbooks. Материалы репозитория распространяются под лицензией CC BY 4.0, атрибуция и права — в COPYING.md.