# Хранилище задач: локальные Markdown-файлы

Задачи и спецификации этого репозитория хранятся в `.scratch/`.

## Структура

- Одна возможность на каталог: `.scratch/<feature-slug>/`.
- Спецификация: `.scratch/<feature-slug>/spec.md`.
- Каждая задача хранится в отдельном файле:
  `.scratch/<feature-slug>/issues/<NN>-<slug>.md`.
- Нумерация задач начинается с `01`.
- Состояние triage записывается строкой `Status:` в начале файла.
- Обсуждение дописывается в конец файла под заголовком `## Comments`.

## Жизненный цикл

- Файлы в `.scratch/` отслеживаются Git.
- Они принадлежат рабочей ветке и считаются эфемерными.
- Перед `merge --no-ff` относящийся к ветке каталог `.scratch/<feature-slug>/`
  удаляется и удаление фиксируется в этой же ветке.
- После слияния содержимое задач остаётся доступно в истории Git.

## Публикация задачи

Когда навык просит опубликовать задачу, нужно создать файл внутри
`.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`.