soul.md
aaronjmars/soul.mdИнструмент для построения «души» AI-агента на основе ваших текстов, твитов и заметок. Claude Code анализирует данные, извлекает голос и мировоззрение, генерирует markdown-файлы, которые любой LLM может загрузить и писать в вашем стиле.
Установка
git clone https://github.com/aaronjmars/soul.md.gitREADME
Что это такое?
Файл души фиксирует, кто вы есть, в формате, который AI-агенты могут воплощать. Не чат-бот, который рассказывает о вас — AI, который думает и говорит как вы.
Сложите свои твиты, эссе и посты в папку. Агент прочитает всё, извлечёт ваше мировоззрение и голос, и создаст набор markdown-файлов, которые любой LLM сможет загрузить, чтобы писать как вы.
Цель: человек, читающий ваш SOUL.md, должен уметь предсказывать вашу реакцию на новые темы. Если не может — файл слишком расплывчатый.
Сценарии использования:
- Генерировать идеи исходя из вашего мировоззрения
- Создавать контент (твиты, статьи, письма), звучащий как вы
- Адаптировать AI под ваши интересы и паттерны мышления
- Масштабировать себя для контента, ответов, мозговых штурмов
Быстрый старт
Вариант 1 — Построить с нуля
/soul-builder
Агент проводит интервью: мировоззрение, мнения, стиль письма, что для вас важно.
Вариант 2 — Построить из ваших данных
Поместите контент в data/:
data/x/ ← экспорт Twitter/X
data/writing/ ← посты в блоге, эссе
Затем запустите /soul-builder. Агент анализирует данные, извлекает паттерны и создаёт черновик файла души. Вы вместе просматриваете и дорабатываете его.
Вариант 3 — Вручную
Скопируйте шаблоны и заполните их:
SOUL.template.md → SOUL.md
STYLE.template.md → STYLE.md
SKILL.template.md → SKILL.md
Лучше всего использовать с Aeon
Aeon — автономный агент на GitHub Actions, работающий на Claude Code. 68 скиллов для исследований, инструментов разработки, мониторинга крипты и продуктивности — всё работает в фоне по расписанию cron.
Файлы души напрямую встраиваются в Aeon. Скопируйте свою душу в папку soul/ в репозитории Aeon, добавьте несколько строк в CLAUDE.md — и каждый скилл, который запускает Aeon (статьи, дайджесты, твиты, исследовательские брифы), будет написан вашим голосом. Никакой настройки на уровне отдельных скиллов. Идентичность распространяется автоматически.
Почему это сочетание работает:
- Aeon управляет когда и что — расписание, исследования, мониторинг, генерация контента
- Файлы души управляют кто — голос, мировоззрение, мнения, стиль
- Вместе вы получаете фонового агента, который не просто работает на вас — он звучит как вы
Настройка занимает 2 минуты. Подробности — в разделе Soul документации Aeon.
Источники данных
Передайте билдеру всё, что вы когда-либо писали. Чем больше сигнала — тем точнее результат.
| Категория | Платформы |
|---|---|
| Социальные сети | Twitter/X, Bluesky, Farcaster, Mastodon, Threads, LinkedIn, Reddit |
| Тексты | Substack, Medium, Ghost, WordPress, Mirror.xyz, Paragraph.xyz |
| Мессенджеры | Discord, Telegram, Slack, экспорт iMessage |
| Заметки | Notion, Obsidian, Roam Research, Logseq, Apple Notes |
| Видео/Аудио | транскрипты YouTube, транскрипты подкастов, записи Loom |
| Код/Разработка | активность на GitHub, комментарии на Hacker News, ответы на Stack Overflow |
| Прочее | PDF, plain text, CSV/JSON, RSS-ленты, GDPR-экспорты данных |
Нет существующих данных? Вариант 1 (режим интервью) всё равно создаёт полноценный файл души с нуля.
Совместимые фреймворки
Файлы души — это обычный markdown: если агент умеет читать файлы, он может воплощать вас. Протестировано с:
| Фреймворк | Язык | Звёзды |
|---|---|---|
| Aeon | YAML/Markdown | — |
| OpenClaw | TypeScript | 322k |
| Nanobot | Python | 34.6k |
| ZeroClaw | Rust | 27.8k |
| PicoClaw | Go | 25.3k |
| NanoClaw | TypeScript | 24k |
| OpenFang | Rust | 14.9k |
| IronClaw | Rust | 10.4k |
| Hermes Agent | Python | 8.7k |
| Claude Code · OpenCode · Codex · Goose | различные | — |
Также работает с любой моделью через системный промпт — см. раздел Использование с другими инструментами.
Структура файлов
your-soul/
├── SOUL.md ← Кто вы (идентичность, мировоззрение, мнения)
├── STYLE.md ← Как вы пишете (голос, синтаксис, паттерны)
├── SKILL.md ← Режимы работы (твит, эссе, чат и т.д.)
├── MEMORY.md ← Память сессий для непрерывности между разговорами
├── data/ ← Исходные материалы
│ ├── writing/
│ ├── x/
│ └── influences.md
└── examples/
├── good-outputs.md
└── bad-outputs.md
Что делает файл души хорошим
| Хорошо | Плохо |
|---|---|
| «Я считаю, что большинство дискуссий об AI safety — это galaxy-brained cope» | «У меня нюансированные взгляды на AI» |
| «Я по умолчанию сначала не соглашаюсь, потом ищу стальной аргумент» | «Мне нравится рассматривать разные точки зрения» |
| Конкретные ссылки на книги, названные источники влияния | «Я много читаю» |
| Реальные острые мнения с обоснованием | «Я стараюсь быть сбалансированным» |
У реальных людей бывают противоречивые взгляды. Включайте противоречия — именно они делают вас узнаваемым.
Использование вашей души
После создания вызовите свою душу:
/soul
Или укажите любому LLM на вашу папку и попросите прочитать:
SOUL.md— идентичностьSTYLE.md— голосMEMORY.md— недавний контекстexamples/— калибровкаdata/— основа при необходимости
Значимые события добавляются в MEMORY.md, обеспечивая непрерывность вашей души между сессиями.