문제는 테스트하다 찾은 버그 · 불편 · 보안 걱정 하나예요. 요청 하나를 끝까지 끌고 가는 이슈 보다 가볍고, 많이 모아 두고 하나씩 정리해요.
문제 하나에 무엇을 적나요
문제만 읽어도 무엇이 · 어디서 · 왜 잘못됐는지 알 수 있게, 늘 같은 절로 적어요.
| 절 | 적는 것 |
|---|---|
| 한 줄 요약 | 무엇이 · 누구에게 · 왜 문제인가 |
| 어디서 | 화면 · 역할 · 기기 |
| 재현 · 기대 · 실제 | 어떻게 하면 다시 보이나, 무엇을 기대했고 실제로는 어땠나 |
| 화면 | 캡처 |
| 원인 | 확인됨 · 추정 · 아직 몰라요 + 근거 |
| 고칠 곳 · 영향 | 어디를 고치면 되나, 누가 얼마나 막히나 |
| 관련 | 관련 PR · 다른 문제 |
모르는 절은 「아직 없어요」 로 남겨 두면 무엇이 비었는지 보여요.
콘솔에서 직접
- 프로젝트 › 작업 › 문제 › 문제 추가 — 내용 칸이 위 절로 채워져 있어요
- 제목 · 심각도 · 분류 · 상태를 고르고 절을 채워요. 「/」 를 누르면 표 · 체크리스트 · 코드를 넣을 수 있어요
- 만든 뒤 문제 화면의 내용 칸이 그대로 편집기예요. 캡처를 붙여 넣거나 「/ 이미지」 로 넣으면 커서 자리에 들어가고, 손을 떼면 1초 뒤 저장돼요. 제목 · 심각도 · 분류는 제목 · 분류 수정 에서 바꿔요
AI 에이전트로
AI 앱에 연결하기 를 끝냈다면 이렇게 부탁해요.
- "디스코드 QA 채널 글이랑 댓글을 모아서 Prober 문제로 정리해 줘"
- "이 버그 원인을 코드에서 찾아서 문제에 채워 줘"
에이전트는 같은 절로 문제를 쓰고, 캡처도 그 문제에 올려요. 같은 문제를 다시 올리면 새로 만들지 않고 고쳐요.
같은 문제를 여럿이 말했을 때
문제 하나에 제보 가 여러 개 붙어요. 누가 · 어디서(디스코드 · 노션 · 점검 보고서 …) · 무엇을 말했는지가 「제보」 탭에 한 건씩 남고, 목록의 「제보」 칸에서 몇 명이 겪었는지 보여요.
- 같은 문제로 보이면 다른 문제에 합치기 — 제보가 옮겨 가고, 이 문제는 「합침」 으로 남아요. 「합침 풀기」 로 되돌릴 수 있어요
- 같은 문제가 아니었으면 제보 카드의 다른 문제로 옮기기
- 「합칠 후보」 · 「버림 후보」 는 AI 가 남긴 제안이에요. 확정은 사람이 해요
- 제보에 분석을 바꿀 내용이 있으면 제보 카드의 분석에 반영 — 원문이 「원인」 아래 인용으로 바로 들어가요. 내용 칸에서 그대로 다듬으면 돼요(잘못 넣었으면 알림의 「되돌리기」)
점검 보고서를 한 번에 넣기
QA 점검처럼 항목이 여러 줄인 보고서는 문제 목록의 점검 보고서 넣기 로 넣어요.
- 보고서 이름 · 쓴 사람 · 날짜를 적고 보고서를 붙여 넣어요. 한 줄에 하나, 앞 번호(P0-1 · D3)는 그대로 두세요
- 줄 나누기 를 누르면 줄마다 붙일 곳을 골라 둬요 — 비슷한 문제가 있으면 「제보로 붙임」, 없으면 「새 문제」, D 로 시작하면 「정할 것」, 「의도된 동작」 이 들어가면 「버림 후보」
- 틀린 줄은 바꾸고(「넣지 않음」 도 있어요) 넣기 를 눌러요. 정할 것은 이슈 하나의 「확인할 것」 으로 모여요
같은 보고서를 다시 넣어도 제보가 두 번 붙지 않아요.
하나씩 확인하기
목록에서 문제를 누르면 오른쪽에 상세가 열려요. 필터는 그대로라 다음 문제로 바로 넘어갈 수 있어요.
- 고칠 것 → 그대로 두거나 진행 중
- 문제가 아닌 것 → 버림
- 미룰 것 → 보류
- 고쳐진 것 → 해결 — 고친 PR 주소나 한두 줄 메모를 같이 적어요. 나중에 「왜 해결이지?」 를 여기서 봐요
어떻게 끝낼지 정하기 (갈래)
문제 상세 속성 칸의 갈래 에서 넷 중 하나를 골라요. AI 에이전트가 조사한 뒤 먼저 골라 두기도 하고, 사람이 언제든 바꿔요. 다시 누르면 비워져요.
| 갈래 | 언제 | 끝내는 법 |
|---|---|---|
| 고친다 | 스펙과 다르게 동작하거나, 흐름 · 데이터 모델 · 정책이 안 바뀌는 작은 개선 | 키를 넣은 PR 이 머지되면 저절로 해결 |
| 넘긴다 | 스펙 밖이거나 새 화면 · 흐름, 정해야 할 기준값이 있을 때 | 기획 요청으로 올리고 해결 에서 종류 「넘김」 + 넘긴 곳 주소. 상태가 「해결 · 보고함」 으로 보여요 |
| 묻는다 | 맞는 동작인지부터 모를 때 | 질문으로 물어보고, 답이 오면 다른 갈래로 |
| 버린다 | 의도된 동작일 때 | 근거를 달고 버림. 버림은 사람만 정해요. AI 는 「버림 후보」 까지만 남겨요 |
목록 위 갈래 칩으로 「넘긴다」 · 「갈래 미정」 같은 것만 모아 볼 수 있어요.
Esc 나 바깥을 누르면 닫혀요. 새 탭으로 보려면 ⌘(또는 Ctrl)을 누른 채로 눌러요.
PR 로 해결까지 이어 가기
문제마다 번호가 있어요. 목록 제목 앞의 bug-12 같은 글자가 그 문제의 키예요(불편은 ux-, 보안은 sec-, 그 밖은 p-). 문제 상세의 개발 칸에서 복사할 수 있어요.
고치는 PR 의 제목이나 브랜치 이름에 키를 넣어요.
- 제목:
[bug-12] 출석 체크 버튼이 안 눌려요 - 브랜치:
fix/bug-12-attendance
PR 이 열리면 문제가 진행 중 으로, 머지되면 해결 로 바뀌고 해결 내역에 PR 주소가 남아요. 목록의 PR 칸에서 열림 · 머지됨을 바로 볼 수 있어요. 키 여러 개를 넣으면 전부 바뀌어요.
- PR 본문에 적은 키는 보지 않아요. 「bug-12 와 비슷해요」 같은 말로 문제가 닫히지 않게요
- 버림으로 정한 문제는 PR 이 머지돼도 그대로예요. 해결로 바뀐 걸 다시 열어도 같은 PR 이 또 닫지 않아요
- PR 이 Prober 에 들어와야 해요. 레포를 아직 안 이었다면 레포 연결하기 부터 해 주세요
댓글로 같이 이야기하기
문제 상세의 분석 아래에 댓글을 남겨요. 밖에서 들어온 제보와 따로 쌓여요.
- 본문처럼
/로 표 · 체크리스트 · 코드 · 그림 · 파일을 넣고, 그림은 붙여 넣어도 올라가요 @를 치면 이 프로젝트를 볼 수 있는 팀원이 나와요. 부른 사람에게 알림이 가요- 답글 로 그 댓글 아래에 이어서 달아요. 내 댓글에 답글이 달리거나 누가 나를
@로 부르면 알림함과 메일로 바로 와요. 「댓글 보기」 를 누르면 그 댓글로 내려가요. 메일이 많으면 내 프로필 › 알림 › 메일로 받기 를 끄세요(알림함에는 계속 와요) - 내 댓글은 아래 「수정」을 눌러 고치고 「저장」해요(「수정됨」 표시).
@로 부른 사람은 이름표로 보여요. 삭제는 쓴 사람과 관리자만 할 수 있어요 - 그림은 10MB, 파일은 25MB, 댓글 하나에 10개까지 올려요. SVG · HTML 은 받지 않아요
AI 에이전트에게 「이 문제에 댓글 남겨 줘」 라고 해도 같은 자리에 내 이름으로 남아요.
누가 맡고 누가 해결했나
문제 상세 위쪽 속성 칸에서 상태 · 담당 · 찾은 사람을 바로 바꿔요. 찾은 사람을 안 정했으면 처음 말한 제보자 이름이 보여요.
담당 에서 팀 멤버를 고르면 그 사람이 맡은 문제가 돼요. 해결로 바꾸면 담당이 해결한 것으로 세요. 다른 사람이 고쳤으면 담당을 그 사람으로 바꿔 주세요.
- 목록에서는 담당 열과 「담당 전체 · 담당 없음 · 사람」 필터로 거를 수 있어요
- 팀 설정 › 팀 멤버에서 이름을 누르면 그 사람의 상세가 열려요. 맡은 문제 · 해결한 수 · 최근 12주 동안 주마다 해결한 수를 보고, 상태도 그 자리에서 바꿔요
- AI 에이전트로 올릴 때는 담당할 멤버를 같이 말하면 돼요