LoopKit: набор из 49 навыков и харнес для AI-кодинг агентов

LoopKit — это drop-in .claude/ харнес и 49 навыков для AI-кодинг агентов, которые следуют циклу Plan → Act → Verify. Автор, известный как archive, выложил снаряжение, которым пользуется сам: не методология, не фреймворк, а реально работающий набор файлов, который кладётся в проект и с ходу включает агента в правильный рабочий ритм.

Что такое LoopKit

Это .claude/ директория автора, готовая к использованию. Внутри: настройки, хуки, верификатор-сабагент, loop runner и 49 навыков. Никакого рантайма — только файлы на диске.

LoopKit — это:

• Рабочий харнес из 7 файлов и 49 навыков
• Навыки, загружающиеся только при срабатывании триггера (YAML frontmatter)
• Кросс-агентная совместимость: Claude Code, Cursor, Codex, Gemini CLI, Windsurf, GitHub Copilot CLI

LoopKit — это не:

• Новая методология (ни BMAD, ни Prime Radiant, ни 6-фазовый жизненный цикл)
• Wrapper CLI — никаких демонов и серверов; run.sh состоит из 8 строк
• Vendor lock-in — MIT, форкай, оставляй только нужные три навыка

Цикл: Plan → Act → Verify

Все навыки работают внутри одного цикла, который enforced харнесом:

  PLAN ——▶  ACT  ——▶  VERIFY
    ▲                    │
    └────── revise ──────┘

• PLAN — загружаются spec-first, context-budget, tool-restraint, planner-spec-expand, sprint-contract
• ACT — загружаются доменные навыки (debug, security, testing, refactoring, docs, data, git/ops)
• VERIFY — adversarial-verify + evaluator-calibration + сабагент-верификатор закрывают цикл до того, как что-то уйдёт в прод

Что вы получаете (файл за файлом)

your-project/
├── .claude/
│   ├── CLAUDE.md          # 60 строк контекста (стек, команды, конвенции)
│   ├── settings.json      # permission allowlist + format-on-write хук
│   ├── agents/
│   │   └── verifier.md    # adversarial verifier subagent (Haiku, JSON)
│   ├── hooks/             # session-start bootstrap
│   └── skills/            # 49 навыков
├── .mcp.json              # MCP server wiring (github, context7)
├── MEMORY.md              # cross-session memory index
└── run.sh                 # Plan → Act → Verify loop runner

.claude/CLAUDE.md — 60 строк контекста. Налог на каждый ход агента. Стек, раскладка, команды, конвенции, три вещи, которые агенту запрещено делать.

.claude/settings.json — разрешения и хуки. Allowlist для безопасного Bash и Read; deny-list для rm -rf и force-push. PostToolUse хук запускает Prettier после каждого Edit/Write.

verifier.md — adversarial сабагент на Haiku. Читает diff, предполагая что он сломан. Проверяет 11 паттернов «фальшивого done» из навыка adversarial-verify. Возвращает JSON. Не предлагает исправлений, не запускает код, не вежлив.

run.sh — loop runner из 8 строк. Читает PROMPT.md + IMPLEMENTATION_PLAN.md, делает один шаг, верифицирует, повторяет пока STATUS: done. Свежий контекст на каждой итерации, состояние живёт на диске.

Библиотека навыков: 49 навыков в 10 треках

agent/llm — поведение агента

• context-budget — обрезать рабочий сет → перед большими чтениями
• spec-first — контракт перед кодом → любая новая фича
• tool-restraint — брать минимальный инструмент → избегать Bash-for-everything
• subagent-fanout — параллельные независимые пробы → research/audit

loop & harness — многозаходная дисциплина

• planner-spec-expand — 1–4 предложения → полноценная спецификация
• sprint-contract — «done» как script-decidable предикаты до написания кода
• self-eval-bias — прерывает наивную самооценку агента
• evaluator-calibration — few-shot калибровка ревьюера
• harness-stripping — снимать компоненты харнеса и мерять влияние на каждом релизе модели

debug, security, testing, refactor, docs, data, git/ops

Ещё 35 навыков покрывают: систематическую отладку, OWASP-ревью, валидацию входных данных, поиск секретов, дизайн-системы, accessibility, нагрузочные и краевые состояния, TDD, поиск flaky-тестов, coverage gaps, удаление мёртвого кода, упрощение, читаемые коммиты, PR-ревью, revert без потерь, SQL-ревью, миграции и многое другое.

review — закрывающий трек

• adversarial-verify — 11 шорткатов, которыми агенты выдают «done»
• verification-before-completion — запусти команду, прочитай вывод, потом утверждай

Установка — 30 секунд

# Бросить харнес в проект (пропускает существующие файлы)
curl -fsSL https://raw.githubusercontent.com/Archive228/loopkit/main/install.sh | bash

# Открыть Claude Code / Cursor / Codex в той же директории
claude

# Написать однострочную спецификацию, запустить цикл
echo "STATUS: not-started" > IMPLEMENTATION_PLAN.md
./run.sh

Флаги: FORCE=1 перезаписывает файлы, BACKUP=1 делает снепшот .claude/ перед записью, DEST=/path для установки в конкретную директорию.

Для одного навыка:

npx -p claude-loopkit loopkit-add adversarial-verify

Сравнение с другими skill pack'ами

Позиционирование

LoopKit осознанно не является методологией. Подходы вроде BMAD, Spec-Kit и full lifecycle skill packs пытаются помочь, владея процессом — но они забирают контроль, который делает агентов полезными в вашей кодовой базе. LoopKit даёт мини-навыки и пол, на котором можно стоять. Всё остальное — ваша форма.

Две причины провала долгоиграющих агентов (делать слишком много за раз; преждевременная победа) — структурные, а не skill-образные. run.sh + verifier subagent — структурный ответ. Навыки лишь делают каждый ход дешевле.

Свежий трек loop & harness (planner-spec-expand, sprint-contract, evaluator-calibration, harness-stripping) операционализирует многозаходную дисциплину, расписанную в сопутствующей статье автора «Loop and Harness engineering».

Slash-команды

Три команды в .claude/commands/:

• /spec — пишет PROMPT.md и IMPLEMENTATION_PLAN.md до касания кода
• /verify — adversarial проверка диффа по 11-пунктовому чеклисту
• /polish — батч-проход по качеству: simplify → reduce-nesting → kill-dead-code → a11y → loading states → readme audit

Итог

LoopKit — это готовый к использованию сетап агента, который за 30 секунд превращает сырой проект в управляемый цикл Plan → Act → Verify. 49 навыков загружаются только когда нужны, верификатор ловит фальшивый «done», а MIT лицензия позволяет форкать и адаптировать под себя. Если вы устали от того, что агенты делают слишком много за раз или объявляют победу раньше времени — LoopKit даёт структурное решение, а не очередную методологию для изучения.