AGENTS.md — Глобальная конфигурация агента

Автор: @smartcaveman1 | AUTHOR.md | MIT License

Что это

AGENTS.md — файл с правилами поведения AI-агента (Claude, Qwen, Codex, Cursor и др.). Агент читает его при запуске и действует по заданным правилам из коробки.

Зачем:

• Настроить агентскую среду для всех IDE/CLI в пару нажатий — один AGENTS.md работает везде: Qwen, Claude, Cursor, Codex, Windsurf, VS Code, любой терминал
• Экономить токены — Caveman mode режет расход ~75%, агентский кеш-чек конфигов не перечитывает одно и то же, vendor-игнор исключает сканирование node_modules и dist
• Строить собственную систему накопления опыта — агент учится через ваши диалоги и сессии: рабочие скиллы сохраняются в .myskills/skills/, заметки в .notes/, с каждым сеансом база растёт
• Устанавливать сторонние скиллы — каталоги (skills.sh, GitHub, awesome-agent-skills), чужие паттерны, дизайн-системы, UI-компоненты — всё ложится в .agents/skills/ и работает глобально

Где разместить

Правильное расположение:

$HOME/AGENTS.md              # Глобально для всех проектов

Или на уровень ниже от CLI/IDE:

/path/to/cli/AGENTS.md       # Рядом с установленной CLI
/path/to/ide/AGENTS.md       # Рядом с IDE

Важно:

• Кладите файл на один уровень вложенности, не глубже
• Агент должен найти его при сканировании HOME или директории CLI/IDE
• Это позволяет агенту действовать по правилам независимо от IDE/CLI

Структура репозитория

.agents/skills/ — единый источник всех скиллов

.agents/skills/
├── caveman/                    # Сжатая коммуникация (~75% экономия токенов)
│   └── SKILL.md
├── explain-complex-code/       # Объяснение кода (ELI5 → Feynman → Gradual)
│   ├── SKILL.md
│   └── prompts/
│       ├── eli5.md
│       ├── feynman.md
│       └── gradual.md
├── subagent-creator-universal/ # Создание агентов для 6 CLI/IDE
│   └── SKILL.md
├── meta/orchestration/         # Мета-оркестрация субагентов
│   ├── spawn/                  #   кого, когда и сколько запускать
│   ├── synthesis/              #   как собирать результаты без дублей
│   ├── recovery/               #   что делать когда агент упал
│   └── multi-session-worker/   #   tmux-воркеры, IPC через файлы
└── .template/                  # Шаблон нового скилла

.agents/ExampleSubagents/ — примеры субагентов (вдохновение)

.agents/ExampleSubagents/
├── code-reviewer.md
├── debugger.md
├── security-auditor.md
├── test-architect.md
├── playwright-e2e-auditor.md
├── refactor-architect.md
├── docs-writer.md
├── git-doctor.md
├── dependency-manager.md
├── agent-organizer.md
├── onboarding-scout.md
├── release-manager.md
└── meta/                       # Мета-агенты примеры
    ├── agent-organizer.md
    ├── onboarding-scout.md
    └── release-manager.md

Структура после установки

$HOME/
├── AGENTS.md                   # Главные правила поведения агента
├── .agents/
│   ├── skills/                 # Глобальные агентские скиллы
│   │   ├── caveman/
│   │   ├── explain-complex-code/
│   │   ├── subagent-creator-universal/
│   │   └── meta/orchestration/
│   └── ExampleSubagents/       # Примеры субагентов (вдохновение)
├── .myskills/
│   └── skills/                 # Пользовательские скиллы (свои)
├── .notes/
│   └── INBOX/                  # Глобальные входящие — агент разбирает автоматически
└── .mynotes/
    └── INBOX/                  # Локальные заметки проекта (аналог .notes/)

Project Notes — .mynotes/ локального проекта

При работе над проектом создаётся локальная директория .mynotes/ — полный аналог глобальных .notes/ с той же структурой и функционалом.

.mynotes/
├── topic1.md                   # Тематическая заметка проекта
├── topic2.md
└── INBOX/                      # Входящие проекта — разбираются так же автоматически

Правила:

• Та же INBOX-логика: файлы из .mynotes/INBOX/ читаются → разносятся на тематические .md → оригиналы удаляются
• Если использовал контекст/заметку из глобальных .notes/ при работе над проектом — копируй соответствующий .md файл в .mynotes/ проекта для памяти между сессиями
• Заметки в .mynotes/ сохраняются в репозитории проекта — контекст не теряется при переключении между проектами

