화면 소개

요구를 넣고 나면 사람이 할 일은 지켜보는 것입니다. 이 장은 그 순서대로 화면을 훑습니다. 큐 전체를 보는 보드에서 시작해 티켓 하나로 들어가고, 거기서 그 티켓을 붙잡고 있는 세션이 지금 무엇을 하는 중인지까지 내려갑니다.

프로젝트 안에서는 헤더에 화면 다섯이 걸려 있습니다. 보드·페르소나·프로토콜·온톨로지·워커. 뒤의 셋은 각자 자기 장이 있습니다(페르소나 · 프로토콜 · 아카이빙과 온톨로지). 여기서는 보드와 워커, 그리고 헤더 양 끝에 붙은 것들을 봅니다.

보드

화면을 세로로 가르는 칸이 셋 보입니다. 이 칸 하나를 레인이라고 부르고, 왼쪽부터 대기 · 진행중 · 완료입니다. 카드 하나가 티켓 파일 하나입니다.

카드는 사람이 끌어다 옮기는 것이 아닙니다. 파일명 접미사가 바뀌면 카드가 저절로 옆 레인으로 넘어갑니다(티켓이 지나는 상태 참고). 상태를 정하는 쪽이 엔진이라 사람이 카드를 옮겨 놓을 자리가 없습니다.

• 막힌 티켓도 대기 레인에 같이 앉습니다. 갈리는 것은 카드에 붙는 주황색 deps 태그 하나입니다. 막힘은 그 단계 안의 사정이라 선행이 끝나면 아무도 손대지 않아도 사라집니다.
• 진행중 카드는 세 가지를 더 말합니다. 페르소나 색 점이 움직이고, 메타 줄 끝에 지금 그 티켓을 물고 있는 워커 마크(w6)가 붙고, 카드 맨 아래에 그 세션이 방금 한 일이 한 줄로 섭니다. 완료 카드에는 셋 다 없습니다. 끝난 티켓의 owner는 기록입니다. 지금 그 티켓을 물고 있는 워커가 아닙니다.
• 아카이브 티켓이 걸린 완료 카드는 그 자리에 아카이빙이 어디까지 갔는지를 답니다. 아카이빙 대기·아카이빙중·아카이빙 답변 대기 셋입니다 (아카이빙과 온톨로지 참고).
• 완료 레인은 한 번에 20건을 그립니다. 바닥까지 내려가면 20건이 더 붙습니다. 완료를 숨긴 것은 아니고 나눠 그리는 것뿐입니다. 한눈에 훑고 싶으면 테이블 뷰(?view=table)와 필터가 있습니다.

티켓 상세

카드를 누르면 티켓 하나의 화면이 열립니다. 왼쪽은 읽고 쓰는 것, 오른쪽은 곁눈으로 참조하는 것으로 갈립니다.

• 왼쪽에는 사람이 쓴 마크다운 본문과 ## Done when 체크리스트가 있습니다. 진행 기록도 여기 섭니다.
• 오른쪽에는 frontmatter 표와 관계가 섭니다. frontmatter는 티켓 파일 맨 위에 --- 두 줄 사이로 적어 두는 설정값 묶음입니다. 관계는 맨 위 한 줄이 [선행] 이 티켓 [후행]을 그립니다. 그 아래로는 이 티켓이 어느 요구에서 나왔는지(출처 req:)와 이 티켓을 기록으로 옮긴 아카이브 티켓이 있을 때만 한 줄씩 더 붙습니다.

Done when 체크는 세션이 일하면서 켭니다. 사람이 누르는 상자가 아닙니다. 그 항목이 끝났는지 아는 것은 그 일을 하고 있는 세션뿐입니다. 그래서 항목을 하나 끝낼 때마다 세션이 티켓 파일의 - [ ]를 - [x]로 바꿉니다. 도는 티켓을 열어 지금 어디까지 갔는지 보는 자리가 여기입니다. .wip 티켓의 본문은 파일이 바뀌면 새로고침 없이 따라갑니다.

