{"id":50711260,"url":"https://github.com/chelslava/agent-knowledge-base","last_synced_at":"2026-06-09T15:30:51.681Z","repository":{"id":362693046,"uuid":"1260390925","full_name":"chelslava/agent-knowledge-base","owner":"chelslava","description":"Долговременная память для ИИ-агентов: Markdown-база знаний с локальным кросс-язычным семантическим поиском, контрактом AGENTS.md и интеграцией с Claude Code. Local-first, no API keys.","archived":false,"fork":false,"pushed_at":"2026-06-05T13:03:18.000Z","size":57,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-06-05T14:23:11.257Z","etag":null,"topics":["ai-agents","claude-code","knowledge-base","llm","local-first","long-term-memory","markdown","obsidian","second-brain","semantic-search"],"latest_commit_sha":null,"homepage":null,"language":"PowerShell","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/chelslava.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":"AGENTS.md","dco":null,"cla":null}},"created_at":"2026-06-05T12:51:43.000Z","updated_at":"2026-06-05T13:03:22.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/chelslava/agent-knowledge-base","commit_stats":null,"previous_names":["chelslava/agent-knowledge-base"],"tags_count":null,"template":true,"template_full_name":null,"purl":"pkg:github/chelslava/agent-knowledge-base","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/chelslava%2Fagent-knowledge-base","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/chelslava%2Fagent-knowledge-base/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/chelslava%2Fagent-knowledge-base/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/chelslava%2Fagent-knowledge-base/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/chelslava","download_url":"https://codeload.github.com/chelslava/agent-knowledge-base/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/chelslava%2Fagent-knowledge-base/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":34114426,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-06-09T02:00:06.510Z","response_time":63,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["ai-agents","claude-code","knowledge-base","llm","local-first","long-term-memory","markdown","obsidian","second-brain","semantic-search"],"created_at":"2026-06-09T15:30:50.879Z","updated_at":"2026-06-09T15:30:51.673Z","avatar_url":"https://github.com/chelslava.png","language":"PowerShell","funding_links":[],"categories":[],"sub_categories":[],"readme":"# 🧠 agent-knowledge-base\n\n\u003e [!NOTE]\n\u003e \u003cimg src=\"https://flagcdn.com/24x18/ru.png\" alt=\"RU\" width=\"22\" align=\"top\"\u003e **TL;DR.** Долговременная память для ИИ-агентов — самодостаточный каркас базы\n\u003e знаний на Markdown с локальным семантическим поиском (без облака и API-ключей) и\n\u003e протоколом работы для Claude Code, Cursor, Gemini CLI, Aider и др.\n\n[![Use this template](https://img.shields.io/badge/Use%20this%20template-2ea44f?logo=github\u0026logoColor=white)](https://github.com/chelslava/agent-knowledge-base/generate)\n[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)\n![Markdown](https://img.shields.io/badge/format-Markdown-083fa1)\n![Local-first](https://img.shields.io/badge/search-local%20%C2%B7%20no%20API%20keys-2ea44f)\n![Cross-lingual](https://img.shields.io/badge/embeddings-bge--m3%20(RU%2FEN)-blue)\n\n\u003e [!NOTE]\n\u003e \u003cimg src=\"https://flagcdn.com/24x18/gb.png\" alt=\"EN\" width=\"22\" align=\"top\"\u003e **TL;DR (English).** A drop-in, file-based long-term memory for AI coding\n\u003e agents. Markdown notes + Obsidian-style `[[wikilinks]]` + a controlled taxonomy,\n\u003e governed by a single contract file (`AGENTS.md`) every agent reads first. Ships\n\u003e with local, cross-lingual semantic search (via\n\u003e [md-semantic-search](https://github.com/chelslava/md-semantic-search), runs\n\u003e fully offline) to prevent duplicate notes, document templates for projects, and\n\u003e an optional auto-commit hook so your knowledge stays versioned. Clone, point\n\u003e your agent at it, done. Docs below are in Russian.\n\n---\n\n## Зачем это нужно\n\nИИ-агенты теряют контекст между сессиями и проектами. Эта база — **единый\nвнешний «мозг»**: накопленные решения, паттерны, архитектура и грабли живут в\nобычных Markdown-файлах, которые агент читает **перед** задачей и пополняет\n**после**. Никакой векторной БД в облаке, никаких API-ключей — всё считается\nлокально на вашей машине.\n\nКлючевая идея: **один контракт-файл `AGENTS.md`**, который любой агент читает\nпервым, задаёт правила игры — куда складывать знания, как связывать, как искать\nперед созданием заметки, чтобы не плодить дубликаты.\n\n## Что внутри (что сделано и для чего)\n\n| Компонент | Что это | Зачем |\n|-----------|---------|-------|\n| **`AGENTS.md`** | Главный контракт для агентов | Единые правила: читается первым в любой сессии |\n| **`knowledge-rules.md`** | Детальные правила управления знаниями | Single Source of Truth, антидубликат-протокол, связи |\n| **`taxonomy.md`** | Контролируемый словарь тегов | Знания остаются связными и находимыми |\n| **`index.md`** | Карта базы знаний | Главная точка входа, поддерживается агентами |\n| **`CHANGELOG.md`** | Журнал изменений базы | История знаний по [Keep a Changelog](https://keepachangelog.com/ru/) |\n| **`templates/`** | 13 шаблонов документации | Единый формат для проектов (overview, ADR, архитектура, API…) |\n| **`projects/`** | Документация по проектам + реестр | Структурированная память по каждому проекту |\n| **`shared/`** | Переиспользуемые знания | Паттерны/рецепты/гайды — один источник на все проекты |\n| **`inbox/`** | Входящие, черновики | Зона разбора сырья перед оформлением |\n| **`semantic/`** | Локальный семантический поиск | Кросс-язычный (RU↔EN) поиск перед созданием заметки |\n| **`tools/`** | Авто-коммит хук | База всегда версионируется в git без ручных коммитов |\n\n### Принципы, заложенные в каркас\n\n- **Single Source of Truth.** Одна тема — один канонический документ\n  (`canonical: true`); остальное ссылается через `[[wikilink]]`, текст не копируется.\n- **Антидубликат-протокол.** Перед созданием заметки — **семантический поиск**.\n  Тема уже покрыта → дополняем существующий документ, а не плодим новый.\n- **Obsidian-совместимость.** Связи через `[[...]]`, YAML-frontmatter, иерархичные\n  теги — базу можно открыть в [Obsidian](https://obsidian.md/) как vault.\n- **Локальность и приватность.** Эмбеддинги (`bge-m3`, 1024d) считаются офлайн;\n  индекс и кэш моделей не коммитятся.\n\n## Структура репозитория\n\n```\nagent-knowledge-base/\n├── AGENTS.md                 # 📜 главный контракт для ИИ-агентов (читается первым)\n├── knowledge-rules.md        # 📐 детальные правила управления знаниями\n├── index.md                  # 🗺️ карта базы знаний\n├── taxonomy.md               # 🏷️ контролируемый словарь тегов\n├── CHANGELOG.md              # 📜 журнал изменений\n├── inbox/                    # 📥 входящие/черновики (зона разбора)\n├── shared/                   # 🌐 переиспользуемые знания (паттерны, рецепты, гайды)\n├── projects/                 # 📦 документация проектов + projects-registry.md\n├── templates/                # 🧩 13 шаблонов документов\n├── semantic/                 # 🔎 семантический поиск (md-semantic-search)\n│   ├── kb-index.{ps1,sh}     #    индексация (обёртки, модель bge-m3)\n│   ├── kb-search.{ps1,sh}    #    поиск\n│   ├── kb-reindex-task.ps1   #    раннер авто-переиндексации (Task Scheduler)\n│   ├── install-task.ps1      #    установка задачи планировщика (Windows)\n│   └── mdss.env.example      #    пример env-переменных\n├── tools/\n│   └── kb-autocommit.{ps1,sh}# 🤖 автокоммит базы через Stop-hook агента\n├── docs/\n│   ├── SETUP.md              # установка и запуск\n│   └── AGENT-INTEGRATION.md  # интеграция с Claude Code (CLAUDE.md + хук)\n└── LICENSE                   # MIT\n```\n\n## Быстрый старт\n\n\u003e Подробности — в [`docs/SETUP.md`](docs/SETUP.md).\n\n**1. Клонировать**\n\n```bash\ngit clone https://github.com/chelslava/agent-knowledge-base.git\ncd agent-knowledge-base\n```\n\n**2. Поставить движок поиска** (Node ≥ 18; первый запуск скачает модель `bge-m3` ~2.3 ГБ)\n\n```bash\nnpm install -g md-semantic-search   # даёт команды mdss / md-semantic-search\n```\n\n**3. Построить индекс и проверить поиск**\n\n```powershell\n# Windows / PowerShell\npwsh semantic/kb-index.ps1\npwsh semantic/kb-search.ps1 \"правила оформления заметок\"\n```\n\n```bash\n# POSIX / bash\nbash semantic/kb-index.sh\nbash semantic/kb-search.sh \"правила оформления заметок\"\n```\n\n**4. Подключить агента.** Дайте агенту прочитать `AGENTS.md` первым.\nДля Claude Code — см. [`docs/AGENT-INTEGRATION.md`](docs/AGENT-INTEGRATION.md)\n(глобальный блок в `CLAUDE.md` + авто-коммит через Stop-hook).\n\n## Как с этим работать (рабочий цикл)\n\n1. **Перед задачей** — читать документацию проекта и `shared/`, выполнить\n   семантический поиск (`kb-search`).\n2. **Создавая заметку** — взять шаблон из `templates/`, заполнить frontmatter,\n   проставить `[[ссылки]]`.\n3. **После изменений** — обновить `index.md`, `CHANGELOG.md`, `taxonomy.md`\n   (агент делает это по контракту; авто-коммит фиксирует в git).\n4. **Новый проект** — зарегистрировать в `projects/projects-registry.md`,\n   скопировать набор шаблонов в `projects/\u003cname\u003e/`.\n\n## Семантический поиск\n\nДвижок — [md-semantic-search](https://github.com/chelslava/md-semantic-search)\n(CLI `mdss`, на `@xenova/transformers`). Работает **локально, без API-ключей**,\nподдерживает **кросс-язычный** поиск: запрос на русском находит документ на\nанглийском и наоборот. Модель этой базы — `bge-m3` (закреплена в обёртках\n`kb-index.*`). Полная справка — в [`semantic/README.md`](semantic/README.md).\n\n## Совместимость\n\n- **Агенты:** Claude Code, Cursor, Gemini CLI, Aider, OpenCode, Roo Code и любой,\n  кто умеет читать `AGENTS.md`.\n- **ОС:** Windows (PowerShell-обёртки + Task Scheduler) и POSIX (bash-обёртки).\n- **Редакторы знаний:** Obsidian (vault), VS Code, любой Markdown-редактор.\n\n## Благодарности\n\nСемантический поиск — [md-semantic-search](https://github.com/chelslava/md-semantic-search).\nСоглашения: [Keep a Changelog](https://keepachangelog.com/),\n[Architecture Decision Records](https://adr.github.io/),\n[Obsidian](https://obsidian.md/).\n\n## Лицензия\n\n[MIT](LICENSE).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fchelslava%2Fagent-knowledge-base","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fchelslava%2Fagent-knowledge-base","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fchelslava%2Fagent-knowledge-base/lists"}