Двухуровневая система скиллов

Глобальные скиллы (терминология)

User Skills — .myskills/skills/ (пользовательские/рабочие)

Зачем отдельная директория?

.myskills/skills/ — это рабочая база ваших личных скиллов. Сюда агент создаёт скиллы, когда вы просите: «зафиксируй в глобальные мои скиллы», «сохрани как скилл», «добавь в мои скиллы».

Почему не устанавливать внешние скиллы сюда:

Агент НЕ скачивает и НЕ устанавливает скиллы с GitHub, https://skills.sh/ и других источников в .myskills/skills/. Эта директория — только для ваших собственных скиллов.

Зачем такое разделение:

Копирование в проект: рабочие скиллы из .myskills/skills/ могут быть скопированы в .skills/ локального репозитория проекта, если они используются в этом проекте.

Как ИИ работает с двумя директориями

Агент знает оба пути и использует их:

• Если скажете «используй глобальные скиллы» — посмотрит обе папки (.agents/skills/ и .myskills/skills/), найдёт подходящие под задачу
• Если скажете «используй глобальные агентские» — возьмёт только .agents/skills/
• Если скажете «используй мои скиллы» — возьмёт .myskills/skills/
• Сам ищет скиллы при наличии триггеров в скриптах и задачах

Таким образом, агент работает с двумя глобальными директориями одновременно — и внешними скачанными, и вашими пользовательскими. Вы можете управлять каждой отдельно.

Project Skills — .skills/ локального проекта

При работе над проектом — используемые скиллы копировать из глобальных агентских .agents/skills/ и глобальных пользовательских .myskills/skills/ в локальный .skills/ репозитория проекта.

.skills/
├── e2e-testing-expert/
├── gh-accelint-react-best-practices/
├── shadcn-ui/
├── taste-design/
├── ui-animation/
├── ui-ux-pro-max/
└── SKILLS.md

Правила:

• Копировать только те скиллы, которые реально используются в проекте
• Создать .skills/SKILLS.md с описанием каждого скопированного скилла
• Не дублировать — если скилл уже в .skills/, не копировать повторно
• Глобальные скиллы в .agents/skills/ и .myskills/skills/ остаются неизменными

Pre-Action Check (конфигурация и секреты)

Триггеры проверки

Агент проверяет конфиги ТОЛЬКО при:

НЕ проверяет при: чтение файлов, ls, ответы на вопросы, навигация по коду, рефакторинг без запуска, объяснение кода.

Кеширование

Агент кеширует прочитанные конфиги на время текущей задачи. Перечитывает только если:

• Файл изменился (git status, watch, явное редактирование)
• Началась новая независимая задача
• Прошёл рестарт/перезапуск процесса

Это экономит контекст и предотвращает повторное чтение одних и тех же файлов 5–10 раз за сессию.

Игнор vendor-директорий

Агент НИКОГДА не читает, не сканирует, не индексирует:

• node_modules/, vendor/, vendor/bundle/
• .git/, .svn/, .hg/
• __pycache__/, .pytest_cache/, *.pyc
• dist/, build/, out/, .next/, .nuxt/
• target/, bin/, obj/
• .cache/, .parcel-cache/, .vite/
• venv/, .venv/, env/ (содержимое виртуальных окружений)
• Lock-файлы — только при конфликтах зависимостей

Конфигураций там не будет, а директории огромные.

Защита секретов

Никогда не коммить .env и секреты. Агент всегда сверяется с .gitignore и проверяет наличие конфигурационных файлов (.env, .env.*, .credentials) перед коммитом.

Перед коммитом: git status + проверка staged файлов — никаких .env, .credentials, .secret в staged, никаких секретов в диффе (git diff --cached).

Зачем это нужно

Эти правила:

• Подготавливают код к продакшену — агент не хардкодит секреты, выносит в конфиги
• Помогают ИИ не тупить — особенно если это тестовые и дешёвые модели
• Защищают от утечек данных — базовые вещи, но ИИ их может забыть или ошибиться
• Лучший канон для продакшена — особенно если вы любите экспериментировать и делите проект между дешёвыми нейросетями

Как это работает

1. Агент читает AGENTS.md

При запуске в любой IDE/CLI агент находит AGENTS.md в $HOME и применяет правила:

