Рабочие заметки агентов больше не коммитятся и не удаляются перед слиянием: каталог живёт на машине. Долговечное по-прежнему выносится в docs/ до слияния. Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>
2.8 KiB
2.8 KiB
Хранилище задач: локальные Markdown-файлы
Задачи и спецификации этого репозитория хранятся в .scratch/.
Структура
- Одна возможность на каталог:
.scratch/<feature-slug>/. - Спецификация:
.scratch/<feature-slug>/spec.md. - Каждая задача хранится в отдельном файле:
.scratch/<feature-slug>/issues/<NN>-<slug>.md. - Нумерация задач начинается с
01. - Состояние triage записывается строкой
Status:в начале файла. - Обсуждение дописывается в конец файла под заголовком
## Comments.
Жизненный цикл
.scratch/указан в.gitignore: задачи живут только на этой машине и в Git не попадают.- Они эфемерны: после завершения работы каталог можно удалить.
- Всё, что должно пережить задачу (решения, спецификации), до слияния
переносится в
docs/и коммитится.
Публикация задачи
Когда навык просит опубликовать задачу, нужно создать файл внутри
.scratch/<feature-slug>/, при необходимости создав каталог.
Получение задачи
Нужно прочитать файл по переданному пути. Обычно пользователь указывает путь или номер задачи.
Работа /wayfinder
Карта работы хранится отдельно от дочерних задач:
- Карта:
.scratch/<effort>/map.md. - Дочерняя задача:
.scratch/<effort>/issues/NN-<slug>.md. - Строка
Type:содержит тип:research,prototype,grillingилиtask. - Строка
Status:содержит состояниеclaimedилиresolved. - Зависимости перечисляются строкой
Blocked by: NN, NN. - Задача свободна, если она открыта, не заблокирована и не занята.
- Из нескольких свободных задач первой выбирается задача с меньшим номером.
- При взятии задачи нужно установить
Status: claimedи сохранить файл. - При завершении нужно добавить ответ под заголовком
## Answer, установитьStatus: resolvedи добавить краткий итог со ссылкой в раздел решений файлаmap.md.