Knowledge base

Структурированная библиотека знаний для проекта 15k. Сюда выгружаются идеи, концепции, разборы конкурентов, архитектурные решения и любой контекст, который может понадобиться повторно.

Отличие от MEMORY.md: MEMORY.md — рабочая память проекта (статус, открытые задачи, решения здесь и сейчас). Knowledge base — справочные материалы long-lived: концепции, разборы, паттерны.

Структура

knowledge/
├── concepts/         — переиспользуемые идеи и mental models
├── market/           — анализ рынка
│   ├── overview.md
│   ├── failures.md
│   ├── competitors/  — карточки конкурентов
│   └── regions/      — региональная специфика
├── positioning/      — наше позиционирование
├── architecture/     — технические паттерны и решения
├── reference/        — артефакты (промпты, конфиги, документы)
├── skills/           — поведенческие установки для меня (Claude)
├── algorithms/       — переиспользуемые алгоритмические паттерны
├── prompts/          — battle-tested промпты с примерами
├── digest/           — ежедневные дайджесты от news/repos collector'а (когда заработает)
└── inbox/            — сырые заметки до курации

Конвенции

Front matter (YAML, в начале каждого файла):

---
title: Короткое название
tags: [тэг1, тэг2]
source: где взято (опционально)
created: 2026-06-29
---

Wikilinks между файлами в Obsidian-стиле: [living-sops](/living-sops), [../market/competitors/pryon](/../market/competitors/pryon). Слаг = имя файла без расширения.

Имена файлов: kebab-case.md, на английском или транслитом (для cross-platform).

Размер: одна идея/одна сущность = один файл. Если файл вырастает за ~300 строк — разбивать.

Источники: если контент заимствован — указать в source: (путь в openclaw-dump/ или сессия). Если синтез — пометить synthesis: true.

Inbox

Если присылаешь что-то непереваренное (статья, цитата, ссылка) — кидай в inbox/. Я заберу, обработаю в нужный раздел, удалю из inbox.

Что уже есть (заполнено 29.06.2026)

concepts/

• concepts/umnaya-prokladka — твоя seed-идея про "умную прокладку между данными и LLM"
• concepts/process-intelligence-vs-mining — отличие от Celonis
• concepts/deterministic-on-exceptions — паттерн Kognitos: LLM только для интерпретации
• concepts/living-sops — 3-агентный цикл Kognitos (Builder/Execution/Resolution)
• concepts/enterprise-memory-layer — паттерн Pryon
• concepts/integrator-vs-builder — стратегия партнёрства с western вендорами
• concepts/pivot-history — как 15k превратился из scheduling-agent'а в Process Intelligence platform

market/

• market/overview — глобальная картина рынка AI-консалтинга 2026
• market/failures — провалы (Olive, Babylon, Adept, Inflection, Speechly) — что они учат
• market/competitors/pryon, market/competitors/kognitos, market/competitors/appliedai, market/competitors/goml, market/competitors/just-ai, market/competitors/napoleon-it, market/competitors/luminance
• market/regions/ksa-qatar, market/regions/ru-cis, market/regions/europe, market/regions/usa

positioning/

• positioning/vs-celonis — наш дифференциатор
• positioning/engineering-first — мантра от appliedAI

architecture/

• architecture/two-deployment-pattern — SaaS ↔ On-Prem через .env
• architecture/gemini-six-modules — архитектура из артефакта Gemini
• architecture/stack-decisions — стек intel-collector: что выбрано, почему, ссылки на доки и альтернативы (для не-инженера)

reference/

• reference/dartagnan-system-prompt — production system prompt d'Artagnan'а в Альфе
• reference/gemini-artifact-original — оригинальный артефакт от Gemini (для истории)

skills/ (мои поведенческие установки)

• skills/no-confabulation — не выдумывать, если данных нет — писать "не нашёл"
• skills/cite-sources — утверждения про факты должны иметь источник
• skills/verify-subagent-output — не пересказывать отчёты sub-агентов без spot-check
• skills/no-day-by-day-plans — Дима не принимает "Phase 0 день 1-2..."
• skills/read-docs-first — перед командами / тулколлами — читать документацию
• skills/no-max-length-on-llm-output — Pydantic max_length на LLM output = footgun (learned 2026-07-02 в intel-collector)

algorithms/ (паттерны)

• algorithms/llm-as-judge — LLM для оценки/ранжирования
• algorithms/fan-out-merge — параллельные запросы
• algorithms/loop-until-dry — поиск до исчерпания
• algorithms/deterministic-on-llm — разделение логики на code-узлы и LLM-узлы

prompts/

• prompts/structured-extractor — generic паттерн структурированного output
• prompts/tier-classifier-v1 — production classifier из intel-collector (Tier 1/2/3 + tags)
• prompts/scorer-v1 — production scorer из intel-collector (interest 0-10)

Что НЕ заполнено (на потом)

• Audio stack — детальный разбор WhisperX/Faster-Whisper/pyannote/Deepgram/NeMo — добавим когда зафиксируем решение
• Structured output — Pydantic/Instructor/LangGraph native — то же
• LangGraph patterns — best practices, anti-patterns — по мере накопления опыта
• Подробные регионы (отдельные карточки по Saudi/Qatar/UAE) — текущие region/* — это сводки
• Compétiторы второго эшелона — добавлять когда встречаем

Как пополнять

1. Ты присылаешь: "вот статья / вот идея / вот цитата"
2. Я: решаю в какой раздел, кладу файл с frontmatter и citation, обновляю этот README в секции "Что уже есть", создаю wikilinks к связанному
3. Если контекст разрастается — выделяю в отдельный раздел/файл