Paseo Progress 플러그인: 긴 에이전트 작업을 질문·산출물 중심으로 추적하기
에이전트가 한 시간째 작업 중인데 로그는 길고 결과는 보이지 않는다. “거의 끝났나?”를 알아보려고 대화를 계속 훑게 된다. Progress는 이런 장기 작업을 단계, 막힌 일, 질문과 산출물로 나눠 보여주는 worktree 단위 대시보드다.
조사 기준: 2026-11-07 Progress 1.14.0 공개 소개. 요구사항은 Paseo 0.13 이상, 데몬 머신의 Node.js 22.18 이상이다. 아래 운영 예시는 제안이며, 플러그인 실행 성능을 측정한 후기는 아니다.
1. 진행률은 에이전트의 기록에서 나온다
Progress는 에이전트가 도구나 paseo-progress 명령으로 기록한 파일을 읽는다. 대화 전체를 이해해 완료율을 자동 추론하는 시스템으로 생각하면 안 된다. 기록이 없으면 패널도 업데이트되지 않는다.
paseo plugin add stevecastaneda/progress
설치 후 Explorer의 Progress 패널에서 현재 단계, 작업 상태, 활동과 산출물을 확인하는 흐름이다. 추정 시간을 넘겼는데 갱신이 없거나 명시적으로 막혔다고 기록된 작업은 stuck으로 나타날 수 있다. 따라서 stuck은 “프로세스가 죽었다”는 단일 의미가 아니다. 에이전트가 기다리는지, 업데이트를 누락했는지, 실제 오류가 있는지 대화와 함께 봐야 한다.
2. 설치 완료와 기록 준비 완료는 다른 단계다
현재 소개는 두 연결 방식을 설명한다. Paseo 0.14 이상에서는 Settings → 대상 호스트 → Agents → Enable Paseo tools를 켜면 Progress 도구를 사용할 수 있다. 이 설정은 다른 에이전트를 시작·메시지 전송·중단하는 도구도 허용하므로 Progress 전용 스위치로 오해하지 않는다.
도구를 사용하지 않는 환경에서는 패널의 Install command가 데몬 머신에 명령을 준비한다. Install skill은 에이전트가 기록 절차를 알도록 스킬을 연결하며 새 세션에서 읽힌다. 공개 소개에 따르면 이 버튼들은 쓰기 위치를 먼저 보여주고 플러그인에 포함된 파일을 사용한다.
중요한 확인은 “패널이 보이는가” 다음에 있다. 작은 시험 작업을 맡겨 시작 상태, 중간 갱신, 완료 산출물이 실제 반영되는지 본다. 이 과정 없이 큰 작업부터 맡기면 기록 누락을 작업 지연으로 잘못 해석할 수 있다.
3. 단계는 퍼센트보다 검증 가능한 결과로 나눈다
권장하는 작업 지시 예시는 다음과 같다.
작업을 재현 조사, 수정, 집중 테스트, 최종 검수로 나눠 기록하라.
각 단계에는 완료 기준과 예상 소요를 적어라.
상태가 바뀌거나 막혔을 때 기록을 갱신하라.
완료 산출물에는 변경 파일, 검사 결과, 남은 제한을 연결하라.
질문이 필요하면 선택지와 진행에 미치는 영향을 함께 제시하라.
“80% 완료”보다 “회귀 테스트를 추가했고 현재 실패를 재현함”이 검토자에게 더 많은 정보를 준다. 추정치 기반 완료율은 방향을 알려 줄 뿐 품질 증거는 아니다. 예상보다 오래 걸렸다면 시간을 부풀리기보다 새로 발견한 조건과 다음 확인을 남기는 편이 낫다.
4. 질문 대기 정책을 업무에 맞춘다
Progress는 번호가 있는 질문과 선택지를 표시하고, 사용자가 답을 채팅에 전달하면 에이전트가 기록하는 흐름을 제공한다. 설정에는 기다리는 동안 멈추기, 관련 없는 일을 진행하기, 권장 선택을 기반으로 계속하기 같은 정책이 있다.
이 설정은 모든 결정을 대신 승인한다는 뜻으로 사용해서는 안 된다. 예를 들어 UI 문구의 임시 선택과 운영 데이터 변경의 승인은 성격이 다르다. 권장 운영 방식은 되돌리기 쉬운 선택에는 가정을 기록하고, 외부 영향이 큰 결정에는 해당 승인을 기다리도록 작업 지시에 구분하는 것이다.
답을 Copy한 사실만으로 에이전트에 전달된 것은 아니다. 채팅으로 전달됐는지, 질문 상태가 갱신됐는지까지 확인하면 “사용자는 답했다고 생각하고 에이전트는 기다리는” 상황을 줄일 수 있다.
5. 산출물의 실제 위치와 보관 정책을 확인한다
기본 데이터는 데몬 머신의 ~/.local/state/paseo-progress/ 아래에 worktree별로 보관된다. 공개 소개상 전체 worktree를 한 화면으로 합치는 기능은 없으며, 삭제된 worktree의 데이터 폴더도 별도로 남을 수 있다. 저장소 안의 폴더에 실행 기록을 저장하는 선택지도 제공한다.
파일의 Open 동작은 휴대폰에서 누르더라도 데몬 머신의 앱을 여는 경우가 있다. 미리보기 지원도 형식과 클라이언트에 따라 다르다. 특히 PDF·영상은 모바일과 Desktop의 표시 경로가 같다고 가정하지 않는다.
작업 종료 시에는 최종 요약, 테스트 기록과 중요한 산출물이 나중에도 접근 가능한 위치에 있는지 확인한다. Progress를 잘 쓰는 팀의 기준은 예쁜 진행 막대가 아니라, 긴 대화를 다시 읽지 않고도 현재 판단과 완료 근거를 찾을 수 있는가다.
댓글
댓글 쓰기