# knowlib

Open-source библиотека структурированных знаний, доставляемая LLM-агентам
через MCP-протокол. Каждый knowledge-домен — маленький IDP со стандартной
анатомией: манифест + core-концепты + patterns + examples (auto-tested) +
cross-references в другие домены.

**Не replace Wikipedia** — LLM-optimized layer поверх canonical sources:
атомарные концепты, машиночитаемый граф, авто-тесты примеров, semver.

## Статус

🚧 Phase 0 · Scaffold. Читай [`ROADMAP.md`](./ROADMAP.md).

## Domains (планируются)

- **`programming/`** — languages · paradigms · architecture · data-structures · algorithms · systems
- **`electronics/`** — analog · digital · microcontrollers · pcb · signals
- **`economics/`** — micro · macro · behavioral · finance · game-theory
- **`math/`** — calculus · linear-algebra · discrete · statistics
- **`physics/`** — mechanics · em · quantum · thermo
- **`chemistry/`** · **`biology/`** · **`...`**

Каждый домен = отдельный IDP. Разработчики могут форкать один домен или
контрибьютить в существующий по единой схеме.

## Anatomy домена

```
domains/programming/algorithms/recursion/
├── manifest.json       # {name, version, prereqs[], examples[], sources[]}
├── README.md           # концепт как markdown (frontmatter + body)
├── examples/           # runnable snippets (auto-tested)
├── decisions/          # ADR — почему именно эта формулировка
└── cross-refs.json     # мосты в другие домены (math/induction, ...)
```

## Usage через MCP

```
know.search(query, domain?, difficulty?)
know.explain(concept)                     → full text + prereqs + examples
know.related(concept)                     → граф neighbours
know.learn_path(from, to)                 → sequence концептов A→B
know.example(concept, lang?)              → runnable snippet
know.crossdomain(concept)                 → мосты в другие области
```

Prod endpoint: **`https://mcp.know.uamcp.com/mcp`** (после Phase 1).
Public site (browsing): **`https://know.uamcp.com`** (после Phase 2).

## Contribute

Каждый новый концепт = PR по [template-domain/](./template-domain/) схеме.
Schema-validated в CI. Подробно — [`CONTRIBUTING.md`](./CONTRIBUTING.md).

## Licenses

- **Code** (engine, mcp-server, tooling) — Apache 2.0 · [`LICENSE`](./LICENSE)
- **Content** (docs/, domains/) — CC-BY-4.0 · [`LICENSE-content`](./LICENSE-content)

Attribution required. Commercial use OK. LLM training OK. Forks OK.

## Roadmap

- **Phase 0** (сейчас) — каркас + schema + 1 seed-концепт (`recursion`)
- **Phase 1** — MCP-server MVP, 30-50 концептов в `programming/`
- **Phase 2** — Astro browse UI + electronics/economics
- **Phase 3** — публичный launch (blog + HN), community contributions