aiboarding — плагин для Claude Code: онбординг и установка
Плагин aiboarding для Claude Code поддерживает актуальность AGENTS.md и CLAUDE.md, отслеживает изменения и проверяет инструкции. Обновляет инструкции в репозиториях с AI-агентами.
MIT ★ 1 596 обновлён 2026-10-29
/plugin marketplace add hashgraph-online/awesome-codex-plugins
/plugin install aiboarding@awesome-codex-pluginsЧто делает aiboarding
aiboarding создаёт канонический AGENTS.md, тонкий CLAUDE.md с импортом, файл состояния .aiboarding/state.json и хуки после проверки. Команда создания запускает подготовку онбординга, а обновление разбирает изменившуюся область: правит затронутые инструкции или двигает указатель состояния, если правки не нужны.
Плагин переносит старый AIBOARDING.md, сжимает инструкции с сохранением команд, путей, URL и кода, а также проводит аудит без редактирования файлов. Аудит ищет устаревшие команды, противоречия, секреты, проблемы с размером и ограничения цепочки инструкций.
Для Codex доступны переносимые SKILL.md в .agents/skills/, но этот способ не устанавливает хуки, поэтому обновления нужно запускать вручную. На Windows без Git Bash проверочный запуск bash tests/run.sh не сработает.
Какие задачи решает
- создать канонический
AGENTS.mdдля AI-агентов - синхронизировать тонкий
CLAUDE.mdс основной инструкцией - обновить онбординг после изменений в репозитории
- перенести руководство из
AIBOARDING.md - найти устаревшие команды и противоречия без правки файлов
Примеры запросов агенту
- Создай файлы онбординга и жизненный цикл командой
/aiboarding:create-agent-onboarding. - Обнови онбординг после значимых коммитов через
/aiboarding:update-agent-onboarding. - Проведи аудит инструкций и найди устаревшие команды, противоречия и секреты.
Как установить aiboarding
Через маркетплейс плагинов
/plugin marketplace add hashgraph-online/awesome-codex-plugins/plugin install aiboarding@awesome-codex-pluginsПо шагам, с командами для каждой платформы: Плагины Claude Code: маркетплейсы, установка и как собрать свой
Вопросы об aiboarding
Как установить aiboarding в Claude Code?
Сначала выполни /plugin marketplace add hashgraph-online/awesome-codex-plugins, затем /plugin install aiboarding@awesome-codex-plugins.
Что делает aiboarding?
Плагин ведёт жизненный цикл файлов онбординга: создаёт и обновляет AGENTS.md, поддерживает импорт в CLAUDE.md, переносит старую структуру, сжимает инструкции и выполняет аудит.
Работает ли aiboarding с Codex?
Для Codex можно скопировать переносимые SKILL.md в .agents/skills/. Этот способ не устанавливает хуки, поэтому обновления выполняются вручную.
Исходный текст
aiboarding · MIT
# AIBoarding <picture> <source media="(prefers-color-scheme: dark)" srcset="./assets/aiboarding-wordmark-dark.svg"> <img src="./assets/aiboarding-wordmark-light.svg" alt="AIBoarding — a current boarding pass for every coding agent" width="600"> </picture> **AIBoarding keeps `AGENTS.md` alive.** It is a repository-onboarding lifecycle for maintainers using AI coding agents: canonical guidance stays current across supported agents without duplicated instruction sources or broad rewrites of unchanged guidance. [](./LICENSE) [](./RELEASE-NOTES.md) ## Why Agents arrive like new engineers: they need the stack, commands, architecture, guardrails, and known failure modes before touching code. Without maintained guidance they repeatedly rediscover the repository—**onboarding drift**. AIBoarding creates a canonical `AGENTS.md`, keeps `CLAUDE.md` as a thin import, and tracks lifecycle state outside instruction files. ## See it  The example is derived from [`tests/fixtures/modern`](./tests/fixtures/modern): it demonstrates the intended file relationship, not a live install or a universal agent-quality result. ## Quick start (Claude Code) ```text /plugin marketplace add gustavo-meilus/aiboarding /plugin install aiboarding@aiboarding ``` Then create the onboarding files and lifecycle: ```text /aiboarding:create-agent-onboarding ``` Run the deterministic suite after repository changes (Git Bash is required on Windows): ```bash bash tests/run.sh ``` ## Proof and limits - The offline lifecycle contract is covered by [`bash tests/run.sh`](./tests/run.sh) and the focused test suites. - Live-runtime loading and hook delivery are opt-in protocols; their current availability and degraded paths are recorded in the [verification runbook](./docs/VERIFICATION.md). - The retained [benchmark report](./benchmarks/agent-outcomes/results/codex-command-discovery-v2/report.md) is limited to its task and runtime. It is not a general speed, token, or coding-quality claim. - Portable `SKILL.md` files can be copied to `.agents/skills/` for Codex and Copilot CLI. That route does not install lifecycle hooks, so run updates manually. ## What it does | Lifecycle step | Outcome | | --- | --- | | Create | Generates `AGENTS.md`, thin `CLAUDE.md`, sidecar state, and hooks behind a validation gate. | | Update | Triages changed scope; patches affected guidance or advances only the state pointer on a no-op. | | Migrate | Moves legacy `AIBOARDING.md` guidance to the current layout without discarding it. | | Compress | Reduces instruction bloat while byte-preserving commands, paths, URLs, and code. | | Audit | Reports stale commands, contradictions, secrets, size risks, and instruction-chain limits without editing files. | Use `/aiboarding:update-agent-onboarding` after meaningful commits, `/aiboarding:migrate-aiboarding` for the legacy layout, and the namespaced compression/audit skills when needed. ## Safety and supported surfaces `AGENTS.md` is the canonical source; `CLAUDE.md` imports it rather than duplicating it. The sync pointer remains in `.aiboarding/state.json`, preventing bookkeeping from modifying instructions. Hooks are small, deterministic, and advisory: native loading still works if hooks are unavailable, disabled, or untrusted. Older runtimes and Windows systems without Git Bash can have reduced hook behavior; see the runbook for exact boundaries. Claude Code has the tested marketplace installation above. Codex plugin installs include optional native hooks subject to `/hooks` trust review. Copilot, Cursor, and other agents consume canonical repository guidance through their native or portable instruction mechanisms; live compatibility verification is documented rather than implied. ## Architecture and documentation `skills/` owns lifecycle reasoning, `templates/` owns installed copies, and `tests/` prove deterministic behavior. Read [AGENTS.md](./AGENTS.md) for repository conventions, [loop engineering](./docs/LOOP-ENGINEERING.md) for where this fits in an agent loop, [verification](./docs/VERIFICATION.md) for manual protocols, and [release notes](./RELEASE-NOTES.md) for versioned history. ## Help, contributing, and security Report reproducible bugs or propose scoped features through [GitHub issues](https://github.com/gustavo-meilus/aiboarding/issues). Read [CONTRIBUTING.md](./CONTRIBUTING.md), follow the [Code of Conduct](./CODE_OF_CONDUCT.md), and use [SECURITY.md](./SECURITY.md) for private vulnerability reporting—do not file vulnerabilities as public issues. Licensed under [MIT](./LICENSE). Keep your agents current, then let them get on with the work.
© hashgraph-online · MIT · hashgraph-online/awesome-codex-plugins