Инструкция для агента: создать _header.md и _footer.md с навигацией

Дата: 2026-05-04 14:05 UTC

В Trip2G/Obsidian-публикации файлы _header.md и _footer.md используются как общие навигационные блоки для сайта.

Их задача:

_header.md → верхняя навигация / быстрый вход в базу
_footer.md → нижняя навигация / служебные ссылки / подсказка агентам

Для research/LLM Wiki базы это особенно важно: человек и агент должны быстро понять, где главная, где индекс, где журнал, где инструкции.

Главное правило

Используй Obsidian wikilinks, а не вручную угаданные URL-slugs.

Правильно:

[[Исследование trip2g/99 - Журнал действий|Журнал действий]]

Рискованно:

/issledovaniye_trip2g/99_zhurnal_dejstvij

Почему:

- русские названия файлов превращаются в slugs неочевидно;
- transliteration может отличаться от ожиданий;
- Trip2G/Obsidian умеет резолвить wikilinks надёжнее;
- при переезде/переименовании заметок wikilinks проще поддерживать.

Минимальный _header.md

Для маленькой базы достаточно:

---
free: true
---

<nav class="trip2g-header">

[[ _index | Главная ]] · [[index|Карта базы]] · [[AGENTS|Инструкции агентам]] · [[log|Журнал]]

</nav>

Но лучше не вставлять HTML, если не нужно. Более простой markdown-вариант:

---
free: true
---

**Навигация:** [[_index|Главная]] · [[index|Карта базы]] · [[AGENTS|Инструкции агентам]] · [[log|Журнал]]

---
free: true
---

---

**Trip2G база знаний**  
Начинай с [[index|карты базы]]. Агентам читать [[AGENTS|инструкции]]. Изменения писать в [[log|журнал]].

Вариант для research vault

Если база похожа на dobireports/Trip2G research vault, используй:

_header.md

---
free: true
---

**Trip2G research:** [[_index|Главная]] · [[tasks|Tasks]] · [[Исследование trip2g/21 - Trip2G Tasks - фокус и трекинг|Фокус]] · [[Исследование trip2g/99 - Журнал действий|Журнал действий]]

_footer.md

---
free: true
---

---

**Для агентов:** результаты исследования сохранять отдельными markdown-заметками, добавлять ссылку в [[_index|индекс]], писать запись в [[Исследование trip2g/99 - Журнал действий|журнал действий]] и выполнять sync.

Вариант для LLM Wiki базы

_header.md

---
free: true
---

**LLM Wiki:** [[_index|Home]] · [[index|Index]] · [[AGENTS|Agent Instructions]] · [[SCHEMA|Schema]] · [[log|Log]]

_footer.md

---
free: true
---

---

**How to use this wiki:** start from [[index|Index]], follow wikilinks, cite pages you read, and append durable changes to [[log|Log]].

Вариант для продуктового сайта

Если это не research vault, а публичный продуктовый сайт:

_header.md

---
free: true
---

**Trip2G:** [[_index|Home]] · [[docs/getting-started|Getting started]] · [[docs/mcp|MCP]] · [[docs/llm-wiki|LLM Wiki]] · [[docs/examples|Examples]]

_footer.md

---
free: true
---

---

Trip2G turns Markdown into a website, search index and MCP knowledge base for agents.  
Start with [[docs/getting-started|Getting started]] or read [[docs/mcp|MCP docs]].

Workflow:

1. Прочитать `_index.md` или `index.md`, чтобы понять главные страницы.
2. Найти журнал: `log.md`, `99 - Журнал действий.md` или аналог.
3. Найти инструкции агентам: `AGENTS.md`, `SCHEMA.md`, `_mcp_initialize.md`, если есть.
4. Создать или обновить `_header.md`.
5. Создать или обновить `_footer.md`.
6. Проверить, что wikilinks указывают на существующие заметки.
7. Добавить запись в журнал действий.
8. Выполнить Trip2G sync.
9. Открыть публичную страницу и проверить, что header/footer видны.

Как проверить существующие заметки перед ссылками

Перед тем как вставлять wikilink, проверь, что файл существует.

Примеры shell-команд:

find ./vault -maxdepth 3 -name "_index.md" -o -name "index.md" -o -name "AGENTS.md" -o -name "SCHEMA.md" -o -name "log.md"

Для русских/длинных названий лучше искать по части имени:

find ./vault -name "*.md" | grep -i "Журнал\|Tasks\|Инструкция\|AGENTS\|SCHEMA"

Если используешь инструменты агента, делай то же самое через file search, а не угадывай путь.

Как создать файлы

В корне vault:

cat > ./vault/_header.md <<'EOF'
---
free: true
---

**Навигация:** [[_index|Главная]] · [[index|Карта базы]] · [[AGENTS|Инструкции агентам]] · [[log|Журнал]]
EOF

cat > ./vault/_footer.md <<'EOF'
---
free: true
---

