Name: aidemd-mcp/server
Availability: InStock
Author: aidemd-mcp

aide_brain

Инструмент для обращения к брейн-системе по требованию. Вызывай, когда нужно получить доступ к брейн-системе в середине задачи — НЕ вызывай его при каждом запуске /aide. Состояние брейн-системы при загрузке уже сообщается через `aide_info.brain.status`; вызов `aide_brain` при загрузке дублирует эту работу без необходимости. **Необязательный параметр `kind`** — замкнутый словарь из двух значений: `"orientation"` (по умолчанию) или `"config"`. - `"orientation"` — возвращает раздел ориентации: краткую сводку времени выполнения, когда агент обращается к брейн-системе в середине задачи. Если не указать `kind`, это равносильно передаче `"orientation"`. - `"config"` — возвращает схему интеграции, используемую `/aide:brain config` для прохождения настройки брейн-системы. Разделы, установленные при инициализации (`playbookIndex`, `studyPlaybook`, `updatePlaybook`, `researchIndex`), НЕ возвращаются через этот инструмент — агенты получают к ним доступ через инструмент чтения брейн-системы к файлам на диске. **Форма ответа: `{ status, instructions }` — ровно два поля. Никаких `backend`, `connector`, `name`, `kind`.** `status` — отражает размеченное объединение `BrainState` из `buildBrainState`. Словарь из четырёх состояний: `ok`, `no-brain-aide`, `no-mcp-entry`, `mcp-drift`. Принимай решение только по `status` — других дискриминантов нет. `instructions` — всегда непустое значение для любой ветки. Используй это поле напрямую: - Для `ok`: точные байты выбранного раздела из файла `.aide/config/brain.aide` на хосте, побайтово идентичные тому, что пользователь написал между маркерами этого раздела. Без обрезки, без нормализации, без подстановки `${...}`. Выбранный раздел вступает в силу — инструмент больше не играет роли. - Для `no-brain-aide`: фиксированный текст с инструкцией пользователю выполнить `npx @aidemd-mcp/server@latest init`. Не продолжай так, будто брейн-система доступна. - Для `no-mcp-entry`: фиксированный текст с инструкцией пользователю выполнить `npx @aidemd-mcp/server@latest sync` и перезапустить Claude Code. Не продолжай так, будто брейн-система доступна. - Для `mcp-drift`: фиксированный текст с инструкцией пользователю выполнить…

Параметры

kindenum
Which section of brain.aide to return. `"orientation"` (default when omitted) returns the runtime briefing for mid-task brain access. `"config"` returns the integration-specific wiring flow used by `/aide:brain config`.
orientationconfig

aide_discover

Сканирует файлы спецификаций .aide в этом проекте. Возвращает древовидную карту расположения спецификаций, следуя принципу прогрессивного раскрытия. Без пути: возвращает облегчённую карту всего проекта — только местоположения и типы файлов, без содержимого. Используйте её один раз, чтобы понять архитектуру спецификаций проекта. С путём: ответ начинается с цепочки предков — каскадной линии намерений от корня проекта до целевой директории, где каждый предок показывает своё описание и статус согласованности (aligned/misaligned, если задано). Цепочка предков даёт полный унаследованный контекст до чтения тела спецификации. После цепочки предков следует детализированное поддерево целевой директории — выдержки из содержимого файлов и предупреждения об аномалиях. Используйте это, чтобы погрузиться в интересующую вас область. Файлы .aide — это спецификации с прогрессивным раскрытием, которые находятся рядом с кодом оркестратора. Они содержат намерение (стратегия, контракты реализации, антипаттерны), исследования (источники, данные, паттерны) или контрольные списки QA (todo). Читайте файлы .aide ДО чтения кода — они являются слоем контекста между структурой папок и деталями реализации. Типы файлов (.aide, intent.aide, research.aide, plan.aide, todo.aide): - .aide — Спецификация намерения (по умолчанию). Стратегия, контракты, антипаттерны. - intent.aide — То же, что и .aide, используется только если в той же папке есть research.aide. - research.aide — Сырое исследование. Источники, точки данных, синтез паттернов. - plan.aide — План реализации архитектора. Пункты с флажками для исполнителя. - todo.aide — Документ повторной синхронизации QA. Фиксирует, где реализация отошла от намерения. Никогда не размещайте одновременно .aide и intent.aide в одной папке.

Параметры

pathstring
Subdirectory to drill into. When provided, the response opens with the ancestor chain — the cascading intent lineage from root to target, each ancestor showing its description and alignment status — followed by the detailed subtree with summaries and warnings. When omitted, returns a shallow project-wide map (locations and types only).

aide_info