• Caveman mode — сжатая коммуникация (экономия ~75% токенов)
• Skills system — скиллы в .agents/skills/ и .myskills/skills/
• Notes system — заметки в .notes/ (глобальные) и .mynotes/ (локальные проекта)
• Project Skills — копирование используемых скиллов в .skills/ проекта
• Pre-Action Check — проверка конфигов перед деплоем, запуском, коммитом

2. Создание пользовательских скиллов

Когда вы говорите агенту:

"Создай глобальные скиллы о том что мы сделали, научились и так далее"

Агент создаёт в .myskills/skills/:

.myskills/skills/new-skill-name/
├── SKILL.md          # Описание, триггеры, правила
└── prompts/          # (опционально) промпты для разных сценариев

Скилл становится доступен во всех проектах глобально.

3. Заметки в .notes/ и .mynotes/

Глобальные заметки — .notes/:

Когда вы говорите:

"Просто создай заметку о том что мы нашли, анализировали и сравнивали"

Агент создаёт файл в .notes/:

.notes/filename.md

INBOX обработка:

• Киньте любой .md файл в .notes/INBOX/
• Агент автоматически:
  1. Прочитает все файлы
  2. Разнесёт содержимое на тематические .md файлы в .notes/
  3. Удалит оригиналы из INBOX/
• Один файл INBOX может стать несколькими тематическими заметками
• В INBOX/ не должно оставаться файлов

Это удобно для:

• Контекста из недописанных уроков
• Интересных находок, которые нужно структурировать
• Быстрых заметок "на потом"

Локальные заметки проекта — .mynotes/:

Полный аналог .notes/ но внутри проекта. Та же структура, та же INBOX-логика.

Копирование контекста: когда агент использует заметку из глобальных .notes/ для работы над проектом — он копирует этот .md файл в .mynotes/ проекта. Так контекст сохраняется между сессиями и не теряется при переключении проектов.

4. Объяснение кода (explain-complex-code)

Когда вы просите:

"Объясни", "Разбери", "Что тут", "ELI5", "Как работает"

Агент использует скилл .agents/skills/explain-complex-code/ как временный инструмент на 1 объяснение:

Скилл действует только на текущий запрос — не запоминается для будущих ответов.

Система субагентов и оркестрации

Прокаченная версия AGENTS.md включает полную систему субагентов — от спавна внутри одной сессии до распределённых воркеров в отдельных терминалах.

Режимы работы

In-Session Subagents (спавн внутри сессии)

ИИ автономно нанимает на работу — создаёт субагентов для нужного CLI/IDE, задаёт им права и обязательства, контролирует внутри одной сессии. Максимум 4 параллельных субагента. Read-only агенты запускаются первыми.

Триггеры:

• «хочу сабагентов»
• «заспавни сабагентов для выполнения»
• «параллельное выполнение сабагентами»
• «хочу работников / воркеров / сабагентов»
• «запусти агентов параллельно»

При отказе пользователя («не хочу сабагентов», «работай в соло», «без воркеров») — ИИ полностью отключает режим субагентов и не спавнит, не создаёт, не редактирует файлы агентов до тех пор, пока пользователь явно не попросит обратно.

Multi-Session Workers (отдельные терминалы)

Для тяжёлых задач требующих изоляции — ИИ спавнит отдельные терминалы через tmux (6-8 параллельно). Каждый воркер = независимый CLI-процесс со своим контекстом. Протокол общения через файлы (.workers/tasks/ → .workers/results/).

Важно: Multi-session workers требует настройки окружения (tmux, CLI в PATH, директории). Это выходит за рамки репозитория базового максимума — в репозитории только правила и мета-скилл. Код и настройка — за вами.

Триггеры:

• «запусти воркеров через tmux»
• «multi-session mode»
• «запусти отдельных работников»
• «нужно больше 4 параллельных задач»

Оркестрация

Для корректной работы субагентов и мульти-агентов в репозитории предусмотрены готовые мета-скиллы:

.agents/skills/meta/orchestration/
├── spawn/              ← кого, когда и сколько запускать
├── synthesis/          ← как собирать результаты без дублей
├── recovery/           ← что делать когда агент упал
└── multi-session-worker/ ← tmux-воркеры, IPC через файлы

Главный скилл создания агентов: .agents/skills/subagent-creator-universal/ — даёт правильную структуру для Qwen Code, Codex, Claude Code, Factory (Droid), OpenCode.

Примеры субагентов (не активные)

