# aicoding.space

> Русскоязычный сайт Дмитрия Жечкова об agentic engineering: бесплатные интерактивные курсы, инженерные разборы, открытые инструменты и живая мастерская.

Основная тема сайта — инженерная обвязка вокруг ИИ-модели: навыки, проверки, контекст, воспроизводимые процессы и доказательства качества. Все публичные курсы бесплатны и открываются без регистрации. Основной язык — русский.

## Начать здесь

- [Главная](https://aicoding.space/): краткая карта практики, курсов и мастерской
- [Каталог курсов](https://aicoding.space/courses/): 40 курсов по восьми семействам инструментов
- [Харнесс изнутри](https://aicoding.space/courses/harness-architecture/): обзор архитектуры и карта всех курсов
- [Инструменты](https://aicoding.space/tools/): опубликованные пакеты и навыки
- [Разборы](https://aicoding.space/blog/): статьи с проверяемыми примерами
- [О Дмитрии Жечкове](https://aicoding.space/about/): опыт, преподавание, выступления и публикации
- [Связаться](https://aicoding.space/contact/): людям — телеграм-бот обращений и заявка в мастерскую; агентам — те же адреса, что ниже, на одной странице

## Машиночитаемые интерфейсы

- [Индекс публичного контента](https://aicoding.space/agent/content-index.json): страницы, курсы и статьи в JSON
- [Индекс единиц цитирования](https://aicoding.space/agent/units/index.json): разделы курсов и абзацы статей с адресами `#id`, текстом и происхождением; единицы документа — `/agent/units/<slug>.json`
- [Sitemap](https://aicoding.space/sitemap.xml): полный список индексируемых URL
- [RSS](https://aicoding.space/rss.xml): новые разборы
- [A2A Agent Card](https://aicoding.space/.well-known/agent-card.json): обнаружение read-only агента сайта

## Протокольные интерфейсы

Эти три интерфейса не изменяют публичный контент сайта: они только читают. API-ключ,
аутентификация и регистрация не требуются. Генеративной модели за ними нет — агент получает данные
сайта и ссылку на страницу, где их видно человеку.

Все три принимают только `POST`. `GET` не поддерживается: `/mcp` отвечает 405, оба адреса A2A — 404.

- [MCP endpoint](https://aicoding.space/mcp): `POST`, MCP поверх Streamable HTTP.
  Обязательны два заголовка: `Content-Type: application/json` и
  `Accept: application/json, text/event-stream` — без второго сервер отвечает 406.
  Ответ приходит потоком `text/event-stream`, а не обычным JSON, даже на одиночный вызов.
  Первый запрос — `initialize`; дальше `tools/list` вернёт сигнатуры инструментов, так что
  перечислять их здесь незачем. Доступны `search_site` (каждый результат — с цитатой и адресом
  раздела `#id`), `list_courses`, `get_course`, `get_passage` (единица целиком по `unit_id`) и
  ресурс `aicoding://site/index`.
- [A2A JSON-RPC](https://aicoding.space/a2a): `POST`, A2A 1.0, биндинг JSON-RPC, метод `SendMessage`.
  Обязательны `Content-Type: application/json` и `A2A-Version: 1.0` — без второго сервер отвечает 400.
- [A2A HTTP+JSON](https://aicoding.space/a2a/rest): `POST`, тот же агент, биндинг HTTP+JSON 1.0.
  POST идёт на полный путь операции `/a2a/rest/v1/message:send`, не на базовый. Те же два
  заголовка обязательны — без `A2A-Version` сервер отвечает 400.

- [Машинный слой для людей](https://aicoding.space/api/): те же адреса и инструменты на странице сайта, с примерами подключения.

Начинать удобнее с карточки агента выше: она объявляет оба биндинга A2A машиночитаемо. MCP назван
только здесь — в схеме карточки места под него нет.

Это точка входа, а не спецификация: формы тел запросов смотрите в спецификациях MCP и A2A.

## Optional

- [Поиск по сайту](https://aicoding.space/search/): локальный Pagefind-индекс; запросы остаются в браузере
- [Мастерская](https://aicoding.space/workshop/): платный формат живой работы, отдельно от бесплатных курсов
- [Telegram «LLM notes»](https://t.me/llm_notes): заметки автора