진행중 티켓은 읽기만 됩니다. 세션이 그 파일을 쥐고 있어서입니다. 잠금 카드 안의 할당 해제를 누르면 그 파일이 큐로 되돌아갑니다. 그다음에야 손으로 고칠 수 있습니다.

세션 스트림

티켓을 물고 있는 세션의 진행을 실시간으로 봅니다. 파일이 길어지는 대로 화면이 따라 붙는 tail -f 명령과 같은 모양입니다. 기본은 사건 한 줄씩입니다. 무슨 파일을 읽었나, 무슨 명령을 돌렸나, 무엇을 썼나. 줄을 펼치면 그 사건의 원문이 나옵니다.

• 원본은 앱이 새로 남기는 로그가 아닙니다. Claude Code가 이미 실시간으로 쓰고 있는 자기 트랜스크립트를 읽습니다. 트랜스크립트는 세션이 주고받은 말과 도구 호출을 순서대로 적어 둔 기록 파일입니다. 화면을 위해 늘어나는 파일은 0개입니다.
• 끝난 세션의 리플레이도 같은 자리입니다. 완료 티켓을 열면 그 세션이 무엇을 하다 끝냈는지가 같은 모양으로 남아 있습니다.
• 스트림이 있는 엔진은 claude와 grok뿐입니다. codex나 agy 워커가 물고 있는 티켓에는 이 자리가 빕니다. 어느 엔진이라 비었는지는 그 자리가 말해 줍니다. 트랜스크립트를 안 남기는 엔진이라 없는 것이지 고장은 아닙니다.

진행 기록

스트림 줄과 질문·답변 말풍선은 한 상자에 시간순으로 놓입니다. 절 이름이 진행 기록인 이유가 이것입니다. 이 자리가 답하는 물음은 하나입니다. 이 티켓에 지금까지 무슨 일이 있었나.

세션이 막혀 질문을 올리고 사람이 답을 쓰는 왕복은 원래 세션 진행의 앞뒤입니다. 그래서 상자도 스크롤도 하나고 입력칸도 하나입니다. 칸이 무엇을 하는 칸인지는 티켓 상태가 정합니다. 셋은 서로 배타적입니다.

답이 아직 없는 질문은 맨 끝에 섭니다. 바로 밑이 그 답을 쓰는 칸이라 물음과 답이 붙어 있습니다.

워커

열은 여덟입니다. 이름, 상태, 물고 있는 티켓, 컨텍스트, 마지막 활동, pid, 토큰(5시간), 액션. 컨텍스트 셀은 그 자체가 토글입니다. 누르면 이 워커가 세션에 실어 주는 파일 목록이 아래로 펼쳐집니다.

행마다 pid가 보입니다. pid는 운영체제가 실행 중인 프로그램 하나에 붙이는 번호입니다. 이 번호가 표에 서 있는 이유는 하나입니다. 회수 판정이 프로세스 생존에 걸려 있어서입니다. 걸린 시간이 기준이 아닙니다. 워커가 running인지 stale인지는 그 pid가 지금 살아 있는지로 갈립니다. 살아 있으면 running, 죽었으면 stale입니다. 워커가 큐를 한 번 훑는 다음 tick이 회수합니다. 오래 걸리는 정상 세션과 매달린 세션은 걸린 시간만으로는 못 가립니다.

워커를 늘리는 것도 이 화면입니다(워커 참고).

프로젝트 홈

헤더 로고를 누르면 홈입니다. 여기 서 있는 것은 이 프로젝트를 두고 묻는 대화 하나입니다. 요약 대시보드가 아닙니다. w2가 지금 무슨 일을 하고 있나, 이 프로토콜은 왜 이렇게 돼 있나 같은 물음을 그냥 쓰시면 됩니다. 에이전트가 이 프로젝트의 큐·repo·프로토콜을 읽고 답합니다.

