# Документация Actari

Как устроен Actari, как подключить агента и пройти путь от идеи до выпуска.

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

Главное правило продукта: «исполнитель считает, что готово» и «проверено и принято» — разные факты. Журнал не даёт выдать первое за второе, а правила того, что считать готовым, задаёте вы.

## Из чего состоит Actari

- **Облако** — пространство команды: фичи, доска, приёмка, база знаний, уведомления и лента обновлений.
- **MCP-сервер `actari-mcp`** — журнал на машине разработчика, которым агент управляет инструментами.
- **Скиллы** — тексты, которые учат агента порядку работы: от протокола журнала до ведения фичи целиком.
- **Политика** — правила постановки, отчёта и приёмки; задаётся в облаке и действует для всех агентов проекта.

## Путь фичи

1. Вы обсуждаете фичу с агентом или заводите её в облаке и описываете критерии готовности.
2. Агент делит её на небольшие задачи и ведёт каждую через журнал: черновик, передача исполнителю, отчёт.
3. Отдельный проверяющий принимает работу или возвращает её на доработку. Автор свою работу не принимает.
4. Вы выкатываете принятое, агент записывает выпуск, и облако рассылает уведомление и пополняет ленту обновлений.

## С чего начать

- **Хотите попробовать.** Пройдите [Быстрый старт](/docs/quick-start): семь шагов от регистрации до первой задачи в облаке.
- **Хотите понять, как это устроено.** Прочитайте раздел «Как устроено»: [Журнал и статусы](/docs/concepts/journal), [Фича и намерение](/docs/concepts/feature-and-intent), [Приёмка](/docs/concepts/acceptance) и [Выпуски](/docs/concepts/releases).
- **Подключаете агента.** Раздел «Агенты»: [Установка](/docs/agents/install), [Скиллы цикла](/docs/agents/skills) и [Политика проекта](/docs/agents/policy).
- **Работаете в облаке.** Начните с [Фичи и доска](/docs/cloud/features-board), дальше — [AI-продакт](/docs/cloud/ai-product), [Карта системы](/docs/cloud/system-map), [База знаний и поиск](/docs/cloud/knowledge-search) и [Бот в Telegram](/docs/cloud/telegram-bot).
- **Хотите развернуть у себя.** [Self-host](/docs/self-host): публичные образы готовятся, пока развернуть у себя нельзя.
- **Ищете инструмент или параметр.** [Справочник MCP](/docs/reference/mcp-tools) перечисляет все инструменты `actari-mcp`.
- **Что-то не работает.** [Неполадки и FAQ](/docs/faq).

## Для агентов

У каждой страницы есть текстовая версия: добавьте `.md` к адресу страницы, например `/docs/quick-start.md`. Оглавление всей документации со ссылками на текстовые версии отдаёт `/llms.txt`. [Быстрый старт](/docs/quick-start) устроен так, что агент проходит его по шагам без догадок: у каждого шага указана проверка результата.