Докладчик времени загрузки, вызываемый оркестратором при запуске. Возвращает два независимых поля верхнего уровня, по которым оркестратор должен выполнить ветвление по отдельности: **`outdated` (массив устаревших ключей артефактов) - мягкое уведомление.** Сравнивает `.aide/versions.json` хоста с каноническим манифестом, поставляемым с этим npm-пакетом. Каждый элемент называет ключ артефакта, который отстаёт. Пустой массив означает, что всё актуально. Отсутствующий `.aide/versions.json` (старая установка, предшествующая отслеживанию версий) молча сводится к `[]`. Устаревание носит информационный характер - оркестратор продолжает работу с уведомлением пользователя. **`brain` (состояние предусловия) - жёсткий шлюз.** Сообщает, подключена ли и согласована ли запись MCP мозга хоста. Формат: `{ status, name?, hints }`. Оркестратор должен остановиться и направить пользователя на устранение проблемы перед продолжением, если `status` не равен `'ok'`. Валидация путей не выполняется - пакет никогда не проверяет ни одну директорию на диске; состояние выводится полностью из сравнения `.aide/config/brain.aide` с `.mcp.json`. Четыре значения `brain.status`: - `ok` - `.aide/config/brain.aide` существует, и запись `brain` в `.mcp.json` хоста совпадает с разобранным `mcpServerConfig`. `name` - объявленная пользователем описательная метка из brain.aide. Конвейер может продолжаться. - `no-brain-aide` - `.aide/config/brain.aide` отсутствует или не поддаётся разбору. Поле `name` отсутствует. Исправление: запустить `/aide` и пройти интервью по настройке мозга. - `no-mcp-entry` - brain.aide успешно разобран, но `.mcp.json` хоста отсутствует, повреждён или не содержит ключа `mcpServers.brain`. `name` присутствует. Исправление: запустить `npx @aidemd-mcp/server@latest sync`. - `mcp-drift` - brain.aide и `.mcp.json` существуют, но их записи `brain` расходятся в `command` или `args`. `name` присутствует. Исправление: запустить `npx @aidemd-mcp/server@latest sync`. `hints` всегда присутствует при любом статусе - массив кандидатов корневых путей мозга, которые оркестратор может показывать во время восстановления. Параметры не требуются - использует серверную…

Параметры

Без параметров.

aide_init

