Files
dotfiles/docs/agents/issue-tracker.md
T
ddadminandClaude Opus 5.5 68a944dbdf chore: .scratch/ — только локально, в .gitignore
Рабочие заметки агентов больше не коммитятся и не удаляются перед
слиянием: каталог живёт на машине. Долговечное по-прежнему выносится
в docs/ до слияния.

Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>
2026-09-28 10:56:38 -04:00

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.