В .agents/ExampleSubagents/ и .agents/ExampleSubagents/meta/ лежат безформенные примеры субагентов и мета-скиллов — это только вдохновение и референс. ИИ не копирует их напрямую, а использует subagent-creator-universal для создания агентов с правильной структурой под конкретный CLI/IDE.

Правило языка

ИИ всегда отвечает на языке пользователя. Запрос на русском = ответ на русском. Технические термины (severity, CRITICAL, file:line) можно на английском, но связки, выводы, описания — на языке пользователя. Это правило действует всегда, включая ответы после спавна субагентов и синтеза результатов.

MCP / API / CLI инструменты

ИИ имеет право использовать MCP-серверы, внешние API и CLI-утилиты по умолчанию. Если какой-то режим явно не запрещён — инструменты доступны.

Надёжные источники для MCP-серверов:

• mcp.so — крупнейший каталог
• Smithery — установка одной командой
• GitHub — поиск по репозиториям
• modelcontextprotocol.io — официальная документация

Автоматизация знаний: CLI / MCP / API

Правило «Думай как умно сделать»

Перед каждым действием ИИ обязан задать себе вопросы:

• «Как умно сделать? Можно ли автоматизировать?»
• «Есть ли лучший способ? MCP вместо CLI? Скилл вместо ручного?»
• «Как сделать чтобы следующий раз было быстрее? Создать скилл/заметку?»
• «Можно ли переиспользовать уже готовое?»

Алгоритм при работе с CLI/MCP/API

1. Поиск до выполнения — проверить .myskills/skills/, .agents/skills/, .notes/, mcp.so, skills.sh, документацию
2. Применение найденного — следовать правилам скилла, использовать MCP, применить заметку
3. Создание после успеха — если решение может повториться: создать скилл (.myskills/skills/) или заметку (.notes/)

Цикл улучшения

Задача → Поиск скиллов/доков/MCP → Применение → Успех?
                                                    ↓ да
                                         Создать/обновить скилл или заметку
                                                    ↓
                                         Скопировать в проект если релевантно
                                                    ↓
                                         Следующий раз найдёт сразу

Триггеры автосоздания скиллов

Источники скиллов и компонентов

Agent Skills

• skills.sh — каталог скиллов по технологиям
• VoltAgent/awesome-agent-skills — 1060+ скиллов
• GitHub — поиск по agent-skills, claude-skills, codex-skills

MCP-серверы

• mcp.so — самый большой каталог
• Smithery — установка одной командой
• ToolHive — продакшен: изоляция, секреты, политики
• Awesome-MCP-Servers — 30+ категорий

Дизайн и фронтенд

• 21st.dev — React-компоненты с демо
• shadcn/ui — доступные компоненты
• v0.dev — AI-генерация UI
• ui.aceternity.com — трендовые анимации
• motion-primitives.com — анимированные паттерны
• hyperui.dev — free Tailwind

Философия

AGENTS.md настроен чтобы агент с коробки нативно думал как автор — со стандартными и улучшенными подходами.

Что получает агент:

• Стиль коммуникации (caveman mode — экономия токенов)
• Систему скиллов (повторно используемые паттерны, двухуровневая система)
• Систему заметок (контекст, анализ, находки)
• Правила безопасности (Pre-Action Check — конфиги, секреты, vendor-ignore)
• Источники для поиска (скиллы, UI-компоненты, дизайн-паттерны)

Что получает пользователь:

• Агент действует одинаково в любой IDE/CLI
• Глобальные скиллы работают во всех проектах
• Разделение на внешние/скачанные и собственные/рабочие скиллы
• Глобальные заметки сохраняются между сессиями (.notes/)
• Локальные заметки проекта (.mynotes/) — контекст не теряется при переключении проектов
• INBOX автоматически разбирает сырой контекст (и глобальный, и проектный)
• Объяснения кода на разных уровнях сложности
• Защита от утечек секретов и хардкода

Быстрый старт

Автоматическая установка (1 клик)

Просто скажите агенту:

«Установи из репозитория kissrosecicd-hub/agents-evolution используя существующие там скрипты»

Агент сам запустит нужный скрипт и настроит всё.

Или вручную:

Linux/macOS:

curl -fsSL https://raw.githubusercontent.com/kissrosecicd-hub/agents-evolution/main/install.sh | bash

Windows (PowerShell):

irm https://raw.githubusercontent.com/kissrosecicd-hub/agents-evolution/main/install.ps1 | iex

Ручная установка

1. Скопируйте AGENTS.md в $HOME/
2. Создайте .agents/skills/, .myskills/skills/ и .notes/
3. Запустите агент — он подхватит правила автоматически