Развёртывает среду разработки AIDE в проекте. Возвращает структурированный JSON для использования агентом — не в виде текстового описания. Инструмент использует схему с двумя вызовами для постепенного раскрытия информации: **Первый вызов (без параметра `category`):** Возвращает облегчённую сводку — каждый шаг с полями `name`, `status` (would-create/would-overwrite/would-skip/exists), `category` и `filePath`, но БЕЗ ПОЛЕЙ `content`. Также возвращает `brainHints` (кандидаты в корень brain) и обнаруженный `framework`. Используйте это, чтобы понять, что нужно сделать и для каких категорий требуются запросы к пользователю. **Второй вызов (с параметром `category`):** Инструмент сам записывает на диск все файлы со статусом `would-create` И одобренные `would-overwrite` и возвращает манифест — шаги с `filePath`, `status` (`created`, `overwritten` или `exists`) и `name`, но БЕЗ `content`. Шаги со статусом `would-skip` остаются `would-skip` в манифесте (инструмент для них ничего не записывает). Агент никогда не видит содержимое файлов и не использует инструмент Write для новых файлов. **Исключение — шаги MCP:** Для шагов MCP манифест содержит данные `prescription` (имя ключа и объект записи), чтобы агент мог прочитать существующую конфигурацию, объединить и записать. Инструмент никогда не трогает конфигурацию MCP напрямую. **Исключение — категория brain:** При вызове с `category=brain` также передайте `brainPath` с подтверждённым пользователем корневым путём brain. Инструмент сам создаёт каркасные директории корня brain. **Исключение — шаги IDE VS Code:** Шаги IDE, которым нужно внешнее средство (CLI VS Code), возвращают инструкции для выполнения агентом, поскольку это не простые записи файлов. **Логика ветвления агента — silent-on-create, prompt-on-overwrite:** После первого вызова пройдите по категориям, используя это правило: - **Pure-create category** (все шаги — `would-create`, `would-skip` или `exists`): применяйте бесшумно, сразу вызывая с `category=X` — без AskUserQuestion. Категория, в которой нечего перезаписывать на диске, не даёт пользователю возможности принять решение. - **Overwrite-bearing category** (любой шаг — …

Параметры

frameworkenum
Force a specific framework instead of auto-detecting. Use this when re-calling after the user confirms or overrides detection.
claudecursorwindsurfcopilot
pathstring
Custom project root path (defaults to server working directory)
categoryenum
Write all would-create and approved would-overwrite files for this category to disk and return a manifest (status: created/overwritten/exists; would-skip steps pass through unchanged). Omit on the first call to get a metadata-only summary of all steps.
frameworkmethodologycommandsagentsskillsmcpbrainidereadme
brainPathstring
Resolved brain root path. Required when category=brain. The agent provides this after interviewing the user.

aide_inspect

Возвращает JSDoc, сигнатуру и kind для именованного символа без открытия полного файла: прогрессивное раскрытие кода уровня 2. Когда агенту известно имя функции из списка импортов или файла оркестратора, он вызывает inspect, чтобы узнать, что делает символ, что он принимает и что возвращает, основываясь только на его контракте. Ищет по исходным файлам TypeScript и JavaScript (ts, tsx, js, jsx, mjs, cjs). Использует необязательный параметр `file` для сужения поиска до одного файла, если местоположение уже известно.

Параметры

namestringобязательный
Symbol name to look up
filestring
Optional file path to narrow search to a single file

aide_read

Читает файл спецификации .aide с полным контекстом. Возвращает содержимое файла, его классифицированный тип (intent/research/plan/todo), связанные спецификации в той же директории и ссылки, найденные в содержимом (относительные пути, встроенные ссылки, URL). Используйте этот инструмент после aide_discover для углублённого изучения конкретной спецификации.

Параметры

pathstringобязательный
Path to the .aide file to read

aide_scaffold

Создаёт новые .aide spec-файлы с автоматическим применением правил именования. Правила именования: intent-спеки по умолчанию имеют расширение .aide, но переименовываются в intent.aide при наличии research.aide в той же папке. Создание research.aide автоматически переименовывает любой существующий .aide-файл в intent.aide. Типы: - intent — Стратегия, контракты, анти-паттерны - research — Источники, данные, паттерны (запускает переименование существующих .aide-файлов) - both — Создаёт пару research.aide + intent.aide - todo — Документ QA-перенастройки для агентов контроля качества - plan — План реализации архитектора (не взаимодействует с intent/research по именованию)

Параметры

directorystringобязательный
Directory where the .aide file(s) will be created
typeenumобязательный
Type of .aide file to create
intentresearchbothtodoplan

aide_upgrade

Сравнивает артефакты методологии AIDE в этом проекте с каноническими версиями и возвращает структурированные JSON-результаты, сгруппированные по категориям. Используйте этот инструмент, когда пользователь просит обновить AIDE, синхронизировать AIDE, обновить AIDE, проверить обновления AIDE или привести AIDE в актуальное состояние. ЭТО НЕ ДЛЯ редактирования пользовательских .aide-спецификаций — он проверяет только инфраструктуру методологии. Инструмент использует двухшаговый паттерн для постепенного раскрытия информации: **Первый вызов (без параметра `category`):** Возвращает лёгкую сводку — каждая категория с названиями файлов, статусами и количеством, но БЕЗ содержимого файлов. Используйте это, чтобы понять, что отошло, и показать пользователю сводку. Спросите, какие категории он хочет применить. **Второй вызов (с параметром `category`):** Инструмент сам записывает все изменённые/отсутствующие файлы напрямую на диск и возвращает манифест — результаты по файлам с `filePath`, статусом (`"updated"`, `"created"` или `"unchanged"`) и `name`, но БЕЗ `canonicalContent`. Агент никогда не видит содержимого файлов и не использует инструмент Write для файлов методологии. Повторите второй вызов для каждой категории, которую подтвердит пользователь. Как вызывающий агент, вы обязаны: 1. Вызвать сначала без `category`, чтобы получить сводку. 2. Показать каждую отошедшую категорию (изменённые/отсутствующие) и спросить пользователя, какие применить. 3. Для каждой подтверждённой категории вызвать снова с `category=X` — инструмент записывает файлы и возвращает манифест. Сообщите пользователю, что было обновлено/создано. 4. Для категории `mcp` манифест всё ещё содержит данные `prescription` — сами объедините эту запись с существующей конфигурацией MCP (прочитайте → объедините → запишите). Если `malformed` — скажите пользователю, не перезаписывайте. 5. Для `ide` манифест может содержать `instructions` по установке расширения для VS Code — выполните эту команду за пользователя. Конфигурация для Zed записывается напрямую инструментом. 6. Для `brain` — `category=brain` никогда не записывает; запись манифеста содержит поле `instructions`, которое указывает агенту вызвать `/aide:brain config` — единственный канонический источник для создания brain.aide. **ВАЖНО —…**

Параметры

frameworkenum
Force a specific framework instead of auto-detecting. Auto-detection checks for framework-specific files/directories and defaults to Claude Code.
claudecursorwindsurfcopilot
pathstring
Custom project root path (defaults to server working directory)
categoryenum
Write all differs/missing files for this category to disk and return a manifest. Omit on the first call to get a metadata-only summary of all categories.
pointer-stubmethodology-docsversion-metadatacommandsagentsskillsmcpidereadmebrain

aide_validate

Проверка состояния файлов .aide spec в проекте. Обнаруживает осиротевшие spec'ы (в папках без оркестратора), отсутствующие spec'ы (оркестраторы с 3+ импортами helper, но без .aide), конфликты имен (.aide + intent.aide в одной папке), битые ссылки, осиротевшие research (research.aide без intent spec) и отсутствующие описания (spec'ы без поля description в frontmatter).