docs: reorganize into en/ and bg/ subfolders with numbered indices

- New docs/index.md with language selector
- docs/en/ — 01-getting-started, 02-architecture, 03-ai-integration,
  04-api-reference, 05-user-guide, 06-roadmap
- docs/bg/ — same structure in Bulgarian
- Root README.md trimmed to quick-start + links to docs/
- Removed old flat docs/ files (ARCHITECTURE.md, AI_FIRST.md, etc.)
- Added swap!/reset! examples to getting-started guides

docs/bg/index.md

@@ -0,0 +1,36 @@
+
+[← Към индекса](index.md)
+
+---
+
+# Clojure/Nim Документация (Български)
+
+> Диалект на Clojure, който се компилира до Nim → C → нативен бинарен файл.
+
+## Съдържание
+
+| # | Документ | Описание |
+|---|----------|----------|
+| 01 | [Първи стъпки](01-getting-started.md) | Инсталация, компилация, CLI команди, бързи примери |
+| 02 | [Архитектура](02-architecture.md) | Компилационен pipeline, дизайн решения, вътрешна структура |
+| 03 | [AI Интеграция](03-ai-integration.md) | DeepSeek, OpenAI, MiMo — помощ при грешки, генериране на код, оптимизация, дебъг |
+| 04 | [API Справочник](04-api-reference.md) | JSON REPL протокол, операции, tool-call формат |
+| 05 | [Ръководство](05-user-guide.md) | Макроси, threading, interop, напреднали шаблони |
+| 06 | [Пътна карта](06-roadmap.md) | Завършени фази, бъдещи планове, цели за перформанс |
+
+## Бърз старт
+
+```bash
+git clone https://gitlab.com/balvatar/lisp-nim.git
+cd lisp-nim
+make build
+make check        # компилация + тестове + примери
+./cljnim repl     # човешки REPL
+```
+
+## Статистика
+
+- **Тестове:** 276+ в 8 suite-а
+- **Компилатор:** Nim → C → нативен код
+- **Target-и:** Linux, macOS, Windows, JS, WASM, C shared libraries
+- **AI Поддръжка:** DeepSeek API, OpenAI-compatible, Xiaomi MiMo