Настройка архива как LLM Wiki

Эта страница описывает, как агент должен превратить скачанный Trip2G/simplecloud архив в базу знаний, которую смогут использовать будущие агенты.

Цель

Не просто загрузить markdown-файлы, а создать agent-readable wiki:

sources + instructions + index + logs + schema + replication guide

Минимальная структура

Создай в корне архива:

AGENTS.md
SCHEMA.md
index.md
log.md
hot.md
tasks.md
learning-log.md
agent-setup-log.md
replication-guide.md
_raw/
_meta/
skills/
lessons/
failures/
proposals/
daily/

Если в архиве уже есть файлы с такими именами, не перетирай молча. Сначала прочитай, затем аккуратно дополни.

AGENTS.md

AGENTS.md — главный operational contract для будущих агентов.

Минимальный шаблон:

# AGENTS.md

## Start protocol

1. Read `SCHEMA.md`.
2. Read `index.md`.
3. Read `hot.md`.
4. Read last 30 lines of `log.md`.
5. Check `tasks.md`.
6. Before making durable changes, explain intended write scope.

## Retrieval policy

- Use index-first traversal for known/small topics.
- Use Trip2G MCP/search for exact terms, large-base questions, or uncertain paths.
- Read full pages only when summaries/sections are insufficient.
- For high-stakes claims, verify sources.

## Write policy

- Save durable knowledge, not raw chat.
- Update `index.md` after creating pages.
- Update `log.md` after every write operation.
- Update `hot.md` with a short recent-context summary.
- Never write secrets into markdown.
- Mark uncertain conclusions explicitly.

## Agent Garden policy

- Keep `learning-log.md` updated.
- Write reusable lessons into `lessons/`.
- Write reusable procedures into `skills/`.
- Write failed approaches into `failures/`.
- Write external import suggestions into `proposals/`.
- Update `replication-guide.md` before ending a session.

SCHEMA.md

SCHEMA.md объясняет типы страниц и frontmatter.

Минимальный frontmatter:

title: >-
  Page Title
category: note | skill | lesson | source | decision | daily | failure | proposal
tags: [agent-garden]
visibility: public | internal | pii
sources: []
summary: >-
  One or two sentences under 200 chars.
provenance:
  extracted: 0.6
  inferred: 0.35
  ambiguous: 0.05
base_confidence: 0.42
lifecycle: draft
lifecycle_changed: YYYY-MM-DD
created: YYYY-MM-DDTHH:MM:SSZ
updated: YYYY-MM-DDTHH:MM:SSZ

Правила:

  • summary обязателен для agent retrieval.
  • visibility: pii или visibility: internal исключается из публичного/соседского обмена.
  • lifecycle меняет человек или явно одобренный процесс.
  • base_confidence — качество источника, не popularity.
  • fitness можно добавлять к lessons/skills для Agent Garden.

index.md

index.md — карта базы. Его читает агент до full search.

Структура:

# Index

## Start here
- [[AGENTS]] — operational rules.
- [[SCHEMA]] — page schema and metadata rules.
- [[hot]] — recent context.
- [[tasks]] — open work.
- [[replication-guide]] — how to spawn the next agent.

## Skills
- ...

## Lessons
- ...

## Daily logs
- ...

## Open proposals
- ...

log.md

log.md — хронологический журнал операций.

Формат:

## YYYY-MM-DD HH:MM UTC — Short title

- Actions:
  - ...
- Files changed:
  - ...
- Decisions:
  - ...
- Secrets handled:
  - none / `[REDACTED]`
- Next:
  - ...

hot.md

hot.md — короткий warm context.

Он должен отвечать:

  • что происходит сейчас;
  • какие файлы важны;
  • что было сделано недавно;
  • какие следующие шаги;
  • что нельзя забыть следующему агенту.

Длина: примерно 300–700 слов.

learning-log.md

Сюда агент пишет, чему научился во время работы.

Не нужно писать всё подряд. Пиши только reusable lessons:

## YYYY-MM-DD — Lesson title

- Situation:
- What worked:
- What failed:
- Reusable rule:
- Should next agent copy this? yes/no/needs review

replication-guide.md

Главный файл для Agent Garden.

Он должен включать:

# Replication Guide

## Who this agent was

## What was configured

## Files next agent must read first

1. `AGENTS.md`
2. `SCHEMA.md`
3. `index.md`
4. `hot.md`
5. `log.md`
6. `learning-log.md`

## How to recreate this setup

## What mistakes to avoid

## What to improve in the next generation

## First prompt for the next agent

## Verification task for the next agent

Folder meanings

  • _raw/ — временные сырые материалы, не для публичного sharing.
  • _meta/ — taxonomy, dashboards, manifests.
  • skills/ — reusable procedures.
  • lessons/ — small learned patterns.
  • failures/ — failed approaches and why.
  • proposals/ — imports from neighbors awaiting human approval.
  • daily/ — daily digest and work logs.

Sync verification

После настройки:

  1. Запусти sync.
  2. Проверь Trip2G URL.
  3. Проверь, что новые файлы видны в поиске или по прямым ссылкам.
  4. Запиши результат в log.md и agent-setup-log.md.