1. GitHub README сильнее и яснее многих docs-страниц

README сразу формулирует продукт:

Open-source MCP knowledge mesh. Self-host your knowledge bases, expose them to AI agents via MCP, and federate with peers — no SaaS in the middle.

Плюсы:

• есть MIT/open-source;
• есть “Try it now”;
• есть JSON-конфиг MCP;
• есть схема “human → agent → hub”;
• есть self-host CTA;
• есть понятный контраст с Obsidian Publish / Quartz.

Минус: даже README начинает с термина MCP knowledge mesh. Для GitHub-аудитории это приемлемо, но для лендинга лучше сначала дать результат, потом термин.

2. Лендинг уже двигается в правильном направлении

На https://trip2g.com/ сильный первый экран:

Add this to your agent. Then ask it anything about trip2g — faster than reading this page.

Это хороший AI-native onboarding: не читать лендинг, а подключить MCP и спросить агента.

Сильные элементы:

• mcp:add https://trip2g.com/_system/mcp;
• “Your second brain was always meant to be shared”;
• “your data stays yours”;
• “open source · self-host or sandbox”;
• “try now · 5 minutes · no install”.

Проблема: первый экран слишком концептуальный. Он может хорошо работать на early adopters, но хуже отвечает на базовый вопрос: “что это за штука и зачем мне GitHub star?”

3. LLM Wiki страница очень близка к нужному позиционированию

https://trip2g.com/en/user/llm_wiki — одна из лучших страниц для нового positioning.

Сильная формула:

The wiki is the artifact, not the chat.

И дальше:

Trip2G turns a markdown knowledge base into an MCP-accessible artifact that Claude, Cursor, Codex, and other agents can read, navigate, and update.

Это почти идеальная формулировка для “living library for AI agents”. Её стоит поднять выше — на лендинг, docs index и README.

4. Onboarding в /en/user/getting_started понятный и безопасный

Хорошо:

• прямо объяснено, что все заметки private by default;
• рекомендуется test vault;
• шаги установки BRAT и sync plugin конкретные;
• есть первый результат: _index, sync, free: true, title.

Это полезный quickstart для “Obsidian → website”.

1. /docs и /en/user выглядят как каталог фич, а не как путь к ценности

https://trip2g.com/docs сейчас группирует много направлений:

• Начало работы;
• Telegram;
• Use cases;
• AI и интеграции;
• Кастомизация;
• Дополнительно;
• Философия.

Проблема: если Trip2G сейчас нужно позиционировать как “living library for AI agents”, то docs index должен вести пользователя по пути:

1. Что такое Trip2G.
2. Подключить demo MCP.
3. Создать свою живую библиотеку.
4. Синхронизировать Markdown/Obsidian.
5. Подключить AI-агента.
6. Дальше: federation, webhooks, Telegram, monetization, templates.

Сейчас “MCP-сервер” — один пункт в середине раздела “AI и интеграции”, а “LLM Wiki” есть только в English docs. Главная ценность не доминирует.

2. /docs/onboarding смешивает несколько onboarding-сценариев

Русский onboarding начинается хорошо:

Войти на сайт через email → Установить плагин → Создать первую заметку.

Но дальше быстро расширяется до:

• draft versions;
• timezone;
• admin panel navigation;
• plugin install;
• first note;
• Telegram bot;
• preview channel;
• scheduling;
• tags;
• troubleshooting.

Для quickstart это слишком много. Пользователь, который пришёл за “живой библиотекой для агента”, теряет фокус в Telegram-настройках.

Рекомендация: разделить на 3 quickstart-а:

• Quickstart A: Ask the demo knowledge base with your agent — 2 minutes.
• Quickstart B: Publish your first Markdown/Obsidian note — 10 minutes.
• Quickstart C: Turn your notes into an AI-readable library — 15 minutes.
• Telegram вынести в отдельный “Publish to Telegram” flow.

3. /dev/mcp выглядит как internal implementation plan

https://trip2g.com/dev/mcp содержит:

• JSON-RPC примеры;
• frontmatter;
• затем “План имплементации”, “Story 1”, “Story 2”, internal/case/mcp, Go structs.

Это производит впечатление незавершённой внутренней спеки, а не user docs. Для публичного позиционирования это риск.

Лучше:

• переименовать или скрыть /dev/mcp из основного docs index;
• оставить как “Implementation notes / legacy spec”;
• основной user-facing MCP doc — https://trip2g.com/en/user/mcp.

4. Термины появляются раньше результата

Частые термины:

• MCP;
• MCP federation;
• knowledge mesh;
• subgraph;
• Contentless CMS;
• knowledge graph;
• HMAC;
• GraphQL admin tools;
• vector search;
• reciprocal rank fusion;
• frontmatter patches;
• Jet templates.