cp AGENTS.md $HOME/
mkdir -p ~/.agents/skills
mkdir -p ~/.myskills/skills
mkdir -p ~/.notes/INBOX

Версии AGENTS.md

Если нужна базовая версия без субагентов и оркестрации — используйте содержимое AGENTS-base.md как ваш AGENTS.md.

Готовые скиллы

В репозитории все скиллы находятся в .agents/skills/ — единый источник:

Ядро системы

Мета-оркестрация

Безопасность (Trail of Bits + другие)

Утилиты и инструменты

Скиллов в репозитории может быть больше — и все они ставятся через установщики. Здесь лучшее из лучшего: спец-режимы для мульти-агентов и сабагентов, без жёсткой привязки к одной IDE, без сложных программных средств и зависимостей. Просто скопировал — и работает. Можете ознакомиться после установки. Лучшее для лучших!

Рекомендации по моделям

Совет: китайские модели (Qwen, DeepSeek, GLM) — протестировано, думают и выполняют код лучше и быстрее.

Caveman mode изначально создавался для Claude — можете попробовать, тоже отлично работает.

Скилл explain-complex-code — создан автором этого репозитория совместно с нейросетью через анализ открытых репозиториев. Нашёл лучшие паттерны объяснения кода и собрал в мощный универсальный скилл с тремя режимами (ELI5, Feynman, Gradual). Объяснения получаются на уровне Sonnet/Opus моделей Claude — когда вы просите объяснить, качество будет топовым.

Благодарности

Оригинальный скилл caveman mode создал JuliusBrussee — ему спасибо! 🙏

Эволюция версий

Чёткое разделение Notes vs Skills:

Раньше граница была размыта — ИИ мог создать «скилл» из обычной документации. Теперь:

Зачем:

• Пользователь понимает что просить: документацию → notes, автоматизацию паттерна → skills
• ИИ не создаёт «тупые скиллы» — описание API методов telethon это notes, а вот «как я обычно вступаю в группы» — skill
• Экономия токенов — ИИ не сканирует notes автоматически, читает только когда контекст задачи релевантен
• Библиотек много, паттернов мало — не нужно делать скилл на каждый метод каждой библиотеки

Исправление директорий создания скиллов:

Добавлено жёсткое правило в Pre-Action Check и User Skills:

Алгоритм выбора директории:
1. Пользователь просит создать/сохранить скилл → `.myskills/skills/`
2. Скачиваю готовый скилл из интернета → `.agents/skills/`
3. Скилл используется в проекте → копирую в `.skills/` проекта

КРИТИЧНО: «создай скилл», «запомни паттерн», «сделай скилл для X» → ВСЕГДА .myskills/skills/. НИКОГДА не .agents/skills/ для пользовательских скиллов.

Зачем: .agents/skills/ = только внешние/скачанные. .myskills/skills/ = собственные. ИИ больше не путает директории.

Результаты тестирования

Глубокое и первоначальное тестирование Caveman-скилла: JuliusBrussee/caveman

Ниже — мои результаты тестирования с AGENTS.md архитектурой.

Тест: без AGENTS.md (before)

Что наблюдалось:

• ❌ Модель сразу писала код, ошибалась с первого раза
• ❌ Не создавала план — действовала импровизированно
• ❌ Работала из датасета — шаблонные решения
• ❌ Качество кода — среднее
• ❌ Скорость — на 50% медленнее
• ❌ Больше текста в процессе, но без пользы
• ❌ Объяснения — сухая арифметика и архитектурность, без глубины

Скриншоты:

#	Скриншот
1
2
3
4
5

Тест: с AGENTS.md (after)

Что изменилось:

• ✅ Сразу был план — модель структурирует подход
• ✅ Спросила как именно я хочу — уточнение требований
• ✅ Помогла дойти до конкретики — постепенное углубление
• ✅ Написание молниеносное — код генерируется быстро и точно
• ✅ Объяснения через скилл — разные уровни (ELI5, Feynman, Gradual)
• ✅ Обучиться пониманию системы стало легче
• ✅ В боевом режиме объясняет ещё лучше (показан быстрый тест)

Скриншоты:

#	Скриншот
1
2
3
4
5
6
7

Выводы

Как использовать: правильно разместите AGENTS.md как описано в разделе Где разместить — и модель сразу следует правилам. Можно попросить «следуй AGENTS.md» или просто открыть новый чат — она уже подхватит конфигурацию.

