AIST_me_bot — AI-помощник по системному развитию

Тип репозитория: DS/instrument

Telegram-бот @aist_me_bot с персонализированным обучением от Мастерской инженеров-менеджеров.

Миссия: Помочь пользователям трансформироваться из случайных учеников в систематических — собранных и удерживающих внимание на своём развитии.

---

1. Для кого

Бот создан для тех, кто:

• Застрял в развитии — чувствует, что топчется на месте, несмотря на попытки учиться и расти
• Хочет расширить кругозор — ищет системный подход вместо разрозненных советов и лайфхаков
• Долго подбирался к системному мышлению — слышал о нём, пробовал разобраться, но не смог закрепиться
• Устал от хаотичного саморазвития — понимает, что нужна система, но не знает, с чего начать

Бот поможет перейти от «знаю, но не делаю» к «делаю систематически».

---

2. Что делает бот

@aist_me_bot — платформенный сервис, общий для всех пользователей. Не нужно разворачивать своего — достаточно написать /start.

Возможность	Как использовать	Что получаешь
Марафон	/learn	14-дневная программа по входу в системное саморазвитие: уроки по расписанию, адаптивная сложность, напоминания
Лента	/feed	Гибкий режим: выбираешь темы, получаешь ежедневные дайджесты, фиксируешь инсайты
Консультации	?вопрос	Ответы с доступом к базе ~5300 документов по системному мышлению
Заметки	.текст	Быстрые мысли в течение дня, которые потом обрабатывает Стратег
Планы	📋 Мой план	Дневной и недельный план, итоги вчерашнего дня, inbox triage — через интеграцию с GitHub strategy-репо
Прогресс	/progress	Streak, сложность, пройденные темы
Тест	/test	Определение состояния (Хаос/Тупик/Поворот) и адаптация контента
Цифровой двойник	/twin	Профиль развития, персональная траектория
Интеграции	/settings	GitHub, WakaTime, цифровой двойник

Бот — интерфейс, не центр. Главная идея IWE: бот — один из интерфейсов платформы (он всегда рядом в Telegram). Центр — экзокортекс и агенты. Бот, Claude Code, веб — разные окна в одну среду.

---

3. Два режима обучения

Режим	Для кого	Как работает
Марафон	Хочет пройти интенсив последовательно	14 дней: урок → вопрос → задание → рабочий продукт
Лента	Предпочитает свой темп	Выбор до 3 тем → дайджесты с углублением → фиксация

Общие возможности обоих режимов

• Консультация — задавайте вопросы в свободной форме, бот ответит с опорой на базу знаний по системному мышлению
• Многоязычность — интерфейс на русском, английском, испанском и французском языках
• Персонализация — адаптивная сложность вопросов под ваш уровень
• Прогресс — отслеживание пройденного материала и достижений

---

4. С чего начать

Быстрый старт

1. Найдите @aist_me_bot в Telegram
2. Напишите /start
3. Укажите своё имя
4. Выберите язык интерфейса
5. Укажите свой часовой пояс (для расписания)
6. Выберите уровень сложности вопросов
7. Выберите режим: Марафон или Лента

Сложность вопросов

При регистрации и в настройках можно выбрать уровень сложности:

Уровень	Название	Тип вопросов
Сложность-1	Понимаю	Объясните концепцию своими словами
Сложность-2	Применяю	Как применить это в своей работе?
Сложность-3	Анализирую	Предложите решение, оцените подходы

После 7 успешно пройденных тем — автоматический переход на следующий уровень.

Команды

Команда	Описание
/start	Начать работу / перезапустить бота
/learn	Получить следующий урок или дайджест
/mode	Переключить режим (Марафон/Лента) и настроить
/progress	Статистика за текущую неделю (кнопка для полного отчёта)
/profile	Показать профиль и настройки
/update	Изменить настройки (язык, часовой пояс)
/help	Справка по командам

Основные понятия

Термин	Определение
Ученик	Пользователь, проходящий Марафон
Читатель	Пользователь, использующий Ленту
Урок	Единица теории в Марафоне (материал + вопрос)
Задание	Единица практики в Марафоне
Дайджест	Ежедневный материал в Ленте
Фиксация	Личный вывод Читателя после дайджеста
Консультация	Ответ бота на вопрос пользователя в свободной форме

Полная терминология: docs/ontology.md

---

5. О Марафоне

Что даёт Марафон

• Структурированное погружение — последовательное изучение системного подхода за 14 дней
• Практика каждый день — рабочие продукты, которые вы создаёте по ходу обучения
• Обратная связь — проверка понимания через вопросы и комментарии от ИИ
• Привычка учиться — ежедневный ритм помогает закрепить практику саморазвития

14 дней, 28 тем

Марафон состоит из 14 дней. Каждый день включает:

• Урок — теоретический материал с вопросом на понимание
• Задание — практика с созданием рабочего продукта

Итого: 14 уроков + 14 заданий = 28 тем.

Структура тем

Неделя 1: От диагностики к практике

