ТЗ для агента: LLM Wiki страница для trip2g.com

Дата: 2026-05-03 12:27 UTC

Главный вывод

Нужно сделать отдельную документационно-маркетинговую страницу Trip2G про LLM Wiki для агентов.

Страница должна объяснять не только “что такое LLM Wiki”, а почему Trip2G — подходящий operational layer для такого подхода:

The wiki is the artifact, not the chat.
Trip2G makes that artifact readable, editable and navigable by agents through MCP.

Owner

Owner: другой агент или автор проекта.
Reviewer: автор Trip2G.
Status: ready for implementation.
Priority: P0/P1 — высокий приоритет, потому что эта страница соединяет Karpathy-style LLM Wiki, MCP и Trip2G positioning.

Где разместить

Варианты URL:

/llm-wiki
/llm-wiki-for-agents
/docs/llm-wiki
/en/user/llm-wiki

Рекомендация:

/llm-wiki-for-agents

Если это часть документации, то:

en/user/llm-wiki.md

Цель страницы

После чтения пользователь должен понять:

LLM Wiki — это не чат и не просто RAG.
LLM Wiki — это durable markdown/wiki artifact, который накапливает знания.
Trip2G умеет хранить такую базу как markdown/Obsidian vault.
Trip2G даёт MCP-доступ к базе.
В базе могут лежать инструкции агентам: instructions(), schema(), optional initialize().
Агент может ходить по index.md и wikilinks, а может использовать search/RAG.
Выбор стратегии задаётся самой базой знаний.
Базы могут ссылаться друг на друга и превращаться в knowledge network.

Вводные источники

Использовать как контекст:

Karpathy gist про LLM Wiki: https://gist.github.com/karpathy/442a6bf555914893e9891c11519de94f
Исследование trip2g/16 - Лендинг Trip2G под LLM Wiki
Исследование trip2g/17 - Инструкция для Trip2G LLM Wiki базы
Исследование trip2g/18 - Инструкция для внешнего агента - первый бесплатный инстанс
Trip2G engine docs MCP: http://trip2g.com/_system/mcp

Перед изменениями агент должен подключить/прочитать Trip2G docs через MCP и проверить актуальные названия методов:

instructions()
schema() — dynamic method через mcp_method
initialize() — optional dynamic method
search()
note_html()
similar()

Структура страницы по пирамиде Минто

1. Hero / Answer first

# Build an LLM Wiki your agents can actually use

Trip2G turns a markdown/wiki knowledge base into an MCP-accessible artifact for Claude, Cursor, Codex and other agents.

Use RAG when the base is large. Use index-first traversal when the wiki is curated. Store the retrieval strategy inside the base itself.

CTA:

Create a free Trip2G instance
Connect the MCP server
See the starter LLM Wiki template

2. Problem

## Chats forget. RAG re-assembles. Wikis compound.

Agents often rediscover the same context every session.
RAG can retrieve chunks, but useful synthesis disappears back into the chat.
An LLM Wiki keeps the synthesis as a durable artifact.

3. The Trip2G answer

## Trip2G is the operational layer for LLM Wikis

A Trip2G base can contain:

- markdown pages;
- sources and provenance;
- `index.md` as the map;
- `log.md` as the history;
- `AGENTS.md` as behavior instructions;
- `SCHEMA.md` as the page/update schema;
- MCP methods exposed from notes;
- search/RAG and wikilink traversal policies.

4. Two retrieval modes

## Two ways for agents to read the wiki

### Mode A — Index-first traversal

Use this for curated or small/medium bases:

Question → read `index.md` → open relevant pages → follow wikilinks → answer with citations.

### Mode B — Search/RAG-assisted retrieval

Use this for large, messy or exact-match bases:

Question → `search(query)` → inspect matches/TOC → `note_html()` → follow wikilinks → verify sources → answer.

The base should tell the agent which mode to prefer.

5. Instructions are part of the base

## The wiki tells agents how to use it

Trip2G can expose instruction pages as MCP tools.

`AGENTS.md`:

```yaml
---
free: true
mcp_method: instructions
mcp_description: "How agents should use this knowledge base."
---

SCHEMA.md:

---
free: true
mcp_method: schema
mcp_description: "Page types, frontmatter and update rules for this LLM Wiki."
---

Optional _mcp_initialize.md:

---
free: true
mcp_method: initialize
mcp_description: "Start a session with this knowledge base."
---


### 6. Starter structure

```markdown
## Starter LLM Wiki structure

```text
llm-wiki/
├── _index.md
├── AGENTS.md
├── SCHEMA.md
├── _mcp_initialize.md
├── index.md
├── log.md
├── raw/
├── sources/
├── concepts/
├── queries/
├── comparisons/
└── decisions/


### 7. Federation / network

```markdown
## From one wiki to a network of knowledge bases

A Trip2G base can describe another knowledge base.
When an agent finds that note, it can query the linked base through MCP/federation.
A hub can search across many bases and proxy the question to the right one.

This is how personal, team and public knowledge bases can grow into a distributed knowledge network.

8. What to try first

## Try it in 10 minutes

1. Create a free Trip2G instance.
2. Download the starter vault archive.
3. Add one idea/source as markdown.
4. Add `AGENTS.md`, `SCHEMA.md`, `index.md`, `log.md`.
5. Connect the MCP endpoint.
6. Ask your agent: “Read index.md and explain what this base knows.”

Обязательные технические детали

Агент должен проверить и корректно описать:

mcp_method: instructions — канонический способ expose AI instructions.
mcp_description — описание для tools/list.
Dynamic methods: публичные заметки с free: true и mcp_method становятся callable tools.
SCHEMA.md может быть exposed как schema().
_mcp_initialize.md может быть exposed как initialize().
search() возвращает результаты/TOC/matches.
note_html() может доставать полную заметку или секцию через TOC path, если поддерживается.
Federation/proxying описывать только если подтверждено актуальными docs.

Что не делать

Не писать “RAG is dead”.
Не противопоставлять RAG и LLM Wiki как взаимоисключающие.
Не обещать магический autonomous reasoning без provenance.
Не прятать, что нужны index.md, log.md, instructions и дисциплина обновления.
Не делать страницу слишком академичной; цель — first activation.

Acceptance criteria

Страница готова, если:

первый экран объясняет ценность за 10 секунд;
есть два retrieval mode: index-first и RAG/search;
есть пример frontmatter для AGENTS.md, SCHEMA.md, _mcp_initialize.md;
есть starter folder structure;
есть 10-minute quickstart;
есть CTA на free instance;
есть аккуратное объяснение federation/knowledge network;
все технические claims проверены по Trip2G docs/MCP;
есть ссылки на relevant docs;
страница не выглядит как “ещё один RAG продукт”, а как operational layer для LLM Wiki.

Suggested first PR

Создать en/user/llm-wiki.md.
Добавить ссылку в docs sidebar.
Добавить 3 стартовых шаблона:
- AGENTS.md;
- SCHEMA.md;
- _mcp_initialize.md.
Добавить ссылку на страницу из главного лендинга или блока “Use cases”.
После публикации проверить через MCP, что страница находится поиском.