Sticky Note невелика, но сохраняет работу на виду
Sticky Note начинается как стикер для человека. После подключения к CodingAgent она становится общей рабочей памятью: вы и агент можете сохранять важное во время работы, не полагаясь на разговор, который скоро затеряется.
Посмотрите работу агента со Specification и заметками → (открывается в новой вкладке)
Общая заметка сохраняет наблюдения, открытые решения и следующие шаги рядом с графом.
Что делает Sticky Note
Sticky Note полезна и без агента. Запишите вопрос, гипотезу, напоминание или короткий список наблюдений. Её ценность растёт, когда содержимое становится частью того же графа работы.
Через Connection с CodingAgent агент может читать и обновлять заметку вместе с вами. Используйте её для:
- краткого статуса сделано / делается / дальше;
- открытого решения при подготовке Specification;
- пункта, который нужно проверить позже;
- фактов, найденных во время реализации;
- findings независимой проверки;
- checklist передачи работы между участниками графа.
Заметка намеренно остаётся неформальной. Она делает работу прозрачной в обе стороны: вы видите, что заметил агент, а агент получает явное место для информации, которая должна остаться видимой.
Три способа использования
1. Память текущего шага
До начала запишите цель и вопросы, которые нельзя потерять. Во время работы добавляйте короткие факты, ссылки или предварительные решения. В конце оставьте понятные следующие шаги для возвращения в Workspace.
Простой формат:
- Статус: сделано, делается, дальше.
- Внимание: что требует вашего решения или проверки.
- Доказательство: проверка, File или наблюдение, подтверждающее запись.
2. Вторая рука CodingAgent
Подключите Sticky Note к агенту и попросите фиксировать только факты, полезные для вашего следующего решения:
Поддерживай Sticky Note как краткое резюме работы. Записывай изменения, доказательства, риски и вопросы, требующие моего решения. Не превращай гипотезы в окончательные решения.
Агент может добавлять отдельные блоки или заменять содержимое при полной реорганизации. Человек продолжает редактировать заметку, а каждое изменение должно учитывать её последнюю версию.
Если в заметке уже есть ваши наблюдения, укажите, что агент может обновлять. Заполненная заметка не приглашает самостоятельно её перестроить. Более точное поручение:
Поддерживай эту Sticky Note во время расследования. Сохраняй мои записи и записи Reviewer. Добавляй только свои проверенные находки и обновляй только пункты со своим именем. Перед реорганизацией всего текста спроси разрешение.
3. Мост между реализацией и проверкой
Builder может записать изменения и выполненные проверки. Reviewer может добавить findings и риски. Вы видите оба результата, не разыскивая их в двух отдельных сессиях.
Connection между CodingAgents не является автоматической последовательностью workflow: она делает участников достижимыми и позволяет им обмениваться сообщениями.
Пример: заметка, с которой легко вернуться к работе
При расследовании ошибки входа не каждое наблюдение должно становиться архитектурным решением. Сохраните открытие, доказательства и нерешённый вопрос в заметке:
## Сделано
- Ошибка воспроизведена после истечения сессии.
- Вход с новой сессией по-прежнему работает.
## В работе
- Сравниваем ответ для истёкшей сессии с обработкой на клиенте.
## Нужно решение человека
- Решить: обновлять сессию или запрашивать новый вход.
- Гипотеза: retry повторяет запрос со старой учётной информацией. Пока не подтверждена.
## Доказательства
- Terminal Checks: команда воспроизведения и наблюдаемый ответ.
- File клиента: место, где начинается retry.
## Далее
- Проверить гипотезу до изменения клиента.
Попросите агента:
Добавляй проверенные открытия и вопросы в заметку. Сохраняй мои наблюдения. Когда гипотеза подтверждена или опровергнута, обнови её состояние с доказательством. Если решение определяет область исправления, перенеси его в соответствующую Specification и оставь здесь краткую ссылку.
Для проверки отдельный блок может содержать сценарий, наблюдаемое поведение, доказательство и следующий шаг. Так видно, что заключил Builder и что проверил Reviewer.
Для одного открытия используйте точечное обновление или новый блок. Когда накопятся старые статусы, попросите реорганизовать тело, сохранив открытые решения и ваши наблюдения. Результат должен помогать продолжить работу без повторного чтения всех разговоров.
Общая заметка не означает передачу владения
Путь Connections делает заметку доступной для чтения и разрешённых записей. Это не поручение всем агентам графа автоматически начать отчитываться в ней.
Без вашего поручения автоматический отчёт ограничен Sticky Note, напрямую соединённой с этим CodingAgent и пустой при первом знакомстве с ней. Агент использует короткий список и подписывает каждый пункт своим именем:
- [x] Builder — done: reproduced the expired-session failure.
- [ ] Builder — doing: checking the client's retry handling.
- [ ] Builder — will: verify the fix against the Specification.
Агент обновляет только свои пункты при значимых изменениях работы. Он не должен завершать, переписывать или удалять ваши записи либо записи коллеги. Заполненная заметка требует явного поручения на поддержку; другой маршрут или Connection коллеги не разрешает инициативные отчёты.
Если вы очистили заметку, в которую агент уже писал, он должен оставить её пустой до просьбы возобновить отчёт. Общая память не должна лишать вас контроля над тем, что остаётся на Canvas.
Это инструкции сотрудничества, не техническая блокировка любого редактирования. Чтобы запретить записи через
операции Kavor, используйте sticky_note_read_only на прямой Connection.
Markdown, редактирование и конфликты
Sticky Note поддерживает Markdown для заголовков, списков, задач, выделения, кода и других обычных элементов рабочей заметки. Необработанный HTML не принимается. Заметка вмещает до 64 000 кодовых точек Unicode и предлагает четыре цвета для визуальной группировки; цвет не меняет полномочия содержимого.
Kavor сохраняет изменения автоматически и сообщает, если другой участник изменил заметку до вашего сохранения. Интерфейс не удаляет параллельное изменение молча, а позволяет разрешить конфликт. Запись может добавить новый блок или заменить всё содержимое.
Чем она не должна быть
- устойчивое решение с областью и критериями приёмки относится к Specification;
- исходный код и канонические артефакты относятся к File;
- команды и доказательства выполнения относятся к Terminal;
- сообщение координирует участников, но не должно быть единственным источником важного решения.
Хорошая заметка достаточно коротка для чтения и достаточно содержательна, чтобы следующий шаг не зависел от памяти одной сессии.
Guardrail и достижимость
CodingAgent получает доступ к Sticky Note только через действительный путь Connections. Близость на Canvas или упоминание Node в сообщении доступа не дают.
Guardrail sticky_note_read_only можно разместить на прямой Connection между агентом и заметкой. Агент сможет читать её, но не добавлять и не заменять содержимое через операции Kavor. Guardrail ограничивает эту прямую пару; он не создаёт Connection и не превращает заметку в политику всего Workspace.
Что дальше
- Разберитесь с моделью Nodes.
- Выберите минимальный набор Connections для работы.
- Замкните первый цикл со Specification, CodingAgents, Terminal и Sticky Note.