architect/standards/3-process/process-tickets.md

type: standard
aspect: process
title: "Система тикетов"
version: 1.0.0
date: 2026-02-19
status: active


Система тикетов

Версия: 1.0.0
Дата: 2025-12-07
Тип: Стандарт


НАЗНАЧЕНИЕ

Тикеты — способ фиксации проблем, идей и предложений во время работы для последующей обработки.

Отличие от задач (.queue/):
- Задачи = конкретные инструкции к выполнению
- Тикеты = проблемы/идеи требующие анализа и решения


ПРИОРИТЕТЫ

Приоритет Описание Маркер
CRITICAL Блокирует работу, требует немедленного решения P0
IMPORTANT Снижает эффективность, решить в ближайшее время P1
IMPROVEMENT Улучшения и оптимизации, можно отложить P2
IDEA Идея для обсуждения P3

СТАТУСЫ

Статус Описание
OPEN Новый тикет, не начат
IN_PROGRESS В работе
BLOCKED Заблокирован зависимостями
RESOLVED Решён, ожидает проверки
CLOSED Закрыт, проверен
WONTFIX Не будет исправляться

ТИПЫ ТИКЕТОВ

Тип Описание Префикс
BUG Ошибка, баг BUG-
FEATURE Новая функция FEAT-
IMPROVE Улучшение существующего IMP-
IDEA Идея для обсуждения IDEA-
TECH Технический долг TECH-
DOC Документация DOC-

ХРАНЕНИЕ

/.tickets/                    ← Тикеты платформы
├── open/                     ← Открытые
│   ├── BUG-001-*.md
│   └── FEAT-002-*.md
├── in_progress/              ← В работе
├── resolved/                 ← Решённые
└── closed/                   ← Закрытые

Формат имени: {ТИП}-{NNN}-{slug}.md
- BUG-001-session-recovery.md
- FEAT-002-export-pdf.md


ФОРМАТ ТИКЕТА

Заголовок

# {ТИП}-{NNN}: Краткое название

**Статус:** OPEN
**Приоритет:** P1 (IMPORTANT)
**Создан:** YYYY-MM-DD
**Автор:** Кто создал
**Область:** Где проблема (путь/модуль)

Обязательные секции

## ПРОБЛЕМА

Описание проблемы или идеи.

## ТЕКУЩЕЕ СОСТОЯНИЕ

Как сейчас работает (если применимо).

## ПРЕДЛАГАЕМОЕ РЕШЕНИЕ

Как предлагается решить.

## КРИТЕРИИ ПРИЁМКИ

- [ ] Критерий 1
- [ ] Критерий 2

Опциональные секции

## НАЙДЕННЫЕ ПРОБЛЕМЫ
## ФАЙЛЫ ДЛЯ ИЗМЕНЕНИЯ
## ОЦЕНКА ТРУДОЗАТРАТ
## СВЯЗАННЫЕ ДОКУМЕНТЫ
## ЗАВИСИМОСТИ

WORKFLOW

Создание тикета

1. Создать файл в /.tickets/open/
2. Заполнить по шаблону
3. Присвоить ID (следующий номер)

Взятие в работу

1. Переместить в /.tickets/in_progress/
2. Обновить статус: IN_PROGRESS
3. Добавить дату начала

Завершение

1. Переместить в /.tickets/resolved/
2. Обновить статус: RESOLVED
3. Заполнить результат
4. После проверки  /.tickets/closed/

КОМАНДЫ

Команда Действие
тикеты Показать открытые тикеты
тикет создать Создать новый тикет
тикет [id] Показать тикет
тикет закрыть [id] Закрыть тикет

БЫСТРОЕ СОЗДАНИЕ

Для быстрой фиксации проблемы/идеи во время работы:

тикет: [тип] [приоритет] [описание]

Примеры:

тикет: bug P0 Сессии не сохраняются при сбое
тикет: idea P3 Добавить голосовой интерфейс
тикет: improve P2 Ускорить загрузку агентов

Система создаст тикет автоматически.


СВЯЗИ


Версия: 1.0.0