# bootstrap-agent-config

Скилл обходит проект, находит стек и команды сборки, а потом пишет CLAUDE.md и AGENTS.md с правилами, взятыми из кода.

- скилл · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode · ★ 21
- Автор: dshakes
- Лицензия: MIT · policy=mirror · начало файла — в конце страницы
- Исходник: https://github.com/dshakes/compass/tree/HEAD/claude/skills/bootstrap-agent-config/SKILL.md
- Обновлён: 2026-10-19
- HTML: https://affpapa.org/nevibecode/skills/bootstrap-agent-config

## Что делает

Сначала скилл запускает вспомогательный скрипт `detect-stack.sh`, который собирает инвентарь: языки, пакетные менеджеры, команды сборки, тестов и линтера, раскладку монорепозитория, наличие ADR и CI. Полученному он не верит на слово — открывает `Makefile`, `package.json` или `justfile` и пару исходников, чтобы проверить команды и подсмотреть настоящие соглашения: обработку ошибок, стиль тестов, именование.

Дальше самое ценное. Скилл ищет инварианты — правила, нарушение которых приводит к инцидентам: границы тенантов, доверенные зоны, сгенерированные файлы, которые нельзя править руками. Источники — ADR, `ARCHITECTURE.md`, `SECURITY.md`, разделы README про подводные камни. Если архитектура непонятна, скилл спрашивает.

\`CLAUDE.md` собирается по скелету из шаблона и заполняется только проверенным. `AGENTS.md` получается симлинком на `CLAUDE.md`, чтобы была одна версия правды; исключение — если в репозитории уже есть свой расходящийся `AGENTS.md`. В конце скилл перечисляет записанные файлы и три главных инварианта, чтобы вы поправили догадки. Догадку он помечает `(verify)` — без проверки человеком такой пункт в конфиг не идёт. Нужен `bash` и доступ к репозиторию.

## Установка

### Claude Code (родная платформа)

1. **Через Skills CLI (Vercel)**
```bash
npx skills add dshakes/compass --skill bootstrap-agent-config -a claude-code
```

2. **Вручную: положить файлы**
- Файл: `~/.claude/skills/bootstrap-agent-config/SKILL.md` — Папка скилла целиком; для одного проекта — .claude/skills/bootstrap-agent-config/

### Codex

1. **Через Skills CLI (Vercel)**
```bash
npx skills add dshakes/compass --skill bootstrap-agent-config -a codex
```

2. **Вручную: положить файлы**
- Файл: `.agents/skills/bootstrap-agent-config/SKILL.md` — Для всех проектов — ~/.agents/skills/

### Cursor

1. **Через Skills CLI (Vercel)**
```bash
npx skills add dshakes/compass --skill bootstrap-agent-config -a cursor
```

2. **Вручную: положить файлы**
- Файл: `.cursor/skills/bootstrap-agent-config/SKILL.md` — Cursor читает и .agents/skills/, и .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install dshakes/compass bootstrap-agent-config
```

2. **Вручную: положить файлы**
- Файл: `.github/skills/bootstrap-agent-config/SKILL.md`

### Gemini CLI

1. **Через Skills CLI (Vercel)**
```bash
npx skills add dshakes/compass --skill bootstrap-agent-config -a gemini-cli
```

2. **Командой платформы**
```bash
gemini skills install https://github.com/dshakes/compass --path claude/skills/bootstrap-agent-config
```

### Windsurf (Devin Desktop)

**Вручную: положить файлы**
- Файл: `.devin/skills/bootstrap-agent-config/SKILL.md` — Старый путь .windsurf/skills/ тоже читается

### OpenCode

**Через Skills CLI (Vercel)**
```bash
npx skills add dshakes/compass --skill bootstrap-agent-config -a opencode
```

### Claude.ai

**Claude.ai**
- Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills

Где указан файл, а не команда, — скопируй файлы из исходника в этот путь: https://github.com/dshakes/compass/tree/HEAD/claude/skills/bootstrap-agent-config/SKILL.md

## Когда брать
- написать стартовый `CLAUDE.md` для проекта без конфига агента
- вытащить из репозитория точные команды сборки и тестов
- собрать список правил, нарушение которых ломает прод
- свести `CLAUDE.md` и `AGENTS.md` к одному источнику правды
- подключить новый проект к Codex и другим агентам, читающим `AGENTS.md`

## Примеры запросов агенту
- Разбери репозиторий и подготовь для него конфиг агента.
- Прогони инициализацию конфига по каталогу пакета `./services/auth`.
- Напиши `CLAUDE.md` для этого проекта и сделай `AGENTS.md` ссылкой на него.

## Похожие
- [setup-matt-pocock-skills](https://affpapa.org/nevibecode/skills/setup-matt-pocock-skills.md) — скилл · 1052851 установка
- [ask-matt](https://affpapa.org/nevibecode/skills/ask-matt.md) — скилл · 766587 установок
- [to-tickets](https://affpapa.org/nevibecode/skills/to-tickets.md) — скилл · 711230 установок
- [writing-plans](https://affpapa.org/nevibecode/skills/writing-plans.md) — скилл · 282859 установок
- [caveman-review](https://affpapa.org/nevibecode/skills/caveman-review.md) — скилл · 411800 установок
- [caveman-compress](https://affpapa.org/nevibecode/skills/caveman-compress.md) — скилл · 411500 установок

Из того же набора: [dshakes/compass](https://affpapa.org/nevibecode/by/dshakes/compass.md) — 8 карточек

_Часть страницы не вошла по размеру — она есть в HTML-версии._

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md