---

**Для агентов:** начни с [[index|карты базы]], прочитай [[AGENTS|инструкции]], изменения записывай в [[log|журнал]].
EOF

Если работаешь через Hermes/file tools, используй write_file, а не shell heredoc.

Если файлы уже есть:

1. Не перезаписывай их вслепую.
2. Прочитай текущий текст.
3. Сохрани полезные ссылки и стиль.
4. Добавь недостающие основные ссылки.
5. Убери битые/угаданные URL-slugs, если есть wikilink-замена.
6. Запиши изменение в журнал.

Пример улучшения:

Было:

[Research](/issledovaniye_trip2g)
[Log](/issledovaniye_trip2g/99_log)

Стало:

[[ _index | Главная ]] · [[Исследование trip2g/99 - Журнал действий|Журнал действий]]

Что обязательно добавить в header

Минимум:

- Главная / `_index.md`
- Карта базы / `index.md`, если есть
- Tasks / task tracker, если база ведёт задачи
- Журнал / `log.md` или `99 - Журнал действий.md`

Для agent-oriented базы дополнительно:

- `AGENTS.md`
- `SCHEMA.md`
- `_mcp_initialize.md`, если есть

Для продуктового сайта:

- Getting started
- Docs
- MCP
- Examples
- GitHub / external link

Footer лучше использовать не как второй header, а как подсказку:

- как человеку начать читать;
- как агенту начать работу;
- куда писать изменения;
- где журнал;
- где задачи;
- внешние ссылки: GitHub, лендинг, docs.

Пример:

---

**Как пользоваться базой:**
- человеку: начать с [[_index|главной]];
- агенту: прочитать [[index|index.md]], [[AGENTS|AGENTS.md]] и последние записи в [[log|log.md]];
- изменения: сохранять отдельными заметками и писать в [[log|журнал]].

Sync после изменения

После создания _header.md и _footer.md выполни sync.

CLI:

https://github.com/trip2g/obsidian-sync/releases/download/0.3.5/trip2g-sync.mjs

Скачать:

mkdir -p ./bin
curl -fsSL \
  https://github.com/trip2g/obsidian-sync/releases/download/0.3.5/trip2g-sync.mjs \
  -o ./bin/trip2g-sync.mjs
chmod +x ./bin/trip2g-sync.mjs

Запуск:

export TRIP2G_INSTANCE="https://YOUR_INSTANCE.2pub.me"
export TRIP2G_API_KEY="[REDACTED]"

node ./bin/trip2g-sync.mjs ./vault \
  --api-url "$TRIP2G_INSTANCE/graphql" \
  --api-key "$TRIP2G_API_KEY" \
  --two-way \
  --conflict-resolution local \
  --verbose

Не вставляй реальный API key в markdown или финальный отчёт.

Проверка после sync

Проверь:

1. Sync завершился без conflicts.
2. Главная публичная страница открывается.
3. Header виден сверху.
4. Footer виден снизу.
5. Ссылки из header/footer кликабельны.
6. Нет 404 по основным ссылкам.

Если есть MCP доступ, дополнительно:

- search `_header.md` / `_footer.md`;
- note_html `_index.md`;
- проверить, что HTML содержит текст навигации.

Частые ошибки

Ошибка 1 — угаданные русские slugs

Плохо:

[Журнал](/issledovanie_trip2g/99_zhurnal_deystviy)

Лучше:

[[Исследование trip2g/99 - Журнал действий|Журнал действий]]

Лучше добавлять:

---
free: true
---

Особенно если база публичная или использует frontmatter patches.

Ошибка 3 — слишком много ссылок

Header должен быть коротким. Не превращай его в sitemap.

Хорошо:

Главная · Tasks · Инструкции · Журнал

Плохо:

30 ссылок на все заметки исследования

Ошибка 4 — забыть обновить журнал

Создание _header.md и _footer.md — структурное изменение базы. Его надо записать в log.md / 99 - Журнал действий.md.

Шаблон записи в журнал

## YYYY-MM-DD HH:MM UTC — header/footer navigation

- Actions:
  - Созданы/обновлены `_header.md` и `_footer.md`.
  - Добавлена навигация на главную, index, AGENTS/SCHEMA, tasks и log.
  - Использованы Obsidian wikilinks вместо ручных URL-slugs.
  - Выполнен Trip2G sync.
- Files updated:
  - `_header.md`
  - `_footer.md`
  - `log.md` или `99 - Журнал действий.md`
- Verification:
  - Публичная главная открывается.
  - Header/footer видны.
  - Основные ссылки не дают 404.

Acceptance criteria

Работа завершена, если:

- `_header.md` существует в корне vault;
- `_footer.md` существует в корне vault;
- навигация содержит 3–7 главных ссылок;
- ссылки сделаны wikilinks, если это внутренние страницы;
- журнал действий обновлён;
- sync выполнен без conflicts;
- публичная страница проверена после sync.