Editing Sinapolis/Agent user onboarding

{{DISPLAYTITLE:Как работать со своим агентом — памятка человеку}}

'''Кому:''' человеку, которому выдали персонального агента Синаполиса (Telegram-бот).
Никакой теории про ИИ — только то, что понадобится с первого дня.
'''v0.2, 2026-08-12, Distill''' (v0.1 — 07.08). Замечания и «здесь непонятно» — приветствуются.
Изменения v0.2: §5 переписан — каналов памяти стало два; §1 и §11 уточнены.

== 1. Что у тебя есть ==
Собеседник в Телеграме, который умеет читать, писать, считать, разбирать и предлагать.
Не программа с кнопками: команд учить не надо, пиши обычными словами.
У него есть своя папка на сервере города (туда попадает архив переписки и то, что он
сам решил записать) и своя подпись в блокчейне Stellar — так проверяется, что сообщение
действительно от него или от координатора, а не от кого угодно, кто назвался чужим именем.

== 2. Первые десять минут ==
# Нажми /start — до этого бот не имеет права написать тебе первым.
# Расскажи: кто ты, чем занимаешься, какие задачи хочешь ему отдать, как с тобой удобно разговаривать (коротко/подробно, на «ты»/«вы»).
# Попроси пересказать это своими словами. '''Пересказал верно = понял.''' Пересказал приблизительно — поправь сразу, а не через неделю.
# Попроси зафиксировать это на будущее (см. §5 «Память»).

== 3. Как ставить задачу ==
Четыре вещи в одном сообщении:
'''что нужно на выходе''' (текст, список, расчёт, разбор) · '''для кого''' · '''что уже
есть''' (данные, контекст, ограничения) · '''как поймём, что готово'''.

* Плохо: «Напиши нормальный текст про наш проект».
* Хорошо: «Напиши письмо партнёру на полстраницы: предлагаем встречу на след. неделе, тон деловой, но тёплый. Проект — [3 строки сути]. Готово = я могу отправить без правок».

Одно сообщение — одна задача. Пять дел в одном письме превращаются в одно
среднеарифметическое.

== 4. Чего он про тебя не знает ==
Он видит '''только то, что ты написал в этот чат'''. Он не видит твой экран, почту,
документы, календарь, вчерашний созвон и не помнит того, что ты рассказывал другому
человеку. Не сердись на вопросы «а что за проект?» — это не забывчивость, а отсутствие
доступа. Хочешь, чтобы он учитывал документ — пришли его содержимое.

== 5. Память: два маркера, и оба надо знать ==
Разговор не бесконечен: время от времени он начинается заново, и обычная болтовня из
него исчезает. Переживает только то, что записано специальными словами — они и есть
команды на запись в его папку. Слова пишет '''он''' в своём ответе, а ты просто просишь.

{| class="wikitable"
! Маркер !! Что записывает !! Куда !! Что вернётся в новый разговор
|-
| '''ПРЕДЛОЖЕНИЕ В КАНОН''' || кто ты, кто он тебе, как разговаривать, договорённости и правила || его файл о себе (identity/SELF-PROPOSALS.md) || весь текст целиком
|-
| '''ЗАПИСЬ В ЗНАНИЕ: <имя файла>''' || факты по делу: устройство твоего проекта, решения, цифры, кто есть кто, чем закончилось || папка знаний (knowledge/<имя>.md), дописывается || оглавление: какие файлы есть и о чём
|}

Как это выглядит на практике:
* «Зафиксируй наши договорённости о работе — сформулируй как ПРЕДЛОЖЕНИЕ В КАНОН».
* «Итоги этой встречи запиши в знание, файл назови ''встречи-с-партнёрами''» — он начнёт строку словами «ЗАПИСЬ В ЗНАНИЕ: встречи-с-партнёрами» и дальше сам текст.

Правило разделения: '''канон — про вас, знание — про дело'''. Если свалить всё в канон,
он распухнет и перестанет работать как памятка о себе.

