티켓 생성 및 관리

이 가이드에서는 티켓을 만들고 관리하는 방법을 설명합니다.

티켓 만들기

UI에서

워크스페이스 사이드바에서 티켓을 클릭합니다.
새 티켓을 누릅니다.
다음 항목을 입력합니다:
- 제목 — 간단한 요약입니다. 유일한 필수 필드입니다.
- 설명 — 마크다운이며, 서식 도구 모음이 있습니다.
- 상태 — 할 일(기본값) 또는 백로그입니다. 시작된 상태와 종료 상태는 만들 때가 아니라 수명주기를 통해 도달합니다.
- 우선순위 — 없음, 긴급, 높음, 보통, 낮음.
- 담당자 — 본인 또는 워크스페이스의 모든 에이전트.
- 프로젝트 — 선택적인 그룹화.
만들기를 누르거나, 먼저 더 만들기를 켜서 빠르게 입력할 수 있도록 대화상자를 열어 둡니다.

대화상자에는 공급자 선택기가 없습니다. 티켓은 워크스페이스의 활성 티켓 공급자를 기준으로 만들어집니다.

에이전트에서

스페이스에서 에이전트에게 요청합니다:

느린 연결에서 로그인 타임아웃 문제를 해결할 티켓을 만들어 주세요.

그러면 에이전트가 create_ticket MCP 도구를 호출합니다. 이 도구에서 우선순위는 이름이 아니라 정수입니다:

create_ticket(
  workspace_id: "...",
  title: "Fix login timeout on slow connections",
  description: "...",
  priority: 2
)

값	우선순위
`0`	없음
`1`	긴급
`2`	높음
`3`	보통
`4`	낮음

workspace_id와 title만 필수이며, description, priority, assignee(에이전트 id), team_id는 선택 사항입니다. 이 도구는 외부 트래커 쓰기로 분류되어 실행 전에 승인을 요청합니다.

티켓 상태 변경

티켓은 다음 수명주기를 따릅니다:

backlog → open → inProgress ⇄ blocked
                    ↓   ↑
                 inReview
                    ↓
              done / failed   (terminal)

done, failed, cancelled는 종료 상태입니다. cancelled는 모든 비종료 상태에서 도달할 수 있습니다. done과 failed는 inProgress 또는 inReview에서 도달할 수 있으며, open은 blocked로 바로 이동할 수도 있습니다. UI 상태 선택기에는 failed를 제외한 모든 상태가 나열됩니다 — 에이전트는 fail_ticket으로 이를 표시합니다.

상태를 바꾸려면 다음 중 하나를 사용합니다:

티켓의 속성 패널에 있는 상태 행,
목록에서 티켓을 마우스 오른쪽 버튼으로 클릭했을 때 나오는 상태 하위 메뉴,
티켓을 여러 개 선택한 뒤 플로팅 바에 나타나는 상태 칩.

상태 변경은 파이프라인을 트리거할 수 있는 도메인 이벤트(TicketStatusChanged, TicketCompleted 등)를 발행합니다. 파이프라인 트리거 설정을 참고하세요.

티켓 배정

티켓을 엽니다.
속성 패널에서 담당자를 본인, 다른 워크스페이스 구성원 또는 에이전트로 설정합니다.

레이블 추가

레이블은 개별 티켓이 아니라 티켓 목록에서 일괄 적용합니다 — 속성 패널에는 레이블 컨트롤이 없습니다.

티켓 목록에서 행 위로 마우스를 가져가 체크박스를 선택합니다. 필요한 만큼 선택하세요. 하나라도 선택하면 플로팅 바가 나타납니다.
그 바에서 레이블 칩을 엽니다.
레이블을 고릅니다. 선택한 티켓 중 해당 레이블이 없는 모든 티켓에 추가되며, 기존 레이블은 절대 지워지지 않습니다. 레이블 지우기는 모든 레이블을 제거합니다. 선택기에는 워크스페이스의 티켓에 이미 있는 레이블이 나열됩니다. 에이전트는 update_ticket 또는 tickets.patch를 통해 새 이름을 추가할 수 있습니다.

티켓 연결

관계는 속성 패널의 티켓 관계 카드에 있거나, 목록의 마우스 오른쪽 버튼 메뉴에 있는 관계 지정 뒤에 있습니다.

티켓을 열고 관계 카드를 찾습니다.
카드의 추가 컨트롤을 눌러 관계를 선택합니다:

관계	의미
다음의 하위 이슈…	이 티켓의 상위 티켓이 상대 티켓입니다
다음의 상위 이슈…	상대 티켓이 이 티켓의 하위 티켓입니다
다음으로 인해 차단됨…	이 티켓이 상대 티켓으로 인해 차단됩니다
다음을 차단 중…	이 티켓이 상대 티켓을 차단합니다
다음과 관련됨…	대칭 관계이며 방향이 없습니다
다음의 복제…	이 티켓이 상대 티켓의 복제입니다

대상 티켓을 고릅니다.

복제됨은 카드에는 나타나지만 선택기에는 없습니다 — 다음의 복제의 역방향이며 상대 티켓에서 설정합니다. 나열된 각 관계는 클릭하면 연결된 티켓이 열리고, 마우스를 가져가면 제거할 수 있습니다.

상위 및 하위 이슈 관계는 링크 행이 아니라 티켓 자체에 저장되므로, 상위 티켓을 삭제하면 하위 티켓까지 연쇄 삭제되지만(아래 참고), 차단 및 관련 링크는 그렇지 않습니다.

협업자 추가

협업자는 티켓의 로스터입니다 — 누가 어떤 역할로 관련되어 있는지를 나타냅니다.

티켓을 엽니다.
협업자 추가 카드에서 사람 추가 컨트롤을 누릅니다.
에이전트를 고릅니다.

역할은 담당자, 협업자(기본값), 리뷰어 세 가지입니다. UI 선택기에는 워크스페이스 에이전트만 나열되며 항상 기본 역할을 기록합니다. 사람은 행으로 나타날 수 있지만 그 메뉴에는 표시되지 않습니다. MCP add_ticket_collaborator 도구는 role을 받습니다.

협업자를 추가하면 행 하나를 기록할 뿐 도메인 이벤트를 발행하지 않으며, 스페이스 접근 권한도 부여하지 않습니다. 에이전트를 대화에 넣으려면 대신 스페이스 헤더에서 참가자로 추가하세요 — 스페이스 사용을 참고하세요.

티켓 삭제

속성 패널 맨 아래의 티켓 삭제를 사용하거나, 마우스 오른쪽 버튼 메뉴를 사용하거나, 티켓을 여러 개 선택한 뒤 플로팅 바의 삭제 동작을 사용합니다.