docs(agents): подключена doc/issue-методология Pocock и зафиксирована раскладка
- Зачем:
- развести документацию по времени жизни: транзиентные спеки отдельно от
долговечных решений (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.
This commit is contained in:
@@ -0,0 +1,22 @@
|
||||
# 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>/` (каталог создать при необходимости).
|
||||
|
||||
## Когда скилл говорит «достать тикет»
|
||||
|
||||
Прочитать файл по указанному пути. Обычно путь или номер задачи передаёт пользователь.
|
||||
Reference in New Issue
Block a user