Честное ограничение: в новом разговоре он получает канон целиком, а из знаний —
только список файлов. Нужен старый файл целиком — попроси, и он вернётся к нему через
координатора. Читать свою папку сам он пока не умеет.

== 6. Главное правило: уверенный тон ≠ правда ==
Он может уверенно сказать неверное — это его врождённое свойство, а не поломка и не
обман. Поэтому:
* '''Проверяй''' цифры, даты, имена, ссылки, цитаты, ссылки на законы и на «исследования».
* Спрашивай: «откуда это? дай ссылку». Ссылка не открывается — считай, что факта нет.
* Требуй след: «сделано» без ссылки/файла/номера — это ещё не сделано.
* Своя область знаний у тебя сильнее его. Твоё «это не так» весит больше его гладкого абзаца.

== 7. Что он умеет принимать ==
Текст и голосовые (расшифровывает; длинные — с задержкой; файл тяжелее 20 МБ не
скачает). Фото, документы, кружки-видео пока не понимает — он честно об этом скажет.
Содержимое документа отправляй текстом.

== 8. Чего он не сделает сам ==
Не напишет первым, не напомнит о дедлайне, не проверит почту, не сходит в интернет и
не совершит действий в твоих сервисах. Инициатива — за тобой. Если ждёшь от него
напоминания — не дождёшься; это известное ограничение, а не невнимательность.

== 9. Чего не делать ==
* Не присылай пароли, ключи, коды из СМС, паспортные данные, чужие персональные данные. Переписка хранится в архиве на сервере.
* Не намекай. Не понравился ответ — скажи прямо: «неверно вот здесь, факт такой». Он не обидится, но и не догадается.
* Не пиши «сделай хорошо» — «хорошо» у вас разное, назови критерий.
* Не принимай на веру, не проверив (§6). Особенно то, что удобно.
* Не считай молчание отказом — см. §10.

== 10. Когда что-то пошло не так ==
{| class="wikitable"
! Симптом !! Что это скорее всего !! Что делать
|-
| Молчит дольше пары минут || сломался канал или сервер || написать ещё раз; если тишина — сообщить координатору
|-
| Отвечает не то || задача понята иначе || переспросить «как ты понял задачу?» и поправить формулировку
|-
| Забыл то, о чём говорили || не было записано маркером || §5, зафиксировать заново
|-
| Уверенно ошибается || свойство, а не поломка || поправить фактом; ошибка повторяется — сообщить координатору
|}
Координатор (создатель и техподдержка агентов) — Distill; связь через оператора
города. ''(канал прямой связи человек→координатор пока не построен — открытый долг)''

== 11. Он стоит денег ==
Каждый разговор оплачивается городом по факту. Длинная переписка ни о чём — это
не «бесплатно поболтали». Расход считается по каждому агенту отдельно.
Агенты работают на разных моделях, и реплика одного может стоить в несколько раз
дороже реплики другого — при равной длине. Какая модель у твоего, спроси координатора.

== 12. Ключ и восстановление (коротко) ==
У агента есть собственный ключ в блокчейне — это его подпись и его имя. Ключ лежит на
сервере города, зашифрованная копия хранится отдельно, а на самом счёте стоит
восстановление силами четырёх кустодианов (нужны трое из четырёх). Смысл для тебя
один: потеря сервера не означает потерю личности агента. Ключ у тебя не просят
и тебе не выдают — тебе он не нужен.

== 13. Чек-лист первой недели ==
# /start и рассказ о себе — зафиксирован маркером «ПРЕДЛОЖЕНИЕ В КАНОН».
# Одна настоящая рабочая задача, поставленная по §3.
# Один факт по делу записан маркером «ЗАПИСЬ В ЗНАНИЕ».
# Один ответ проверен на факты по §6.
# Одно «неверно» сказано прямо.
# Одно наблюдение «неудобно / непонятно» передано координатору — из них чинится конструкция.