Они важны, но как “second layer”. Главная ценность должна быть проще:

Your notes become a library your AI agent can search, read, cite, and update.

Только после этого:

• “Under the hood: MCP endpoint.”
• “For teams: federation.”
• “For power users: webhooks, GraphQL, templates.”

Onboarding

Оценка: 7/10 для Obsidian publishing, 5/10 для AI-agent positioning.

Сильное:

• шаги конкретные;
• есть safety вокруг private/public;
• есть первый видимый результат.

Слабое:

• нет отдельного “agent-first” quickstart;
• MCP подключение на лендинге есть, но docs index не делает его главным;
• Telegram перегружает общий onboarding;
• self-host и cloud sandbox не всегда объясняются как выбор “быстро попробовать vs владеть инфраструктурой”.

IA / структура

Оценка: 6/10.

Сильное:

• много страниц;
• разделы покрывают реальные возможности;
• есть use cases и philosophy.

Слабое:

• IA отражает историю продукта, а не текущий strategic narrative;
• English и Russian docs не полностью синхронизированы по новой AI-agent линии;
• /docs русская индексная страница старее по positioning, чем /en/user;
• “LLM Wiki” как ключевая концепция спрятана в docs, хотя должна быть верхним уровнем.

Copy

Оценка: 7/10 для early adopters, 5/10 для холодной аудитории.

Сильное:

• эмоциональный лендинг;
• хорошие фразы: “The wiki is the artifact, not the chat”, “your data stays yours”, “no SaaS in the middle”;
• README хорошо объясняет open-source dev value.

Слабое:

• слишком много терминов в первых экранах;
• недостаточно короткой фразы “what it does”;
• CTA конкурируют: start, mcp:add, docs, GitHub, try free, simplecloud;
• “Star us” есть, но не всегда подкреплён причиной: зачем ставить star именно сейчас.

Quickstart

Оценка: 6/10.

Есть хороший “Try it now” в README и лендинге. Но docs должны иметь явный, отдельный “Quickstart for agents”.

1. “Open-source MCP knowledge mesh”

Проблема: сильная для developers, но терминологичная.

Лучше сначала:

Build a living knowledge library your AI agents can search, cite, and update.

Потом:

Trip2G exposes Markdown/Obsidian knowledge through MCP and lets hubs federate with trusted peers.

2. “MCP Federation”

Для пользователя это не цель. Цель:

Ask one question across your notes, your team’s docs, and trusted external bases.

Термин MCP Federation — ниже как механизм.

3. “LLM Wiki”

Сильный термин, но требует пояснения.

Лучше:

Keep the useful synthesis from AI chats in a durable Markdown wiki.

Потом:

We call this an LLM Wiki.

4. “Contentless CMS”

Интересно, но не должно быть главным сообщением. Это philosophy/deep dive.

Лучше на верхнем уровне:

Write in your own editor. Trip2G publishes and serves it to humans and agents.

5. “Subgraph paywalls”

Для creator-а лучше:

Sell access to parts of your knowledge base.

Потом технически:

Implemented as subgraphs.

1. Новый hero для лендинга

Текущий лендинг сильный, но можно дать более ясный первый экран.

Build a living knowledge library for AI agents.

Trip2G turns your Markdown, Obsidian vaults, Telegram history, and docs into a self-hosted hub that AI agents can search, read, cite, and update through MCP.

Open-source. MIT. Your data stays yours.

[Connect demo MCP] [Star on GitHub] [Self-host] [Read docs]

Подзаголовок для technical audience:

Under the hood: every hub exposes an MCP server, can federate with trusted peers, and serves the same knowledge to humans as a website.

2. Новый GitHub CTA на лендинге

Сейчас есть ★ star us, но можно усилить мотивацию.

Trip2G is open source and early.
Star the repo if you want agent-readable, self-hosted knowledge bases to exist outside SaaS silos.

★ Star on GitHub

Или короче:

Help make knowledge bases agent-readable and self-hosted.
★ Star Trip2G on GitHub

3. Docs index должен начинаться не с каталога, а с выбора пути

Для https://trip2g.com/docs и https://trip2g.com/en/user:

What do you want to do?

1. Ask the public Trip2G knowledge network with your AI agent
   Connect the demo MCP endpoint and ask questions with sources.
   → 2-minute agent quickstart

2. Create your own living knowledge library
   Sync Markdown/Obsidian notes, publish selected pages, connect MCP.
   → 10-minute personal hub quickstart

3. Self-host Trip2G
   Run your own open-source hub with Docker.
   → Self-host guide

