codedna — плагин для Claude Code: разметка архитектуры
codedna добавляет в исходники сведения об экспортах, зависимостях и ограничениях файлов. Команды плагина помогают собрать карту проекта и оценить последствия рефакторинга.
/plugin marketplace add anthropics/claude-plugins-community
/plugin install codedna@claude-communityЧто делает codedna
Плагин размечает файлы проекта полями exports:, used_by: и rules:. Команда /codedna:init добавляет аннотации в файлы без разметки, /codedna:check ищет пропуски и устаревшие ссылки, а /codedna:manifest показывает архитектурную карту. Для рефакторинга команда /codedna:impact <file> выводит цепочку зависимостей от выбранного файла.
В плагин также входят четыре хука: они читают .codedna при старте сессии, напоминают проверить документацию перед использованием инструмента, проверяют аннотации после записи или редактирования и напоминают о них в конце сессии. Агент codedna-reviewer запускается через /agents. Для хука проверки аннотаций нужен Python 3.11+; без него эта проверка не будет работать. CodeDNA описывает поддержку 12 языков программирования, 28 расширений и 7 семейств шаблонов; для AXL используются экспериментальные native frames.
Какие задачи решает
- добавить архитектурные аннотации в файлы без разметки
- найти устаревшие ссылки
used_by: - собрать карту архитектуры проекта
- проверить цепочку зависимостей перед рефакторингом
- проверить соблюдение аннотаций после правок
Примеры запросов агенту
- Разметь все файлы проекта, у которых ещё нет аннотаций:
/codedna:init. - Покажи файлы без разметки и устаревшие ссылки
used_by::/codedna:check. - Перед рефакторингом покажи, какие файлы зависят от
src/auth.ts:/codedna:impact src/auth.ts.
Как установить codedna
Через маркетплейс плагинов
/plugin marketplace add anthropics/claude-plugins-community/plugin install codedna@claude-communityПо шагам, с командами для каждой платформы: Плагины Claude Code: маркетплейсы, установка и как собрать свой
Вопросы о codedna
Как установить codedna в Claude Code?
Выполните /plugin marketplace add anthropics/claude-plugins-community, затем /plugin install codedna@claude-community.
Что делает codedna?
Плагин добавляет к файлам исходного кода аннотации об их экспортах, зависимостях и ограничениях. Его команды строят карту проекта и показывают цепочки зависимостей.
Нужен ли Python для codedna?
Python 3.11+ нужен хуку, который проверяет аннотации. В плагин также входят четыре автоматических хука и агент codedna-reviewer.
Исходный текст
codedna-plugin · MIT
# CodeDNA Plugin for Claude Code Extends Claude Code with the [CodeDNA](https://github.com/Larens94/codedna) in-source AI communication protocol. ## What it does - **/codedna:init** — annotate all unannotated files in the project - **/codedna:check** — coverage report: which files lack annotation, which `used_by:` references are stale - **/codedna:manifest** — full architectural map in one pass (replaces 10-20 file reads) - **/codedna:impact `<file>`** — cascade dependency chain before a refactor - **4 automatic hooks** — SessionStart (reads `.codedna`), PreToolUse (reminds to read docstring), PostToolUse (validates L1 + L2 annotations on every Write/Edit), Stop (session end reminder) - **codedna-reviewer agent** — on-demand compliance reviewer, invokable via `/agents` ## Install ```bash claude plugin marketplace add Larens94/codedna claude plugin install codedna@codedna ``` Or test locally: ```bash claude --plugin-dir ./codedna-plugin ``` ## Usage ``` /codedna:init # annotate all unannotated files /codedna:check # find unannotated files and stale used_by: refs /codedna:manifest # show project architecture map /codedna:impact <file> # show who depends on this file ``` ## What is CodeDNA? CodeDNA is an inter-agent communication protocol embedded in source files. Every file carries a structured annotation that tells AI agents: - **`exports:`** — what this file provides publicly - **`used_by:`** — who depends on it (reverse dependency graph) - **`rules:`** — hard constraints that must never be violated - **`agent:`** — append-only session log from previous AI agents - **`message:`** — agent-to-agent chat: open observations, promoted to `rules:` or dismissed This gives any AI agent instant architectural context without reading dozens of files. Supports 12 programming languages across 28 extensions, plus 7 template families; AXL uses experimental native frames rather than comments. See the [full spec](https://github.com/Larens94/codedna/blob/main/SPEC.md) for details. ## Requirements - Claude Code - Python 3.11+ (for the annotation check hook)
© Larens94 · MIT · Larens94/codedna
