- Зачем:
- развести документацию по времени жизни: транзиентные спеки отдельно от
долговечных решений (ADR) и доменного словаря (CONTEXT.md), вместо одного
громоздкого spec-документа.
- Что:
- добавлен блок Agent skills в AGENTS.md (issue tracker / triage / domain docs).
- созданы docs/agents/{issue-tracker,triage-labels,domain}.md: локальный
markdown-трекер в .scratch/, дефолтные triage-метки, single-context раскладка.
- зафиксировано решение как docs/adr/0001-spec-adr-issue-layout.md.
- Проверка:
- git show --stat HEAD; прочитать AGENTS.md и docs/adr/0001-spec-adr-issue-layout.md.
1.5 KiB
1.5 KiB
Issue tracker: локальный markdown
Задачи и PRD этого репозитория живут markdown-файлами в .scratch/. GitHub Issues
не используются — не вызывать gh issue create. Файлы в .scratch/ коммитятся
(.scratch/ не в .gitignore).
Соглашения
- Одна фича — один каталог:
.scratch/<feature-slug>/ - PRD фичи —
.scratch/<feature-slug>/PRD.md(по сути транзиентная спека: снимок понимания на момент работы; долговечные решения идут в ADR — см.docs/agents/domain.md) - Задачи реализации —
.scratch/<feature-slug>/issues/<NN>-<slug>.md, нумерация с01 - Состояние триажа — строкой
Status:у верха файла задачи (строки ролей — вtriage-labels.md) - Комментарии и история — в конец файла под заголовком
## Comments
Когда скилл говорит «опубликовать в issue tracker»
Создать файл в .scratch/<feature-slug>/ (каталог создать при необходимости).
Когда скилл говорит «достать тикет»
Прочитать файл по указанному пути. Обычно путь или номер задачи передаёт пользователь.