Skip to content

An always-on second brain you talk to. Voice notes in Telegram → typed, linked knowledge in your Obsidian vault. Runs 24/7 on the Claude subscription you already have.

docs: обновить README.md

smixsdfe593d9ba2b
diff --git a/README.md b/README.md
index 28d3814..68ed8e3 100644
--- a/README.md
+++ b/README.md
@@ -47,25 +47,34 @@ Claude вечером:
## Архитектура
```
-┌──────────────┐ ┌──────────────┐ ┌──────────────┐
-│ Telegram │────▶│ VPS-сервер │────▶│ GitHub │
-│ (ввод) │ │ (бот+агент) │ │ (backup) │
-└──────────────┘ └──────────────┘ └──────────────┘
- │
- ┌─────────────┼─────────────┐
- ▼ ▼ ▼
- ┌──────────┐ ┌──────────┐ ┌──────────┐
- │ Todoist │ │ Obsidian │ │ Claude │
- │ (задачи) │ │ (заметки)│ │ (AI) │
- └──────────┘ └──────────┘ └──────────┘
-```
-
-**Почему так:**
-- **Telegram** — самый удобный способ записать мысль на ходу
-- **VPS** — бот работает 24/7, не зависит от вашего компьютера
-- **GitHub** — автоматический backup + синхронизация с компьютером
-- **Todoist** — задачи в одном месте, уведомления, мобильное приложение
-- **Obsidian** — полный контроль над данными, связи между заметками
+ ┌──────────────┐
+ │ GitHub │
+ │ (backup) │
+ └──────────────┘
+ ▲
+ │
+┌──────────────┐ ┌──────────────┐ ┌──────────────────┐
+│ Telegram │────▶│ VPS-сервер │────▶│ Claude Code │
+│ (ввод) │ │ (бот) │ │ (агент) │
+└──────────────┘ └──────────────┘ └──────────────────┘
+ ▲ │ │
+ │ ▼ ▼
+ │ ┌──────────┐ ┌──────────┐
+ │ │ Todoist │ │ Obsidian │
+ │ │ (задачи) │ │ (заметки)│
+ │ └──────────┘ └──────────┘
+ │ │
+ └─────────────────────────────────────┘
+ (отчёт обратно)
+```
+
+**Как это работает:**
+1. Вы отправляете голосовое/текст/фото в **Telegram**
+2. **Бот на VPS** сохраняет всё в файл
+3. **Claude Code** (агент) анализирует записи
+4. Создаёт задачи в **Todoist**, сохраняет мысли в **Obsidian**
+5. Отправляет отчёт обратно в **Telegram**
+6. Всё синхронизируется в **GitHub** (backup)
---
@@ -92,9 +101,8 @@ Claude вечером:
**Claude:** Минимальная подписка за $20/мес — достаточно. Это в 5 раз лучше ChatGPT для работы с кодом и структурированными данными.
**VPS:** Нужен сервер НЕ в РФ/РБ (блокировка Claude по территории). Рекомендую:
-- [Contabo](https://contabo.com) — от $4/мес, простая регистрация
-- [OVH](https://ovhcloud.com) — от $3/мес, без паспорта
-- [Hetzner](https://hetzner.com) — от $4/мес, немецкое качество
+- [Contabo](https://contabo.com) — $4.96/мес, работает с белорусскими картами
+- [OVH](https://ovhcloud.com) — $5/мес, тоже работает с белорусскими картами
**Deepgram:** $200 на счёт при регистрации. Хватает на ~500 часов голосовых сообщений.
@@ -131,90 +139,155 @@ sudo apt install git
---
-## 1.2 Клонирование проекта
+## 1.2 Создание аккаунта на GitHub
+
+Если у вас ещё нет аккаунта:
+
+1. Зайдите на [github.com](https://github.com)
+2. Нажмите "Sign up"
+3. Введите email, придумайте пароль, выберите username
+4. Подтвердите email
+
+<!-- TODO: Скриншот регистрации GitHub -->
+
+---
+
+## 1.3 Fork проекта (создание своей копии)
+
+Fork — это ваша личная копия проекта. Все ваши записи будут храниться у вас.
+
+1. Откройте оригинальный репозиторий: [github.com/smixs/agent-second-brain](https://github.com/smixs/agent-second-brain)
+2. Нажмите кнопку **Fork** (правый верхний угол)
+3. Выберите свой аккаунт
+4. Нажмите "Create fork"
+
+<!-- TODO: Скриншот кнопки Fork на GitHub -->
+
+Теперь у вас есть своя копия: `https://github.com/ВАШ_ЛОГИН/agent-second-brain`
+
+---
+
+## 1.4 Клонирование вашего fork на компьютер
1. Откройте VS Code
2. Нажмите `Ctrl+Shift+P` (Windows/Linux) или `Cmd+Shift+P` (Mac)
3. Введите "Git: Clone" и выберите эту команду
-4. Вставьте URL:
+4. Вставьте URL **вашего fork** (не оригинала!):
```
- https://github.com/smixs/agent-second-brain.git
+ https://github.com/ВАШ_ЛОГИН/agent-second-brain.git
```
5. Выберите папку (например, Documents)
6. Нажмите "Open" когда спросит
<!-- TODO: Скриншот клонирования в VS Code -->
+Если спросит логин — введите свой GitHub логин и пароль (или Personal Access Token, если включена двухфакторка).
+
Теперь у вас открыт проект в VS Code.
---
-## 1.3 Очистка демо-данных
+## 1.5 Заполнение ваших целей (самый важный шаг!)
+
+Бот использует ваши цели для приоритизации задач. Без целей он не будет понимать, что для вас важно.
+
+В папке `vault/goals/` лежат 4 файла-шаблона:
+- `0-vision-3y.md` — видение на 3 года
+- `1-yearly-2025.md` — цели на год
+- `2-monthly.md` — приоритеты на месяц
+- `3-weekly.md` — фокус на неделю
-В левой панели VS Code найдите и **удалите** содержимое этих папок (это мои демо-записи, вам они не нужны):
+**Заполнять будем с помощью ChatGPT или Claude** — так проще и глубже.
+
+### Шаг 1: Откройте первый файл
+
+1. В левой панели VS Code найдите папку `vault`
+2. Раскройте её (нажмите на стрелочку)
+3. Раскройте папку `goals`
+4. Нажмите на файл `0-vision-3y.md`
+
+<!-- TODO: Скриншот открытия файла в VS Code -->
+
+### Шаг 2: Скопируйте содержимое
+
+1. Нажмите `Ctrl+A` (Windows/Linux) или `Cmd+A` (Mac) — выделить всё
+2. Нажмите `Ctrl+C` (Windows/Linux) или `Cmd+C` (Mac) — скопировать
+
+### Шаг 3: Откройте ChatGPT или Claude
+
+1. Зайдите на [chat.openai.com](https://chat.openai.com) или [claude.ai](https://claude.ai)
+2. Вставьте скопированный текст
+3. После текста добавьте этот промпт:
```
-vault/daily/ ← удалите все файлы внутри
-vault/thoughts/ideas/ ← удалите все файлы
-vault/thoughts/projects/
-vault/thoughts/learnings/
-vault/thoughts/reflections/
-vault/summaries/ ← удалите все файлы
-vault/attachments/ ← удалите все папки внутри
+Это шаблон моего 3-летнего видения. Помоги мне его заполнить.
+
+Правила:
+1. Задавай вопросы ПО ОДНОМУ
+2. Жди мой ответ, потом задавай следующий
+3. Копай глубже — если отвечаю размыто, уточняй
+4. В конце сформируй заполненный документ в том же формате
+
+Начни с первого вопроса о карьере и бизнесе.
```
-**Как удалить:** правый клик на файл → Delete
+4. Отправьте сообщение
-<!-- TODO: Скриншот файловой структуры в VS Code -->
+### Шаг 4: Ответьте на все вопросы
-**Не трогайте:**
-- `vault/goals/` — шаблоны целей (заполните своими)
-- `vault/MOC/` — индексы для навигации
-- `vault/.claude/` — настройки AI-агента
-- `vault/templates/` — шаблоны
+ChatGPT будет задавать вопросы по одному:
+- Где вы хотите быть через 3 года в карьере?
+- Какой доход вам нужен?
+- Какое здоровье и энергия?
+- Какие отношения?
+- И так далее...
----
+Отвечайте честно. Это ваш личный документ.
-## 1.4 Создание своего репозитория на GitHub
+### Шаг 5: Скопируйте результат обратно
-Нужно создать свой репозиторий, чтобы ваши записи хранились у вас, а не у меня.
+Когда ChatGPT выдаст заполненный документ:
-1. Зайдите на [github.com](https://github.com)
-2. Войдите или создайте аккаунт
-3. Нажмите "+" → "New repository"
-4. **Имя:** `my-second-brain` (или любое другое)
-5. **Важно:** Оставьте все галочки пустыми (без README, без .gitignore)
-6. Нажмите "Create repository"
+1. Выделите весь текст результата
+2. Скопируйте его (`Ctrl+C` / `Cmd+C`)
+3. Вернитесь в VS Code
+4. Выделите всё в файле (`Ctrl+A` / `Cmd+A`)
+5. Вставьте новый текст (`Ctrl+V` / `Cmd+V`)
+6. **Сохраните файл:** `Ctrl+S` (Windows/Linux) или `Cmd+S` (Mac)
-<!-- TODO: Скриншот создания репозитория на GitHub -->
+<!-- TODO: Скриншот сохранения файла в VS Code -->
-7. Скопируйте URL вашего репозитория:
- ```
- https://github.com/ВАШ_ЛОГИН/my-second-brain.git
- ```
+### Шаг 6: Повторите для остальных файлов
----
+Повторите шаги 1-5 для каждого файла:
-## 1.5 Публикация в свой репозиторий
+**Для `1-yearly-2025.md`** — добавьте промпт:
+```
+Это шаблон годовых целей. На основе моего 3-летнего видения
+(которое мы только что заполнили) помоги поставить цели на 2025 год.
-1. В VS Code откройте Terminal: меню `View → Terminal` (или `Ctrl+``)
-2. Введите команду (замените URL на свой):
+Задавай вопросы по одному. Для каждой цели определи:
+- Чёткий измеримый результат
+- Первый конкретный шаг
+```
-```bash
-git remote set-url origin https://github.com/ВАШ_ЛОГИН/my-second-brain.git
+**Для `2-monthly.md`** — добавьте промпт:
```
+Это шаблон месячных приоритетов. Исходя из годовых целей,
+какие 3 главных приоритета на этот месяц?
-3. В левой панели нажмите на иконку с веткой (Source Control)
-4. Нажмите "+" рядом с "Changes" чтобы добавить все файлы
-5. В поле "Message" напишите: `Initial setup`
-6. Нажмите кнопку "Commit"
-7. Нажмите "Sync Changes" или "Publish Branch"
+Задавай вопросы по одному.
+```
-<!-- TODO: Скриншот коммита в VS Code -->
+**Для `3-weekly.md`** — добавьте промпт:
+```
+Это шаблон недельного плана. Самое важное — секция "ONE Big Thing".
+Это одна главная задача на неделю. Если сделаю только её — неделя успешна.
-Если спросит логин — введите свой GitHub логин и пароль (или Personal Access Token, если включена двухфакторка).
+Помоги определить ONE Big Thing на эту неделю. Задавай вопросы.
+```
-**Готово!** Проект теперь в вашем репозитории.
+**Не забывайте сохранять каждый файл после изменений: `Ctrl+S` / `Cmd+S`**
---
@@ -299,15 +372,14 @@ Deepgram транскрибирует голосовые сообщения. П
**Contabo (рекомендую):**
1. Зайдите на [contabo.com](https://contabo.com/en/vps/)
-2. Выберите "Cloud VPS S" (~$5/мес)
+2. Выберите "Cloud VPS S" ($4.96/мес)
3. Region: любой кроме Russia
4. ОС: Ubuntu 22.04
-5. Оплатите картой
+5. Оплатите картой (работает с белорусскими картами)
6. Получите на почту: IP-адрес и пароль root
-**Альтернативы:**
-- [OVH Starter](https://ovhcloud.com/en/vps/) — от $3/мес
-- [Hetzner Cloud](https://hetzner.cloud/) — от $4/мес
+**Альтернатива — OVH:**
+- [OVH Starter](https://ovhcloud.com/en/vps/) — $5/мес, тоже работает с белорусскими картами
<!-- TODO: Скриншот выбора VPS на Contabo -->
@@ -407,15 +479,15 @@ claude auth login
---
-## 3.5 Клонирование ВАШЕГО репозитория
+## 3.5 Клонирование вашего fork
```bash
cd ~
mkdir -p projects
cd projects
-# Замените URL на ВАШ репозиторий!
-git clone https://github.com/ВАШ_ЛОГИН/my-second-brain.git dbrain
+# Замените ВАШ_ЛОГИН на ваш логин GitHub!
+git clone https://github.com/ВАШ_ЛОГИН/agent-second-brain.git dbrain
cd dbrain
# Установка зависимостей
@@ -601,105 +673,22 @@ git config user.email "[email protected]"
### Сохранение токена
```bash
-git remote set-url origin https://ТОКЕН@github.com/ВАШ_ЛОГИН/my-second-brain.git
+git remote set-url origin https://ТОКЕН@github.com/ВАШ_ЛОГИН/agent-second-brain.git
```
Замените:
- `ТОКЕН` — ваш Personal Access Token
-- `ВАШ_ЛОГИН` — логин на GitHub
+- `ВАШ_ЛОГИН` — ваш логин на GitHub
Теперь сервер сможет пушить изменения автоматически.
---
-# Часть 4: Персонализация
-
-Самая важная часть! Бот использует ваши цели для приоритизации задач.
-
-## 4.1 Иерархия целей
-
-Система работает от большого к малому:
-
-```
-3-летнее видение (куда я иду?)
- ↓
-Годовые цели (что достичь за год?)
- ↓
-Месячные приоритеты (фокус этого месяца)
- ↓
-Недельный план (ONE Big Thing)
- ↓
-Ежедневные задачи (создаются автоматически)
-```
-
----
-
-## 4.2 Заполнение целей с помощью AI
-
-Рекомендую заполнять цели через диалог с Claude/ChatGPT — так получается глубже.
-
-### Видение на 3 года
-
-1. Откройте `vault/goals/0-vision-3y.md` в VS Code
-2. Откройте Claude или ChatGPT
-3. Напишите:
-
-```
-Ты мой персональный коуч. Помоги заполнить 3-летнее видение жизни.
-Задавай вопросы по одному, глубоко. Области:
-- Карьера и бизнес
-- Здоровье и энергия
-- Отношения и семья
-- Личностный рост
-- Финансы
-- Радость и хобби
-
-После каждого ответа — уточняющие вопросы.
-В конце сформируй заполненный документ.
-```
-
-4. Ответьте на вопросы
-5. Скопируйте результат в файл
-
-### Годовые цели
+# Часть 4: Дополнительная персонализация (опционально)
-Повторите процесс для `vault/goals/1-yearly-2025.md`:
-
-```
-На основе моего 3-летнего видения помоги поставить годовые цели на 2025.
-Вот моё видение: [вставьте содержимое 0-vision-3y.md]
-
-Для каждой цели определи:
-- Чёткий измеримый результат
-- Квартальные вехи
-- Первый конкретный шаг
-```
-
-### Месячные приоритеты
-
-Для `vault/goals/2-monthly.md`:
-
-```
-Исходя из годовых целей, какие 3 приоритета на этот месяц?
-Вот мои годовые цели: [вставьте]
-```
-
-### Недельный фокус
-
-Для `vault/goals/3-weekly.md`:
-
-```
-ONE Big Thing на эту неделю — если я сделаю только это,
-неделя будет успешной. Что это?
-
-Мои месячные приоритеты: [вставьте]
-```
-
-<!-- TODO: Скриншот заполненного weekly файла -->
-
----
+Если хотите, чтобы бот ещё лучше понимал ваш контекст.
-## 4.3 Настройка профиля
+## 4.1 Настройка профиля
Откройте `vault/.claude/skills/dbrain-processor/references/about.md` и заполните информацию о себе:
@@ -742,7 +731,7 @@ ONE Big Thing на эту неделю — если я сделаю только
---
-## 4.4 Настройка классификации
+## 4.2 Настройка классификации
Если хотите изменить, как бот классифицирует записи, отредактируйте:
@@ -876,7 +865,7 @@ ONE Big Thing на эту неделю — если я сделаю только
```bash
#!/bin/bash
-cd ~/Documents/my-second-brain # путь к вашему репозиторию
+cd ~/Documents/agent-second-brain # путь к вашему fork
git pull --rebase
git add -A
git commit -m "sync: $(date '+%Y-%m-%d %H:%M')" 2>/dev/null || true
@@ -899,7 +888,7 @@ crontab -e
1. Создайте файл `sync-brain.bat`:
```batch
-cd C:\Users\ВАШЕ_ИМЯ\Documents\my-second-brain
+cd C:\Users\ВАШЕ_ИМЯ\Documents\agent-second-brain
git pull --rebase
git add -A
git commit -m "sync: %date% %time%"
@@ -933,7 +922,7 @@ git push
**Сколько стоит в месяц?**
- Claude: $20
-- VPS: $4-5
+- VPS: ~$5 (Contabo $4.96 / OVH $5)
- Deepgram: бесплатно ($200 хватает на год+)
- **Итого: ~$25/мес**
@@ -987,7 +976,7 @@ cd ~/projects/dbrain
# Сохраните свои изменения
git stash
-# Получите обновления (замените URL на оригинальный репозиторий)
+# Получите обновления из оригинального репозитория
git remote add upstream https://github.com/smixs/agent-second-brain.git
git fetch upstream
git merge upstream/main