Context Retention — защита от потери инструкций

В длинных сессиях контекст может «выпадать». AGENTS.md включает механизмы самопроверки:

Периодическая самопроверка

Агент периодически отчитывается что помнит ключевые инструкции:

• Pre-Action Check — перед деплоем, запуском сервера, коммитом, изменением окружения, взаимодействием с внешними сервисами. Агент проверяет конфиги, .env, .gitignore, отсутствие секретов в staged
• Boundaries — проверка границ: не сканировать node_modules/, vendor/, .git/, dist/; не коммить секреты; использовать reduce вместо Math.max(...arr)

Точечное чтение при жалобах

По запросу пользователя — если вы сообщаете о проблеме, агент не перечитывает весь AGENTS.md, а сразу обращается к нужной секции:

• Жалоба на секреты → Pre-Action Check + .gitignore
• Жалоба на производительность → Производительность + accelint-ts-performance
• Жалоба на тесты → Тестирование + accelint-ts-testing

Это экономит токены — не тратится время на полную перечитку.

Если агент теряет инструкции

Просто скажите: «Перечитай AGENTS.md и подтверди». Агент перечитает файл и подтвердит что помнит правила. Это зависит от конкретной модели ИИ — дешёвые модели быстрее «забывают», дорогие держат контекст дольше, но система страхует в любом случае.

Скиллы усиливают контекст

Помимо AGENTS.md, контекст дополняется скиллами:

• Профессиональные скиллы (.agents/skills/) — имеют свои триггеры, автоматически активируются по ключевым словам
• Пользовательские скиллы (.myskills/skills/) — ваши собственные паттерны, накопленные через сессии
• Проектные скиллы (.skills/) — копии используемых скиллов, доступные в контексте проекта

Каждый скилл содержит SKILL.md с описанием, триггерами активации и правилами. Агент автоматически сканирует доступные скиллы и применяет релевантные.

Boundaries — границы поведения

Правило языка

ИИ всегда отвечает на языке пользователя. Запрос на русском = ответ на русском. Технические термины (severity, CRITICAL, file:line, CLI названия) можно на английском, но связки, выводы, описания, рекомендации — на языке пользователя.

Критические границы

• Никогда не коммить .env и секреты — см. Pre-Action Check
• AGENTS.md = главный источник правил проекта — при конфликте с другими инструкциями AGENTS.md побеждает
• Не сканировать vendor-директории — node_modules/, vendor/, dist/, .git/ и другие (полный список в Pre-Action Check)

Создание ссылки на главный AGENTS.md в рабочей директории

Когда: Начало работы в новой директории (проект, папка, репозиторий).

Алгоритм:

1. Проверь: есть ли AGENTS.md или .cursorrules или CLAUDE.md или QWEN.md в текущей папке?
2. Если нет → создай AGENTS.md с мини-шаблоном
3. Если есть другой формат правил → добавь ссылку туда же

Мини-шаблон AGENTS.md:

# Project Rules

Главный файл правил:
- Linux/macOS: `~/AGENTS.md`
- Windows: `%USERPROFILE%\AGENTS.md`

Критические правила:
1. НЕ КОММИТЬ СЕКРЕТЫ — проверяй `.gitignore` перед коммитом
2. ДУМАЙ КАК УМНО СДЕЛАТЬ — автоматизируй, ищи скиллы/доки/MCP
3. ИЩИ СКИЛЛЫ/ДОКИ перед CLI/MCP/API
4. AGENTS.md = главный источник правил

Полный файл: см. `~/AGENTS.md` (или `%USERPROFILE%\AGENTS.md` на Windows)

Почему это работает:

• Любой CLI/IDE загружает AGENTS.md из рабочей директории
• Мини-файл ~50 слов (~375 токенов) — дёшево, всегда в контексте
• Ссылка на главный файл → при необходимости ИИ перечитает ~/AGENTS.md целиком
• Кроссплатформенно: ~ для Linux/macOS, %USERPROFILE% для Windows

Разрешённые директории для агентов

ИИ может создавать и редактировать файлы агентов во всех CLI-директориях, указанных в .agents/skills/subagent-creator-universal/SKILL.md. Полный список путей и форматов — в этом скилле.

Контрибьюторы

Хотите добавить свой скилл или улучшить проект?

Шаблон нового скилла: skills/.template/SKILL.md — скопируйте и заполните:

cp -r skills/.template skills/my-skill-name

Полный гайд: CONTRIBUTING.md