Files
clickstream-ch-kafka-supers…/docs/agents/issue-tracker.md
T
ddadmin aecbf392d9 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.
2026-06-01 23:29:50 +03:00

1.5 KiB
Raw Blame History

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>/ (каталог создать при необходимости).

Когда скилл говорит «достать тикет»

Прочитать файл по указанному пути. Обычно путь или номер задачи передаёт пользователь.