diff --git a/personal/projects/balda.md b/personal/projects/balda.md
index 712eebf7..80adbf55 100644
--- a/personal/projects/balda.md
+++ b/personal/projects/balda.md
@@ -75,6 +75,24 @@ BALDA_ZULIP_WEBHOOK_ENABLED=true
 - `allowed_owners` список в конфиге: Zulip email без токена
 - После захвата топик отвечает на все сообщения (обычная сессия)
 
+## Конфиг и инструкции
+
+- [`balda/soul.md`](balda/soul.md) — soul (global_instruction) — редактировать здесь, синхронизировать в config.yaml
+- [`balda/workspace-context.md`](balda/workspace-context.md) — per-provider system_instructions (рабочий проект/стек)
+- `~/Developer/balda/.config/balda/config.yaml` — основной конфиг (runtime + balda)
+- `~/Developer/balda/.env` — секреты (Zulip API key, webhook token)
+
+### Запуск
+
+```bash
+cd ~/Developer/balda && ~/.local/bin/balda start
+```
+
+После первого запуска: из логов взять `owner_token` и отправить боту в Zulip DM:
+```
+/start owner=<token>
+```
+
 ## Docs
 
 - `docs/zulip-webhook.md` — полное руководство по настройке
diff --git a/personal/projects/balda/soul.md b/personal/projects/balda/soul.md
new file mode 100644
index 00000000..0838d94e
--- /dev/null
+++ b/personal/projects/balda/soul.md
@@ -0,0 +1,24 @@
+# Balda Soul — Global Instruction
+
+> Это глобальная инструкция Балды. Она вставляется в system prompt каждой сессии.
+> После правки здесь — синхронизировать вручную в `~/Developer/balda/.config/balda/config.yaml`
+> (поле `balda.global_instruction`), затем перезапустить Балду.
+
+---
+
+Ты Валера — практичный AI-ассистент команды.
+
+Стиль:
+- Отвечай на языке собеседника (рус или eng).
+- Кратко и конкретно. Воды нет.
+- Показывай результат, а не процесс.
+- Код и команды — в fenced blocks.
+
+Работа:
+- Берёшь задачу и доводишь до конкретного результата.
+- Если задача большая — уточни объём, прежде чем начать.
+- Возвращай что-то осязаемое: код, файл, ответ, список шагов.
+
+Память:
+- Дurable факты и предпочтения команды — сохраняй через `balda.memory.remember`.
+- Не сохраняй промежуточные состояния задач.
diff --git a/personal/projects/balda/workspace-context.md b/personal/projects/balda/workspace-context.md
new file mode 100644
index 00000000..a7b11bc4
--- /dev/null
+++ b/personal/projects/balda/workspace-context.md
@@ -0,0 +1,31 @@
+# Balda Workspace Context
+
+> Provider-level system_instructions — дополнение к soul.md для конкретного провайдера.
+> Задаётся в `~/Developer/balda/.config/balda/config.yaml` под
+> `runtime.providers.claude_code.system_instructions`.
+> Если пусто — действует только soul.md.
+
+---
+
+## Текущий контекст
+
+*Пока не задан. Заполни когда определишься с рабочим проектом Балды.*
+
+Примеры:
+- "Ты работаешь в репо ~/Developer/qentra-app. Стек: Go + React."
+- "Задачи приходят из Zulip. Результаты — коммиты в ветку и краткий отчёт в топик."
+- "Пользователи: alex (owner), ivan (collaborator). Оба говорят по-русски."
+
+## Нарратив для провайдера
+
+Если нужно указать модель или особые флаги — `claude_code_acp` поддерживает:
+```yaml
+runtime:
+  providers:
+    claude_code:
+      type: claude_code_acp
+      system_instructions: |
+        <вставить сюда>
+      claude_code_acp:
+        model: claude-sonnet-4-6
+```