• 좌측 패널에 그룹이 둘입니다. 대화는 세 줄부터 시작해 더보기를 누를 때마다 세 줄씩 열립니다. 워커 세션은 이 큐의 워커들이 물었던 세션입니다. 끝난 것을 고르면 그 맥락 위에서 이어 물을 수 있습니다. 도는 세션에는 여기서 말을 걸 수 없습니다. 그건 티켓 상세의 참견입니다.
• 답은 글자가 도착하는 대로 흐릅니다. 오래 걸리면 중지로 끊으세요.
• 주로 읽지만 쓰기도 합니다. 도구는 Read·Glob·Grep·Write·Edit 다섯입니다. 쓰기가 닿는 자리는 큐 안에 정해져 있습니다. 페르소나 프로필, 프로토콜, 워커 스크립트, 온톨로지, 티켓. 그 밖은 경로 자체가 막혀 있습니다. 워커들이 일하는 워크트리도, 프로젝트 소스도 이 에이전트가 못 엽니다.
• 요구를 여기서 바로 접수할 수도 있습니다. 대화하다 요구사항으로 올려 달라고 하면 kind: request 티켓 한 장이 생기고 pm이 그것을 받습니다. 대화에서 불만을 읽고 알아서 접수하지는 않습니다. 올려 달라고 한 턴에만 씁니다.

알림 종

헤더 우측의 종 하나가 지금 이 프로젝트가 왜 안 도나를 모아 답합니다. 종전에 본문 위에 쌓이던 배너들이 이 그릇으로 들어왔습니다. 일곱 가지입니다. 넓은 것부터 섭니다.

1. 네트워크가 끊겨 있습니다 - 연결이 없으면 인증이 있어도 아무것도 안 됩니다.
2. 잠자기에서 복귀했습니다 / 꺼져 있다가 켜졌습니다 - 큐가 멈춰 있던 구간을 말합니다. 잃은 것은 없고 고칠 일도 없습니다.
3. Claude 토큰이 없습니다 - 인증이 안 돼 세션이 뜨지 못합니다(인증 참고).
4. 세션이 열리자마자 죽는 워커 - 외부 요인입니다.
5. 아무도 집지 않는 티켓 - 할당됨으로 굳어 레인에도 없는 티켓들입니다.
6. 답변을 기다리는 티켓 - 사람이 답을 써야 그 프로젝트가 다시 돕니다.
7. 마감을 못 지킬 티켓 - 마감이 지났거나, 선행이 안 풀린 채로 마감이 가까워졌습니다.

• 배지는 켜진 알림의 개수(0~7)이고 건수 합계가 아닙니다. 단위가 서로 다른 일곱을 한 수로 합치면 그 수가 무엇 몇 개인지 화면 어디에도 없게 됩니다. 각 항목이 자기 건수를 자기 제목에 적습니다.
• 원인이 풀리면 배지가 저절로 내려갑니다. 5초마다 다시 판정하기 때문입니다. 알림을 닫아 두는 자리는 따로 없습니다.
• 손으로 지울 수 있는 항목은 둘입니다. 세션이 열리자마자 죽는 워커와 복귀 알림에만 읽음으로 표시가 붙습니다. 둘 다 사람이 고칠 것이 없는 사실이라 읽었다고만 말하면 됩니다. 나머지는 손을 대야 꺼집니다. 토큰을 저장하고, 할당을 풀고, 답을 쓰고, 마감을 다시 잡아야 합니다. 읽음으로 덮어 버리면 그 손이 안 옵니다.
• 지운 것은 그 사고 하나입니다. 눌러서 항목이 사라져도 다음 실패까지 묻히지는 않습니다. 새 실패가 오면 다시 뜹니다.
• 0건이어도 종은 서 있습니다. 눌리고, 열리고, 알림 없음이라고 말합니다.

하단 토큰 status bar

화면 맨 아래 얇은 한 줄에 이 프로젝트 워커들이 쓰는 엔진마다 한 칸이 섭니다. 토큰이 얼마나 남았는지 보려고 앱을 떠나지 않게 하는 것이 이 줄의 전부입니다.

