autogap
micpet7514088/autogapClaude Code скилл для диагностики любых проектов: код, документация, стратегия, контент. Классифицирует тип проекта по сигналам файлов, определяет ключевую цель и выявляет 3 главных блокера с планом устранения.
Установка
git clone https://github.com/micpet7514088/autogap.gitREADME
autogap
Первый Claude Code скилл, который диагностирует топ-3 узких места в любом проекте — не только в коде.
Укажите autogap директорию проекта. Скилл классифицирует тип проекта по сигналам файлов (без предположений), определяет ключевую цель, к которой стремится проект, и сообщает о 3 главных пробелах, блокирующих эту цель, плюс 3 макро-шага для их устранения. Затем выводит нумерованное меню и ждёт. Если вы выбираете пункт — планирует и выполняет автономно.
Работает с:
- исходным кодом — отдельный пакет или монорепозиторий
- наборами документации — исследовательские заметки, папки со спецификациями, базы знаний
- стратегией / бизнесом — дорожные карты, OKR, презентации, брифы
- творческим / контентным материалом — черновики, планы, списки правок
- ops / infra — runbook-и, playbook-и, инвентари
- гибридными проектами — чем бы ваш проект ни был
Большинство агентских скиллов рассчитаны на программный код. autogap — нет.
Пример за 30 секунд
$ cd research-project/
$ claude
> /autogap
# Project Objective Hypothesis
- Publish a peer-reviewed paper on X by Q3 2026
- Project type: research
- Confidence: High
- Signals: 3 draft sections, referee feedback letter, 47-entry BibTeX,
methods/ folder with 2 Jupyter notebooks, reproducibility/ empty
# Top 3 Gaps
## Gap 1 — Methods section incomplete
Why it matters: editors reject without reproducible methodology.
Evidence: methods.md is 40% length of Background + has 3 TODO markers.
Consequence: guaranteed R&R loop, likely 3-month delay.
## Gap 2 — No reproducibility kit
Why it matters: target journal requires data + code on acceptance.
Evidence: reproducibility/ directory empty; notebooks have no seeds.
Consequence: acceptance delayed until kit is produced.
## Gap 3 — Discussion skirts disconfirmation
Why it matters: weakest reviewer target; editor likely flags.
Evidence: 0 mentions of limitations; no alternative-explanation section.
Consequence: weakest part of the paper, most reviewer ammunition.
# 3 Macro-Steps
## Macro-Step 1 — Complete methods from lab notes (Low / High / High)
## Macro-Step 2 — Produce reproducibility kit (Medium / High / Medium)
## Macro-Step 3 — Add disconfirmation to discussion (Low / Medium / High)
Choose what to implement:
1. Macro-Step 1 only
2. Macro-Step 2 only
3. Macro-Step 3 only
4. Macro-Steps 1 + 2
...
Выберите номер. autogap планирует, выполняет, проверяет и сообщает, что именно изменилось.
Без подтверждения пользователя на каждом шаге. Без имитации завершения. Останавливается корректно при неоднозначных необратимых действиях.
Чем отличается
| Большинство скиллов | autogap |
|---|---|
| Предполагают, что проект — это код | Классифицирует тип проекта по сигналам файлов |
| Предлагают длинный список улучшений | Ранжирует ровно 3 пробела по силе блокировки |
| Читают лекции о лучших практиках | Определяет, чем проект стремится стать |
| Задают 20 вопросов заранее | Сначала глубоко инспектирует, задаёт ≤2 вопроса только при блокировке |
| Выполняют всё или ничего | Пользователь выбирает подмножество через меню, затем автономное выполнение |
| Молчат о неопределённости | Уверенность + сильнейшая альтернативная гипотеза, явно |
Полное обоснование в docs/design-rationale.md.
Установка
Метод 1 — Скилл на уровне пользователя (рекомендуется):
git clone https://github.com/micpet7514088/autogap.git ~/autogap
mkdir -p ~/.claude/skills/autogap
ln -s ~/autogap/skills/autogap/SKILL.md ~/.claude/skills/autogap/SKILL.mdПерезапустите Claude Code. Из любой директории проекта: claude → /autogap.
Метод 2 — Скилл на уровне проекта:
mkdir -p .claude/skills/autogap
curl -sSL https://raw.githubusercontent.com/micpet7514088/autogap/main/skills/autogap/SKILL.md \
-o .claude/skills/autogap/SKILL.mdМетод 3 — Вручную:
Скопируйте skills/autogap/SKILL.md в любую директорию, которую Claude Code сканирует на наличие скиллов.
Примеры для запуска
Три демо-проекта, по одному на каждый основной тип. У каждого есть файл с ожидаемым выводом для сравнения с тем, что производит autogap.
examples/demo-01-code/— Python CLI, заблокированный на релизе в PyPI → ожидаемый выводexamples/demo-02-docs/— статья для CIKM 2026, 50 дней до дедлайна → ожидаемый выводexamples/demo-03-strategy/— запуск продукта в Q3 с контингентом топ-3 LOI → ожидаемый вывод
См. examples/ для полного набора и инструкций по запуску.
Кейсы
Реальные диагнозы на реальных проектах. Часть анонимизирована; один — полностью публичный разбор.
- Аудит доступности двух продакшн-сайтов — с 88/95 до 100/100 за один день Диагностика, исправление, деплой, сертификация. Включает реальный инцидент дрейфа и восстановление. Полностью публичный, реальные SHA коммитов.
- Аудит реагирования на инциденты NIS2 для европейского страховщика Независимый аудит, 3 параллельных потока работ, ошибка DR failover выявлена на tabletop-учениях. Анонимизировано.
- Дообучение AI-коуча для медицинской вертикали — удержание +17% Исправление вариативности ответов, семантики и бага задержки внутри сессии. Анонимизировано.
См. docs/case-studies/ для полного набора.
Как это работает, кратко
- Классификация типа проекта по сигналам файлов (дерево папок, типы файлов, именование, метаданные). Без программного дефолта.
- Определение ключевой цели, к которой стремится проект. Указывается уверенность, называется сильнейшая альтернативная гипотеза.
- Сканирование в ширину. Углубление на наиболее информативных путях. Выборка ≥1 артефакта на каждое отдельное семейство (код / документы / конфиг / медиа). Проход дисконфирмации перед завершением.
- Ранжирование пробелов по силе блокировки, а не по косметическим улучшениям. «Было бы неплохо» — не пробел.
- Представление меню из 3 пробелов / 3 макро-шагов. Остановка. Без авто-выполнения.
- При выборе: плотное планирование, автономное выполнение, пропорциональная верификация, отчёт о том, что изменилось.