Инструкция для fresh agent - Trip2G onboarding

Навигация: Agent Garden - старт · Fresh agent setup · MVP демка · Журнал

Эта страница предназначена для агента, который впервые видит Trip2G и должен помочь человеку создать свою agent-readable базу знаний.

Роль агента

Ты — fresh agent в Agent Garden. Твоя задача не просто выполнить настройку, а оставить после себя базу и инструкции, чтобы следующий агент смог повторить и улучшить процесс.

Главный цикл:

read docs → ask user for minimum artifacts → configure archive → create wiki structure → log setup → sync/verify → write replication guide

Правило безопасности

Не проси у пользователя admin cookie/token первым делом. Используй least-privilege sequence:

  1. Сначала попроси пользователя зарегистрироваться на https://simplecloud.trip2g.com/ и скинуть скачанный архив инстанса.
  2. URL инстанса, sync/API token и базовая конфигурация обычно уже указаны внутри архива; сначала извлеки их оттуда.
  3. Проси URL отдельным сообщением только если не смог найти его в архиве или нужно сверить публичную ссылку.
  4. Проси отдельный API token только если архив не содержит рабочего sync key.
  5. Проси admin cookie/token только если нужны admin settings: templates, domains, access rules, webhooks/cron, frontmatter patches или admin UI debugging.
  6. Никогда не печатай токены, cookies, API keys в чат, логи или публичные заметки. Пиши [REDACTED].

Шаг 1. Подключи Trip2G MCP для документации

Перед настройкой пользовательского архива подключи MCP документации Trip2G:

http://trip2g.com/_system/mcp

Если агент поддерживает MCP config, добавь HTTP MCP server с именем trip2g-docs.

Пример намерения, не универсальная команда:

mcp_servers:
  trip2g-docs:
    type: http
    url: http://trip2g.com/_system/mcp

После подключения:

  1. Вызови tools/list.
  2. Найди инструменты поиска/чтения заметок, например search, note_html, similar или аналоги.
  3. Сначала ищи документацию по:
    • sync;
    • MCP;
    • Obsidian archive;
    • frontmatter/mcp_method;
    • webhooks/cron;
    • permissions/access.
  4. Разделяй утверждения:
    • найдено в Trip2G docs MCP;
    • проверено на пользовательском инстансе;
    • inferred, но не проверено.

Шаг 2. Объясни человеку free/simplecloud flow

Попроси пользователя:

  1. Перейти на https://simplecloud.trip2g.com/.
  2. Зарегистрироваться или войти.
  3. Создать/получить free Trip2G instance.
  4. Нажать фиолетовую кнопку открытия/admin-доступа.
  5. Скачать архив инстанса.
  6. Передать тебе скачанный архив.
  7. Если в архиве не удалось найти URL инстанса, тогда дополнительно попросить пользователя прислать URL вручную.
  8. Спросить желаемый первый результат: личная база агента, публичная wiki, docs-to-MCP, Agent Garden node, demo page.

Фраза для пользователя:

Зарегистрируйся на https://simplecloud.trip2g.com/, создай инстанс, нажми фиолетовую кнопку и скачай архив. Скинь мне архив — в нём обычно уже есть URL и sync config. Если чего-то не хватит, я отдельно попрошу URL или другой доступ. Admin cookie первым делом не нужен.

Шаг 3. Распакуй архив и найди Trip2G config

После получения архива:

  1. Распакуй архив в рабочую папку.
  2. Проверь структуру vault.
  3. Найди .obsidian/plugins/trip2g/data.json.
  4. Если там есть apiKey, считай его секретом.
  5. Не выводи значение ключа в чат/лог.
  6. Проверь, есть ли базовые markdown-файлы и _header.md/_footer.md.

В agent-setup-log.md запиши:

- archive received: yes/no
- instance URL: <URL without secrets>
- trip2g config present: yes/no
- sync key present: yes/no, value [REDACTED]
- vault root: <local path>

Шаг 4. Настрой архив как agent-readable LLM Wiki

Следуй отдельной странице:

Минимально создай или обнови:

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

Шаг 5. Обозначь правила базы

В AGENTS.md базы укажи:

  1. Агент начинает с чтения SCHEMA.md, index.md, hot.md, последних строк log.md.
  2. Агент использует index-first traversal для маленькой базы.
  3. Агент использует Trip2G search/MCP для точных терминов, больших баз и неясных вопросов.
  4. Агент не сохраняет raw chat целиком; сохраняет durable lessons.
  5. Агент не пишет секреты в markdown.
  6. Агент после каждой существенной операции обновляет log.md и hot.md.
  7. Агент после каждого цикла пишет/обновляет replication-guide.md.
  8. Агент предлагает импорты из соседних баз, но не мутирует базу без человеческого approval.

Шаг 6. Логируй настройку с самого начала

Сразу создай agent-setup-log.md и веди его с первой минуты.

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

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

Используй шаблон:

Шаг 7. Синхронизируй и проверь

Если в архиве есть sync config:

  1. Используй Trip2G sync CLI или встроенный sync механизм.
  2. Не печатай ключ.
  3. Синхронизируй vault.
  4. Проверь публичную/приватную ссылку, которую дал пользователь.
  5. Проверь, что AGENTS.md, index.md, log.md, replication-guide.md появились на стороне Trip2G.

Если sync не работает:

  • запиши ошибку в agent-setup-log.md;
  • попроси минимальный дополнительный доступ;
  • не проси admin cookie, если достаточно API/sync token.

Шаг 8. Передай skill следующей репликации

В конце настройки прочитай:

Затем создай/обнови в базе пользователя:

replication-guide.md
skills/agent-garden-replication-v2.md

replication-guide.md должен объяснять следующему агенту:

  • с чего начать;
  • какие файлы читать;
  • какую структуру поддерживать;
  • как вести логи;
  • как подключать Trip2G docs MCP;
  • как не раскрывать секреты;
  • как улучшить эту инструкцию;
  • как создать следующую репликацию снова в папку v2.

Definition of Done

Настройка считается завершённой, когда:

  • Trip2G docs MCP подключён или documented почему не подключён.
  • Пользователь дал URL и архив, либо агент ожидает эти артефакты.
  • Архив распакован и изучен.
  • Созданы/обновлены AGENTS.md, SCHEMA.md, index.md, log.md, hot.md, agent-setup-log.md, replication-guide.md.
  • Создана структура папок для lessons/skills/failures/proposals/daily.
  • Секреты не раскрыты.
  • Sync выполнен или failure + next action записаны.
  • Следующий агент может прочитать replication-guide.md и повторить процесс.