День	Тема урока	Рабочий продукт
1	Четыре состояния: от застревания к развитию	Моё текущее состояние
2	Ловушка «жизни полегче»	Первый слот саморазвития
3	Вечерняя ловушка и поставка впечатлений	Трекер слотов
4	Информационный шум и потеря фокуса	Мимолётные заметки
5	Цикл «перегрузка — выгорание — откат»	Стоп-моменты
6	Почему советы не работают	Гипотеза на неделю
7	Что такое личный прогресс	Итоги недели

Неделя 2: От практики к системе

День	Тема урока	Рабочий продукт
8	Непродуктивные мемы о саморазвитии	Рабочий продукт из слота
9	Героизм vs систематичность	ИИ как усиление
10	Почему одной мотивации недостаточно	Моё минимальное время
11	Обучение как инженерия себя	Чек-лист стоп-момента
12	Собранность и экзокортекс	Мои продуктивные мемы
13	Агентность: от реактивного к проактивному	Я как система
14	Время созидателей	План на месяц

---

6. О Ленте

Что даёт Лента

• Гибкость — учитесь в своём темпе, без жёсткого расписания
• Персонализация — выбирайте темы, которые интересны именно вам
• Ежедневные дайджесты — короткие материалы для регулярного развития
• Фиксация мыслей — записывайте свои выводы после каждого дайджеста

Как работает

1. Планирование недели — бот предлагает темы на основе ваших интересов
2. Выбор тем — выберите до 3 тем (можно предложить свою)
3. Дайджесты с углублением — по каждой теме 3 уровня глубины: обзор → практика → продвинутый
4. Фиксация — после прочтения запишите личный вывод
5. Новая неделя — в конце недели выбирайте новые темы

Отличия от Марафона

Марафон	Лента
Фиксированная программа	До 3 тем на выбор
14 дней подряд	Любая длительность
Уроки + задания	Дайджесты с углублением
Рабочие продукты	Фиксации

---

7. Тестировщикам

tests/test-manual/testing-scenarios.md — Полный чек-лист сценариев тестирования (123 сценария)

Что тестировать в первую очередь

1. Онбординг — пройдите регистрацию с /start, проверьте все шаги
2. Марафон — получите несколько уроков через /learn, ответьте на вопросы
3. Лента — переключитесь через /mode, выберите темы, получите дайджесты с углублением
4. Настройки марафона — через /mode проверьте настройки: дата старта, напоминания, сложность
5. Прогресс — проверьте /progress (короткий отчёт) и кнопку «Полный отчёт»
6. Консультация — задайте вопрос в свободной форме (например, «Что такое системное мышление?»)
7. Смена настроек — проверьте через /update, что язык и часовой пояс переключаются

Куда присылать обратную связь

Все замечания, баги и предложения отправляйте:

• Telegram: @tserentserenov
• GitHub Issues: github.com/aisystant/aist_bot/issues

Как сообщать о проблемах

При описании бага укажите:

1. Что делали (какую команду отправили)
2. Что ожидали увидеть
3. Что увидели на самом деле
4. Скриншот (если возможно)

Ваша обратная связь помогает сделать бота лучше!

---

8. Для разработчиков

Архитектура

Telegram ←→ Bot (Python/aiogram) ←→ PostgreSQL
                    ↓
              Claude API (генерация контента)

Технологии

• Python 3.11 + aiogram 3.x
• Anthropic Claude API
• PostgreSQL
• Railway / Render

Запуск

git clone https://github.com/aisystant/aist_bot
cd aist_bot
python -m venv venv && source venv/bin/activate
pip install -r requirements.txt
cp .env.example .env  # Заполнить токены
python bot.py

Переменные окружения

Переменная	Описание
TELEGRAM_BOT_TOKEN	Токен от @BotFather
ANTHROPIC_API_KEY	Ключ API Anthropic
DATABASE_URL	URL PostgreSQL

Структура проекта

aist_bot/
├── bot.py                    # Точка входа + старая архитектура
├── states/                   # 🆕 State Machine стейты
│   ├── common/               # Общие (start, mode_select, settings)
│   ├── workshops/marathon/   # Марафон (lesson, question, bonus, task)
│   ├── feed/                 # Лента (topics, digest)
│   └── utilities/            # Утилиты (progress)
├── core/                     # 🆕 Движок State Machine
│   └── machine.py
├── config/
│   ├── settings.py
│   └── transitions.yaml      # 🆕 Таблица переходов
├── i18n/                     # 🆕 Локализация (ru/en/es/fr)
├── integrations/telegram/    # 🆕 Клавиатуры Telegram
├── engines/feed/             # Режим Лента
├── clients/                  # Claude API, MCP
├── db/                       # Модели и запросы БД
├── docs/ontology.md          # Терминология (источник истины)
├── knowledge_structure.yaml  # Структура 28 тем
└── CLAUDE.md                 # Инструкции для ИИ

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

• docs/ontology.md — Терминология и онтология системы
• tests/test-manual/testing-scenarios.md — Сценарии тестирования
• CLAUDE.md — Инструкции для ИИ-ассистентов

---

Лицензия

MIT

---

Сделано Мастерской инженеров-менеджеров | Aisystant