4. Connect multiple knowledge bases
   Let one agent search your notes, team docs, and trusted peers.
   → Federation guide

5. Publish to humans
   Website, RSS, Telegram, paywalls, custom domains.
   → Publishing docs

После этого уже каталог фич.

4. Новый “Agent-first quickstart”

Нужна отдельная страница типа:

/en/user/agent_quickstart или /docs/agent_quickstart.

Черновик структуры:

# 2-minute quickstart: ask Trip2G from your AI agent

Trip2G is easiest to understand by using it.

## Step 1. Add the demo MCP endpoint

mcp:add https://trip2g.com/_system/mcp

Or in mcp.json:
...

## Step 2. Ask your agent

Try:
- What is Trip2G?
- How do I publish an Obsidian vault?
- How does federation work?
- What data leaves my machine?
- Compare Trip2G to Obsidian Publish and Quartz.

## Step 3. Create your own hub

Use the free hosted sandbox or self-host with Docker.

[Create free sandbox] [Self-host] [Star on GitHub]

5. Переписать “MCP Server” intro

Текущий /en/user/mcp хороший, но можно сделать начало проще.

Trip2G makes your knowledge base readable by AI agents.

Your agent can search notes, open exact sections, follow links, read author instructions, and answer with sources — without copying your whole vault into chat.

Technically, this works through MCP. Every Trip2G hub exposes an MCP endpoint.

6. Переписать “Federation” intro

Federation lets one agent ask across many trusted knowledge bases.

You keep your own hub. Your friend, teammate, or company keeps theirs. When you ask a question, your agent can search the bases you are allowed to access — without merging databases or uploading everything to a central SaaS.

Technically, hubs connect through MCP federation.

7. Поднять LLM Wiki выше

Страница /en/user/llm_wiki должна быть linked из:

• hero/footer;
• docs index;
• README near “Try it now”;
• use cases.

Новая короткая карточка:

LLM Wiki
Keep the useful synthesis from AI chats in Markdown.
Agents can read it, navigate it, update it, and cite it later.
→ Build an LLM Wiki

8. Разделить Obsidian website и AI library narratives

Сейчас docs index говорит:

trip2g turns your Obsidian vault into a website in under a minute.

Это понятно, но сужает продукт до Obsidian Publish competitor.

Лучше:

Trip2G turns Markdown knowledge into a living library for humans and AI agents.

For humans, it is a fast website with RSS, Telegram publishing, subscriptions, and custom domains.
For agents, it is an MCP server with search, note navigation, instructions, and federation.

9. Упростить use cases под новый narrative

На /en/user/use_cases добавить первый сценарий:

AI-readable project knowledge
A team keeps docs, decisions, and onboarding notes in Markdown. Trip2G publishes them as a website and exposes the same knowledge to Claude, Cursor, Codex, and other agents through MCP. New teammates and agents can ask questions and get answers with sources.

И второй:

Personal living library
A researcher keeps books, notes, courses, and saved articles in Obsidian. Trip2G lets their agent search across everything and return grounded answers without pasting notes into chat.

10. README улучшить для GitHub conversion

README уже хорош. Изменить первые строки:

Сейчас:

Open-source MCP knowledge mesh. Self-host your knowledge bases, expose them to AI agents via MCP, and federate with peers — no SaaS in the middle.

Предложение:

Open-source living knowledge library for AI agents.

Trip2G turns Markdown, Obsidian vaults, docs, and Telegram history into a self-hosted hub that agents can search, read, cite, and update through MCP — no SaaS in the middle.

И сразу после CTA:

If you want agent-readable knowledge bases to stay open and self-hostable, star the repo.

P0

1. Добавить agent-first quickstart в docs.
2. Переписать docs index вокруг “living library for AI agents”.
3. Поднять LLM Wiki как ключевую концепцию.
4. Убрать/понизить /dev/mcp как user-facing страницу или явно пометить как implementation notes.
5. Усилить GitHub Star CTA: почему star важен.

P1

1. Разделить onboarding:
   • agent demo;
   • first Obsidian note;
   • MCP for own hub;
   • Telegram publishing.
2. Переписать intro MCP/Federation простым языком.
3. Добавить “What Trip2G is / is not”:
   • not just Obsidian Publish;
   • not just RAG;
   • not a centralized SaaS;
   • not a chat app.

P2

1. Синхронизировать RU/EN docs по новой структуре.
2. Добавить диаграмму “same knowledge, two surfaces”:
   • Human website;
   • Agent MCP endpoint.
3. Добавить “copy snippets” для CTA:
   • MCP config;
   • GitHub star;
   • self-host command;
   • sandbox.