데스크톱 에이전트 프로젝트: 매니저 한 명과 보드 하나
위젯스토어 데스크톱 에이전트 프로젝트: 목표를 말하면 매니저가 저장소를 읽고 이슈를 제안해요. 고른 것은 여러 에이전트가 동시에 작업하고 자동으로 검토한 뒤 내 승인을 기다려요. 내가 처리할 일은 한곳에 모여요.
프로젝트는 상주하는 매니저와 보드로 이뤄져요. 나는 목표를 말하고, 제안을 고르고, 결과를 승인하기만 하면 돼요. 계획, 배정, 진행 확인, 검토는 매니저와 작업자가 해요.
프로젝트 만들기
- 데스크톱 사이드바에서 에이전트를 열고 프로젝트(또는 위쪽의 과녁 아이콘)를 눌러요.
- 목표를 적어요. 예: "설정 화면에 다크 모드를 넣고 라이트·다크 스크린샷으로 확인".
- 저장소를 골라요(git 저장소여야 해요. 최근에 쓴 것이 보여요).
- 시작 방법을 골라요:
- 먼저 제안, 내가 고르기(기본): 계획이 ‘제안’에 들어가고 고른 것부터 시작해요.
- 바로 시작: 첫 묶음이 계획되는 즉시 배정해요.
- 자동 운행도 함께 켤 수 있어요(아래 참고).
- 프로젝트 만들기(⌘↵)를 눌러요. 에이전트, 동시 실행 수, 검사 명령을 바꾸려면 옵션 더 보기…를 써요.
기본값: Claude Code가 매니저예요. 작업자는 파일을 고칠 수 있지만 명령은 터미널에서 물어봐요. 이슈마다 별도 작업 공간과 브랜치를 쓰고, 동시에 최대 3개를 해요. 검사 명령을 통과한 작은 변경(파일 20개 / 600줄 이하, 민감한 파일 없음)은 로컬 기준 브랜치에 자동으로 병합하고, 큰 변경이나 검사를 통과하지 못한 것은 ‘검토 대기’에서 내 승인을 기다려요(1.23.7부터. 프로젝트 설정에서 모두 확인을 기다리게 할 수도 있어요).
왼쪽: 매니저와 대화
- 매니저는 저장소 규칙, 문서, 지난 이슈, 각 작업자의 현재 상태를 읽고 진행 상황을 알려 주며 "왜 이렇게 오래 걸려?" 같은 질문에도 답해요.
- 다음 묶음 제안은 체크 목록으로 보여요. ‘선택한 것 시작’으로 한 번에 시작하고 ‘나머지 보류’로 정리해요.
- 결정이 필요하면 분명하게 질문해요(노란 카드). 질문은 ‘확인 필요’에도 나타나요.
- 메시지 속 이슈 번호(WF-3 등), PR, 브랜치, 문서 이름은 누를 수 있어요.
- 입력창 아래 ‘이 Mac / 이 컴퓨터’는 실행 위치예요. ‘클라우드’는 곧 지원돼요.
오른쪽: 이슈 보드
이슈마다 프로젝트 접두어와 번호(WF-12 등)가 붙어요. 상태는 제안 · 대기 · 작업 중 · 확인 필요 · 검토 대기 · 완료 · 보류예요.
- 목록: ‘확인 필요 → 검토 대기 → 작업 중 → 대기 → 제안’ 순서로 보여요. 작업 중인 줄에는 터미널 마지막 줄과 단계 막대가 실시간으로 보여요.
- 보드: 카드를 끌어 상태를 바꿔요. ‘대기’에 놓으면 시작, ‘검토 대기’에서 ‘완료’로 옮기면 승인 후 병합, ‘보류’에 놓으면 취소예요. 허용되지 않는 이동(제안을 바로 완료로 등)은 이유를 알려 줘요.
- 라이브러리: 매니저 메모(개요, 결정 사항, 교훈), 일일 요약, 바뀐 Markdown 문서, PR, 브랜치, 검토 근거와 테스트 결과.
- 이슈마다 결과물을 보여 줘요: PR, 브랜치, 커밋 수, 바뀐 줄 수, 바뀐 문서, 검사 통과 여부, 비용.
- 검색은 제목, 파일, 브랜치를 찾아요.
이슈 패널
이슈를 누르면 패널이 열려요: 현재 단계, 막힌 이유와 해결 방법, 매니저 검토, 작업자 보고, 완료 기준, 소요 시간과 비용, 바뀐 파일, 스크린샷과 녹화 근거, 터미널 최근 출력, 관련 대화. 동작:
- 승인 후 병합: 기준 브랜치에 병합해요(기본 폴더가 기준 브랜치에 있고 커밋하지 않은 변경이 없어야 해요).
- 돌려보내기: 고칠 점을 적으면 작업자에게 그대로 보내요.
- 계속하게 하기 / 작업자에게 말하기: 작업자가 한가해지면 전달돼요.
- 터미널 열기: 승인을 기다리는 작업자로 바로 가요.
- 채팅으로 보내기: ‘메시지’를 열어 이슈를 카드로 친구나 그룹에 보내요.
확인 필요
사이드바 맨 위 확인 필요에 모든 프로젝트에서 나를 기다리는 일을 모아요: 매니저의 질문, 검토 대기, 막힌 이슈, 기다리는 개별 작업, 고를 제안. 사이드바 배지도 같은 숫자이고, 새 항목은 시스템 알림으로 알려 드려요.
매니저 메모
프로젝트마다 프로젝트 개요, 결정 사항, 교훈과 규칙 세 문서가 있어요. 매번 계획과 모든 작업자에게 함께 전달되고, 라이브러리에서 바로 고칠 수 있어요. 보류할 때 적은 이유는 교훈에 추가돼 비슷한 제안을 다시 하지 않아요.
자동 운행
프로젝트 위쪽의 자동 운행을 켜면 묶음이 끝날 때마다 매니저가 목표를 향해 다음 묶음을 계획하고 바로 시작해요(Loops는 이제 이 스위치예요):
- 제안은 먼저 걸러져요. 목표와 무관한 것, 결정이 필요한 문제, 교훈에서 제외한 것, 바꿀 필요 없다고 판단된 것은 배정하지 않아요.
- 작업자가 두 번 연속 바꿀 게 없다고 하면 한 번 다시 계획하고, 그래도 같으면 이유와 함께 멈춰요.
- 하루 이슈 수와 예상 비용에 한도가 있어요(기본 6개·5달러, 프로젝트 설정에서 변경). 내 에이전트 요금제를 써요.
- 검토를 통과한 작은 변경(파일 20개 / 600줄 이하, 검사 통과, CI·배포·비밀 파일 제외)은 로컬 기준 브랜치에 자동으로 병합하고, 나머지는 내 승인을 기다려요. 푸시는 하지 않아요. 프로젝트 설정에서 모두 확인을 기다리게 할 수도 있어요.
사전 허용 명령
프로젝트 설정에 ‘사전 허용 명령’ 목록(한 줄에 접두어 하나)이 있어요. 일치하는 명령은 터미널에서 묻지 않고 실행하고, 나머지는 그대로 승인을 물어요.
- 새 프로젝트에는 읽기·빌드 명령이 미리 들어가요:
git status,git diff,git log, 그리고 저장소의 테스트·lint·타입 검사·빌드 명령. - 푸시, 삭제, 패키지 설치, 기록 변경,
;|&&같은 기호가 들어간 명령은 넣을 수 없어요. - 작업자가 안전한 명령에서 자꾸 멈추면 매니저가 추가를 제안해요. 제안은 ‘확인 필요’에 나타나고 ‘허용’을 눌러야 적용돼요.
- 지금은 Claude Code에서 동작해요. Codex 등은 계속 터미널에서 물어봐요.
신호
신호는 정해진 간격으로 저장소를 확인하고, 문제가 생기면 근거 링크(CI 실행 페이지 등)와 함께 이슈를 자동으로 만들어요:
- CI 실패(GitHub Actions, 이 컴퓨터에
gh로그인 필요) - 검사 명령 실패(기본은 프로젝트 검사 명령)
- Lighthouse 하락(‘주소 최소 점수’ 입력, 예:
https://example.com 90) - Sentry 새 문제(
sentry-cli로그인 필요) - 목록의 미완료 항목(저장소 안의 목록 파일 입력)
신호마다 프로젝트 설정에서 켜고 끌 수 있어요. 같은 문제는 두 번 만들지 않고, 보류한 것은 다시 제안하지 않으며, 고친 뒤 다시 생긴 문제는 새로 만들어요. 자동 운행이 켜져 있으면 바로 시작하고, 아니면 ‘제안’에 들어가요. 위쪽 ‘신호 N개’ 버튼으로 바로 확인할 수 있어요.
빠르고 안정적으로: 작업자가 일하는 방식
데스크톱 1.23.7 이상이 필요해요. 작업자가 Claude Code이면 네이티브 headless로 실행해요. 시작하기 전에 매니저가 완전한 지시를 하나 쓰고, 작업자는 그걸 한 번에 끝까지 해요. 실행 중에는 세션에 아무것도 끼워 넣지 않아요. 매니저의 말도, 백그라운드 이벤트도 전달하지 않고, 작업자끼리 메시지를 주고받을 수도 없어요(예전에는 서로 기다리고 승인까지 필요했어요). '작업자에게 말하기'로 보낸 내용은 이번 실행이 끝난 뒤에 전달해요.
- 끝나면 자동으로 마무리: 프로젝트의 검사 명령이 통과하고 변경이 있으면 검토 통과로 보고 이슈 브랜치에 커밋해요. 작은 변경(파일 20개 / 600줄 이하, 민감한 파일 없음)은 기본으로 기준 브랜치에 병합해요(프로젝트 설정에서 '내가 확인한 뒤'로 바꿀 수 있어요). 검사 명령이 없거나 통과하지 못한 이슈만 매니저가 자세히 봐요.
- 멈춰서 기다리지 않아요: 분명히 덜 끝난 채 멈추면('계속할까요?'라고 묻거나 계획만 낸 경우) 같은 세션으로 자동으로 한 번 더 실행해요(최대 3번). 작업자 보고가 BLOCKED로 시작하면 바로 '확인 필요'로 가요.
- 이슈당 한도: 기본은 토큰 200만 개(캐시 읽기 제외) 또는 실행 30분이에요. 한도에 닿으면 멈추고 마무리하게 하고(지금 변경을 남기고 보고), 더 넘으면 지금 변경으로 검토해요. 조사 이슈는 10분까지이고 결론 문서를 내요. 컨텍스트가 16만 토큰을 넘으면 다음 실행은 이전 요약을 들고 새 세션에서 이어 가요. 모두 프로젝트 설정에서 바꿀 수 있고, 작업자의 모델과 추론 강도도 고를 수 있어요.
- 시간이 어디에 쓰였는지 보여요: 이슈 패널의 '시간 분석'에서 대기, 모델 생각, 테스트, 빌드, 승인 대기, 답변 대기, 검토를 나눠 보여 주고, 끼어든 메시지 수와 토큰, 컨텍스트 크기도 보여요. 프로젝트 위쪽에는 오늘 결과 수, 병합 수, 쓴 토큰, 이슈당 평균 시간, 첫 결과까지 걸린 시간, 사람을 기다린 시간 비율이 나와요. 토큰을 50만 개 넘게 쓰고도 아직 변경이 없는 이슈는 빨간색으로 표시해요.
- 매니저는 이슈를 '15~30분, 분명한 검사 명령, 반드시 결과물이 있는' 단위로 나누고, '조사·확인·조율'만 하는 큰 이슈는 만들지 않아요. 서로 기대지 않는 이슈는 바로 동시에 시작해요(새 프로젝트는 동시에 3개).
일일 진행 요약
매일 아침(현지 시간 8시 이후) 움직임이 있던 프로젝트에 진행 요약을 만들어요: 완료한 것, 검토 대기, 막힌 것, 다음 할 일, 오늘 비용. 라이브러리에 저장되고 대화에도 링크가 생겨요. 라이브러리의 ‘지금 요약 만들기’로도 만들 수 있어요.
키보드
j / k 이동, Enter 열기, Esc 패널 닫기, / 검색, c 매니저와 대화, 1–3 목록 / 보드 / 라이브러리, ⌘K(Windows·Linux는 Ctrl K)로 어떤 프로젝트·이슈·동작으로든 이동해요.
안전
- 매니저는 저장소를 읽기만 하고 파일 수정이나 명령 실행은 하지 않아요. 작업자는 각자 작업 공간에서 고치고 푸시하지 않아요.
- 병합은 로컬 기준 브랜치에만 해요. 푸시와 배포는 언제나 직접 해요.
- 프로젝트 기록, 대화, 문서는 이 컴퓨터에만 저장돼요.
최종 업데이트: 2026년 11월 18일