문제 모으고 확인하기

문제는 테스트하다 찾은 버그 · 불편 · 보안 걱정 하나예요. 요청 하나를 끝까지 끌고 가는 이슈 보다 가볍고, 많이 모아 두고 하나씩 정리해요.

문제 하나에 무엇을 적나요

문제만 읽어도 무엇이 · 어디서 · 왜 잘못됐는지 알 수 있게, 늘 같은 절로 적어요.

절 적는 것
한 줄 요약 무엇이 · 누구에게 · 왜 문제인가
어디서 화면 · 역할 · 기기
재현 · 기대 · 실제 어떻게 하면 다시 보이나, 무엇을 기대했고 실제로는 어땠나
화면 캡처
원인 확인됨 · 추정 · 아직 몰라요 + 근거
고칠 곳 · 영향 어디를 고치면 되나, 누가 얼마나 막히나
관련 관련 PR · 다른 문제

모르는 절은 「아직 없어요」 로 남겨 두면 무엇이 비었는지 보여요.

콘솔에서 직접

  1. 프로젝트 › 작업 › 문제 › 문제 추가 — 내용 칸이 위 절로 채워져 있어요
  2. 제목 · 심각도 · 분류 · 상태를 고르고 절을 채워요. 「/」 를 누르면 표 · 체크리스트 · 코드를 넣을 수 있어요
  3. 만든 뒤 문제 화면의 내용 칸이 그대로 편집기예요. 캡처를 붙여 넣거나 「/ 이미지」 로 넣으면 커서 자리에 들어가고, 손을 떼면 1초 뒤 저장돼요. 제목 · 심각도 · 분류는 제목 · 분류 수정 에서 바꿔요

AI 에이전트로

AI 앱에 연결하기 를 끝냈다면 이렇게 부탁해요.

에이전트는 같은 절로 문제를 쓰고, 캡처도 그 문제에 올려요. 같은 문제를 다시 올리면 새로 만들지 않고 고쳐요.

같은 문제를 여럿이 말했을 때

문제 하나에 제보 가 여러 개 붙어요. 누가 · 어디서(디스코드 · 노션 · 점검 보고서 …) · 무엇을 말했는지가 「제보」 탭에 한 건씩 남고, 목록의 「제보」 칸에서 몇 명이 겪었는지 보여요.

점검 보고서를 한 번에 넣기

QA 점검처럼 항목이 여러 줄인 보고서는 문제 목록의 점검 보고서 넣기 로 넣어요.

  1. 보고서 이름 · 쓴 사람 · 날짜를 적고 보고서를 붙여 넣어요. 한 줄에 하나, 앞 번호(P0-1 · D3)는 그대로 두세요
  2. 줄 나누기 를 누르면 줄마다 붙일 곳을 골라 둬요 — 비슷한 문제가 있으면 「제보로 붙임」, 없으면 「새 문제」, D 로 시작하면 「정할 것」, 「의도된 동작」 이 들어가면 「버림 후보」
  3. 틀린 줄은 바꾸고(「넣지 않음」 도 있어요) 넣기 를 눌러요. 정할 것은 이슈 하나의 「확인할 것」 으로 모여요

같은 보고서를 다시 넣어도 제보가 두 번 붙지 않아요.

하나씩 확인하기

목록에서 문제를 누르면 오른쪽에 상세가 열려요. 필터는 그대로라 다음 문제로 바로 넘어갈 수 있어요.

어떻게 끝낼지 정하기 (갈래)

문제 상세 속성 칸의 갈래 에서 넷 중 하나를 골라요. AI 에이전트가 조사한 뒤 먼저 골라 두기도 하고, 사람이 언제든 바꿔요. 다시 누르면 비워져요.

갈래 언제 끝내는 법
고친다 스펙과 다르게 동작하거나, 흐름 · 데이터 모델 · 정책이 안 바뀌는 작은 개선 키를 넣은 PR 이 머지되면 저절로 해결
넘긴다 스펙 밖이거나 새 화면 · 흐름, 정해야 할 기준값이 있을 때 기획 요청으로 올리고 해결 에서 종류 「넘김」 + 넘긴 곳 주소. 상태가 「해결 · 보고함」 으로 보여요
묻는다 맞는 동작인지부터 모를 때 질문으로 물어보고, 답이 오면 다른 갈래로
버린다 의도된 동작일 때 근거를 달고 버림. 버림은 사람만 정해요. AI 는 「버림 후보」 까지만 남겨요

목록 위 갈래 칩으로 「넘긴다」 · 「갈래 미정」 같은 것만 모아 볼 수 있어요.

Esc 나 바깥을 누르면 닫혀요. 새 탭으로 보려면 ⌘(또는 Ctrl)을 누른 채로 눌러요.

PR 로 해결까지 이어 가기

문제마다 번호가 있어요. 목록 제목 앞의 bug-12 같은 글자가 그 문제의 키예요(불편은 ux-, 보안은 sec-, 그 밖은 p-). 문제 상세의 개발 칸에서 복사할 수 있어요.

고치는 PR 의 제목이나 브랜치 이름에 키를 넣어요.

PR 이 열리면 문제가 진행 중 으로, 머지되면 해결 로 바뀌고 해결 내역에 PR 주소가 남아요. 목록의 PR 칸에서 열림 · 머지됨을 바로 볼 수 있어요. 키 여러 개를 넣으면 전부 바뀌어요.

댓글로 같이 이야기하기

문제 상세의 분석 아래에 댓글을 남겨요. 밖에서 들어온 제보와 따로 쌓여요.

AI 에이전트에게 「이 문제에 댓글 남겨 줘」 라고 해도 같은 자리에 내 이름으로 남아요.

누가 맡고 누가 해결했나

문제 상세 위쪽 속성 칸에서 상태 · 담당 · 찾은 사람을 바로 바꿔요. 찾은 사람을 안 정했으면 처음 말한 제보자 이름이 보여요.

담당 에서 팀 멤버를 고르면 그 사람이 맡은 문제가 돼요. 해결로 바꾸면 담당이 해결한 것으로 세요. 다른 사람이 고쳤으면 담당을 그 사람으로 바꿔 주세요.

¿Sigue sin resolverse? Contáctanos