• 칸이 무엇을 말하느냐는 그 엔진이 자기 잔여를 알려주는지에 달렸습니다. 알려주면 n% 사용과 그 수가 어느 창의 값인지, 최근 10분 소모 속도, 리셋 시각이 섭니다.
• claude 칸에는 %도 리셋 시각도 상시 없습니다. claude setup-token이 내주는 장기 토큰은 자기 잔여를 읽을 권한이 없습니다. 그 자리에는 활성 계정 이름과 최근 5시간 누적 토큰, 소모 속도가 섭니다. 없는 수를 추정해 그리지 않습니다.
• 창 길이는 엔진이 준 값을 그대로 씁니다. 5시간·7일처럼 % 바로 옆에 붙습니다. 하나의 창을 두 엔진에 씌우면 둘 중 하나가 거짓이 됩니다.
• 워커별로 갈리는 것은 쓴 양뿐입니다. 남은 양은 머신·계정당 하나고 워커 전원이 그 한 통을 나눠 씁니다. 그래서 계정 단위 값은 이 바에, 워커별 소비는 워커 화면에 있습니다.
• 소비 합계는 세션이 끝나야 잡힙니다. 90분짜리 세션은 90분 동안 0으로 보이고, 신호로 죽은 세션의 토큰은 영영 오지 않습니다. 그래서 워커 화면의 최근 5시간 토큰 옆에 이 합계에 없는 세션 n개가 같이 섭니다. 침묵하면 사람이 "덜 썼다"로 읽습니다.

설정 다이얼로그

우측 위 톱니바퀴 하나가 다이얼로그를 엽니다. 왼쪽에 검색칸과 항목 트리가 있고 고른 항목의 패널이 오른쪽에 섭니다. 항목 이름이 기억나지 않으면 검색칸에 쳐 보세요. 트리를 훑지 않고 바로 갑니다.

• 인증 - claude가 맨 위고 그 아래로 codex·grok·agy가 한 줄씩 섭니다. cron에 물린 워커가 쓰는 장기 토큰을 여기서 넣습니다. 발급 명령은 화면이 대신 실행해 줍니다. 자세한 것은 인증에 있습니다.
• 키설정 - 화면 단축키를 보고 바꾸는 자리입니다.
• 사용 통계 - 사용 통계와 끄는 법에서 다룹니다.
• 언어 - 화면 문구를 한국어와 영어 사이에서 고릅니다.

이 설정은 전부 이 컴퓨터의 것이고 등록된 프로젝트 전부에 걸립니다. 프로젝트마다 다르게 두는 자리가 아닙니다.

프로젝트 목록

앱을 열었을 때 보이는 첫 화면입니다. 프로젝트 안에서 여기로 돌아오려면 헤더의 프로젝트 전환기를 열고 맨 아래 프로젝트 관리를 누르세요. 맨 위에 등록한 프로젝트가 표로 서고 아래로 제품 소개가 이어집니다. 소개 쪽은 웹에서 보는 페이지와 같은 글입니다. 앱에서는 목록이 그 위에 얹혀 첫 화면이 됩니다.

• 행 하나가 프로젝트 하나입니다. 열은 이름·경로·열림·진행중·완료·연결·액션입니다. 이름을 누르면 그 프로젝트의 보드입니다.
• 연결이 안 된 프로젝트는 건수 세 자리가 비어 있습니다. 0이 아닙니다. 못 읽은 것과 0건은 다른 사실입니다.
• 헤더 오른쪽은 매뉴얼·Star·새로 만들기·설정입니다. 여기의 설정은 톱니가 아니라 글자입니다.
• 등록된 프로젝트가 0건이면 표 자리에 만드는 폼이 펼쳐지고, 헤더에서는 새로 만들기가 빠집니다(첫 프로젝트 만들기 참고).

매뉴얼로 오가는 길

헤더 오른쪽의 매뉴얼이 이 문서를 엽니다. 프로젝트 안의 화면이 헤더를 같이 쓰니 보드에서 누르든 워커 화면에서 누르든 같은 자리입니다.

앱에서 이 문서를 열면 매뉴얼 헤더에도 프로젝트 관리가 섭니다. 읽다 말고 화면으로 건너갔다 돌아오는 왕복이 그 두 버튼입니다. 웹에서 읽고 계시다면 그 버튼이 없습니다. 앱 안에서만 서는 자리입니다.

다음은 도는 세션에 말 걸기입니다.