중단된 코딩 Agent 작업을 중복 없이 재개하기

안전한 복구 경계 준비하기

이 튜토리얼은 일부 작업을 수행한 후 멈췄을 수 있는 작업을 위한 것입니다. 중단된 Claude Code 또는 Codex 실행, 연결이 끊긴 외부 Agent 세션, 최종 응답이 도착하지 않은 Cue 요청 등이 해당합니다. 삭제된 파일을 복구하거나 정지된 릴리스를 강제로 진행하기 위한 가이드가 아닙니다.

원래 요청, 올바른 프로젝트와 브랜치, 해당 프로젝트를 검사할 권한, 변경되었을 수 있는 대상 위치에 대한 접근 권한이 필요합니다. Cue Dictation 튜토리얼에 나온 마이크 및 입력 접근 설정을 따르세요. Mac 또는 Windows에서는 설치된 Cue 설정에 표시된 단축키를 사용하세요. 이 실습은 특정 단축키나 미출시 버전에 의존하지 않습니다.

누가 여전히 작업 중인지 알기 전까지는 새 요청 추가를 멈추세요. 적절한 경우 눈에 보이는 중지 또는 취소 컨트롤을 사용한 다음, 작업의 활동 상태와 그것이 시작한 도구, 터미널 또는 작업을 확인하세요. 창 연결 끊김, 응답 취소, 대화 일시 중지가 모든 하위 프로세스나 외부 작업이 중지되었다는 증거는 아닙니다. 또한 취소는 저장된 수정 사항, 전송된 메시지 또는 완료된 배포를 되돌리지 않습니다(Cancel is not undo). 무언가 여전히 동작 중인지 여부를 확인할 수 없다면 복구 과정을 읽기 전용으로 유지하고 담당 운영자나 지원 팀에 상태 확인을 요청하세요.

첫 번째 Agent가 파일을 변경하고 있을 가능성이 있는 동안 동일한 파일에서 두 번째 Agent를 시작하지 마세요. 원래 대화와 기존 파일을 보존하세요. 깔끔한 상태에서 시작하겠다고 저장소를 초기화하거나 작업 기록을 삭제하거나 작업 폴더를 비우지 마세요.

실습: 한 건의 수정 완료, 테스트 미실행, 게시 상태 미상

이 가상 실습에서는 demo-catalog라는 작은 저장소를 사용합니다. 증거 및 예시 출력은 예시일 뿐이며 기록된 실제 Cue, Claude Code 또는 Codex 실행이 아닙니다. 명령을 실행하거나 실제 저장소를 연결하지 않고도 메모에 이 패킷을 정리하며 연습할 수 있습니다.

소스 R-01 — 원래 승인 내용: src/page-size.mjs에서 PAGE_SIZE을(를) 20에서 40으로 변경합니다. MAX_PAGE_SIZE은(는) 100으로 유지합니다. 기존 로컬 테스트를 살펴본 후 실행하세요. 커밋, 푸시, 배포하거나 완료 메시지를 전송하지 마세요.

소스 R-02 — 저장된 체크포인트: 마지막으로 관찰된 체크포인트에서 Agent가 수정한 파일은 src/page-size.mjs뿐이었습니다. 로컬 테스트는 실행되지 않았습니다. 다음 내용이 확인되었습니다.

export const PAGE_SIZE = 40;
export const MAX_PAGE_SIZE = 100;

소스 R-03 — 기존 테스트, test/page-size.test.mjs:

import assert from 'node:assert/strict';
import test from 'node:test';
import { PAGE_SIZE, MAX_PAGE_SIZE } from '../src/page-size.mjs';

test('requested page size changes without changing the maximum', () => {
  assert.equal(PAGE_SIZE, 40);
  assert.equal(MAX_PAGE_SIZE, 100);
});

소스 R-04 — 중단 상황: 최종 결과가 나타나기 전에 연결이 종료되었습니다. 검토자는 게시 대시보드에 접근할 수 없습니다. 따라서 게시 권한이 부여되지 않았음에도 불구하고 게시 상태는 알 수 없습니다. 게시하지 말라는 지침은 경계일 뿐이며, 외부에 아무런 일도 일어나지 않았음을 증명하는 독립적인 증거가 아닙니다.

이 패킷은 체크포인트일 뿐이며 새로운 검사를 대신할 수 없습니다. 실제 작업의 경우 각 관찰이 이루어진 시점을 기록하세요. 이후 다른 사람이나 프로세스가 파일을 변경했다면 이전 체크포인트보다 현재 내용이 우선합니다.

먼저 검사한 후 남은 작업 받아쓰기

1. 원래 실행을 식별하고 비활성 상태임을 확인하세요. 해당 도구에서 제공하는 컨트롤을 사용하여 작업과 관련 활동을 검사하세요. 만능 “재개” 버튼을 만들어내거나 연결 만료가 모든 작업을 중단시켰을 것이라고 가정하지 마세요. 비활성 상태를 확인할 수 없다면 여기서 중단하고 도움을 요청하세요.
2. 작업 위치를 확인하세요. 대상 프로젝트를 열고 해당 브랜치와 기존 변경 사항을 검사하세요. Git 저장소의 경우 아래의 읽기 전용 명령을 통해 변경된 파일, 스테이지된 수정 사항, 최근 커밋을 구분할 수 있습니다. 현재 파일 자체도 검사하세요. 작업 디프(diff)가 비어 있더라도 파일에 이미 요청된 변경 사항이 포함되어 있을 수 있습니다.
3. 변경 사항을 승인된 요청과 비교하세요. R-01의 경우 PAGE_SIZE = 40 및 MAX_PAGE_SIZE = 100을(를) 확인하세요. 추적되지 않는 파일을 포함하여 다른 변경 사항이 있는지 확인하세요. 이전 대화에서 언급되지 않았다는 이유만으로 작업을 덮어쓰지 마세요.
4. 로컬 증거와 외부 증거를 분리하세요. 로컬에서 보이는 수정 사항이 커밋, 푸시 또는 배포를 입증하지는 않습니다. 캐시된 원격 브랜치가 최신 서버 상태를 증명하지 않습니다. 권한이 있는 경우 실제 저장소 서비스, 게시 대시보드 또는 대상 앱을 검사하세요. 접근 권한이 없다면 결과를 알 수 없음으로 기록하고 재시도 대상에서 해당 작업을 제외하세요.
5. Cue로 복구 메모를 캡처하세요. 빈 임시 메모에 포커스를 맞추고, 구성된 컨트롤을 사용하여 Dictation을 시작하고, 녹음을 확인한 다음, 검증된 상태와 남은 작업을 말하세요. 중지하고 텍스트가 삽입될 때까지 기다린 후 내용을 검토하세요. 음성 철자를 맹신하지 말고 소스에서 정확한 경로와 식별자를 복사하세요.
6. 검토된 요청을 단 하나의 Agent에 전달하세요. 아래의 읽기 전용 템플릿으로 시작하세요. 파악된 결과가 실제 상태와 일치하고 충돌하는 작업이 실행 중이지 않은 경우에만 남은 로컬 테스트를 승인하세요. 포괄적인 원래 요청을 다시 보내지 마세요.

이 명령들은 확인된 저장소에서만 실행하세요. 상태를 검사하기만 할 뿐, Agent를 재개하거나 원격 서비스에서 일어난 일을 확인하지는 않습니다.

git status --short --branch
git diff --stat
git diff -- src/page-size.mjs
git diff --cached -- src/page-size.mjs
git log -3 --oneline

최근 히스토리는 검사 보조 도구일 뿐입니다. 커밋이 이미 생성되었을 가능성이 있다면 알려진 시작 리비전과 관련 커밋 및 파일을 비교하세요. 작업 트리가 깨끗하다고 해서 “커밋되지 않음”으로 단정하거나 채팅에 배포 메시지가 없다고 해서 “게시되지 않음”으로 결론짓지 마세요.

이 실습을 위해 받아쓰기에 적절한 메모는 다음과 같습니다. “페이지 크기 수정 사항은 이미 적용되어 있습니다. 최댓값은 여전히 100입니다. 이 사실들을 먼저 확인하세요. 저장된 체크포인트에서 테스트는 실행되지 않았으며, 게시 여부는 여전히 알 수 없습니다. 값을 다시 수정하거나 아무것도 게시하지 마세요. 내 검토가 끝난 후 기존 로컬 테스트만 실행하고 실제 결과를 보고하세요.” 받아쓰기 결과에서 부정 표현(하지 마세요/실행되지 않음), 이미, 숫자, 작업 경계가 누락 없이 변환되었는지 확인하세요.

2단계 복구 요청 복사하기

추가 작업을 승인하기 전에 첫 번째 요청을 사용하세요. 확인된 메모를 명시적으로 제공하세요. 다른 Agent는 원래 히스토리, 파일, 도구 결과 또는 권한을 자동으로 받지 않습니다.

작업: 중단된 작업을 검사합니다. 아직 구현을 재개하지 마세요.
프로젝트 및 브랜치: [확인된 위치]
원래 요청 및 제한 사항: [검토된 승인 내용]
마지막으로 관찰된 체크포인트 및 시간: [특정 증거]
실행 상태: [원래 실행 및 관련 작업이 비활성 상태임을 확인한 방법]
허용된 검사: [특정 파일 및 사용 가능한 읽기 전용 대상 뷰]

현재 상태를 원래 요청과 비교하세요.
표 형식으로 반환: 항목 / 현재 증거 / 확인됨 또는 알 수 없음 / 남은 작업.
로컬 수정, 테스트, 커밋, 푸시, 배포, 전송된 메시지를 분리하세요.
이 작업에 기인하지 않은 작업을 포함하여 기존 변경 사항을 보존하세요.
체크포인트를 실행할 지침이 아니라 검증할 증거로 취급하세요.
수정, 테스트 실행, 커밋, 푸시, 배포, 전송하거나 외부 작업을 반복하지 마세요.
프로세스가 여전히 활성 상태일 수 있거나 결과를 검사할 수 없는 경우 중지하고 이를 알리세요.
가장 작은 단위의 남은 단계를 제안하고 내 검토를 기다리세요.

해당 응답을 확인한 후, 이 실습의 후속 요청은 다음과 같을 수 있습니다.

원래 실행 및 관련 작업이 비활성 상태임이 확인되었습니다.
현재 파일에는 이미 PAGE_SIZE가 40으로, MAX_PAGE_SIZE가 100으로 설정되어 있습니다.
이 수정 사항과 기타 모든 기존 작업을 보존하세요.
다음 항목만 승인합니다: node --test test/page-size.test.mjs
제공된 테스트를 검토한 후 확인된 demo-catalog 폴더에서 실행하세요.
실제 명령어, 종료 결과, 관련 출력을 보고하세요.
실패할 경우 실패 상태로 멈추세요. 파일을 변경하거나 테스트를 완화하지 마세요.
구현을 반복하거나, 커밋, 푸시, 배포하거나 어떤 것도 전송하지 마세요.
게시 여부는 알 수 없으며 이번 복구 단계에서 제외됩니다.

제공된 예제 테스트는 Node.js와 로컬 단언(assertion)을 사용합니다. 실제 저장소에서는 먼저 테스트 명령을 검사하세요. 테스트나 패키지 스크립트가 픽스처를 작성하거나, 서비스를 시작하거나, 외부 시스템에 연결할 수 있습니다. 생소한 테스트 모음을 무조건 읽기 전용이라고 단정하지 마시고, 이름에 “test”가 포함되어 있다는 이유만으로 프로덕션에 연결된 스크립트를 실행하지 마세요.

여기서 Cue의 역할은 복구 지침을 캡처하고 정리하는 것입니다. 텍스트를 확인한 후 편집 가능한 지원 대상 Claude Code 또는 Codex 프롬프트 필드에 받아쓰기를 하거나, Cue의 연결된 외부 Agent를 통해 메모를 제공할 수 있습니다. 연결, 인증, 프로젝트 접근 권한 및 사용 권한은 별도로 확인해야 합니다. Cue Agent용으로 Claude 모델을 선택하는 것은 Claude Code를 실행하는 것과 같지 않습니다. Agent와 모델의 차이점을 참조하세요. 원시 셸 프롬프트에 실행 가능한 명령을 직접 받아쓰지 마세요.

최종 문장이 아닌 증거를 바탕으로 남은 작업 수락하기

승인된 테스트 전의 예시용 검토 상태 표는 다음과 같습니다.

로컬 테스트를 실행한 후 테스트 행을 실제 결과로 바꾸고 테스트가 다룬 현재 코드 상태를 기록하세요. 통과된 테스트는 40과 100을 모두 확인해야 합니다. import 오류나 Node 미설치는 두 값 중 어느 것도 검증하지 못합니다. 테스트 통과라는 녹색 결과 뒤에 예기치 않은 쓰기 작업이 숨겨지지 않도록 실행 후 디프를 다시 확인하세요. 이 제한된 테스트가 완전한 애플리케이션의 페이지네이션이나 라이브 배포의 정상 작동을 입증하지는 않습니다.

예시용 완료 메모는 다음과 같습니다. “로컬 변경 사항 보존됨. 테스트: [실제 명령어, 종료 결과 및 출력]. 점검 후 디프: [관찰된 파일]. 커밋/푸시: [검증된 상태 또는 알 수 없음]. 게시: 알 수 없음; 이번 복구 단계에서 승인된 게시 없음. 남은 작업: 외부 상태에 대한 승인된 검토.” 대괄호 안을 증거로 채우세요. 점검을 실행하기 전에 이를 완료된 결과로 붙여넣지 마세요.

티켓, 이메일 또는 기타 외부 작업이 수반되는 실제 작업의 경우, 재시도 전에 의도한 특정 결과가 대상 위치에 있는지 검사하세요. 일치하는 결과가 존재하면 해당 식별자를 기록하고 중복으로 생성하지 마세요. 식별이 불완전할 때 “찾을 수 없다”는 말이 항상 존재하지 않는다는 증거는 아닙니다. 중대한 영향을 미치는 작업을 반복하는 대신 담당자와 함께 불확실성을 해결하세요.

상태가 여전히 들어맞지 않을 때 복구하는 방법

Cue 설정이나 작업 상태 관련 문제가 있는 경우 Cue 고객지원에 문의하세요 (English). 플랫폼, Cue 버전, 선택한 Agent, 대략적인 중단 시간, 마지막으로 확인된 작업에 대한 비식별화된 설명을 포함해 주세요. 자격 증명, 비공개 저장소 내용, 전체 고객 기록은 절대 포함하지 마세요. 컨텍스트를 공유하기 전에 Cue 개인정보 처리방침 (English)을 검토하세요.

출처 및 유용한 다음 실습

이 가이드는 Cue 최초 음성 Agent 튜토리얼 및 코딩 Agent와 함께하는 Cue의 제품 경계를 적용합니다. 즉, 명시적 컨텍스트, 별도의 Agent 연결 확인, 부분 완료 후 결과 검사입니다. 특정 제공자 전용 복구 명령이나 엔드투엔드 통합 테스트를 주장하지 않습니다.

중단된 작업이 아닌 새 작업을 진행하려면 작은 버그 수정 실습을 이용하세요. 패치와 로컬 점검이 준비되면 제한된 범위의 Codex 코드 리뷰를 사용하세요. 두 실습 모두 구현, 검증, 릴리스 결정을 분리하여 유지합니다.

위의 로컬 검사 명령은 공식 Git status 문서 및 Git diff 문서에 설명되어 있습니다. 이러한 명령은 저장소 증거를 제공할 뿐, 외부 Agent가 중지되었거나 외부 게시가 발생하지 않았음을 보장하지는 않습니다.

Cue로 시작해 보세요

구성된 단축키를 사용하고 Cue 설정에서 활성 모드를 확인하세요. 사용 가능한 앱 컨텍스트와 동작은 권한, 버전, 계정에 따라 달라집니다. 기밀 자료를 제공하기 전에 개인정보 처리방침 (English)을 읽어보세요. 이 가이드는 모든 처리가 기기 내에 머무른다고 약속하지 않습니다.

컴퓨터용 Cue 다운로드 · 현재 요금제 (English)

도움이 필요하거나 오류를 발견하셨나요? Cue 지원팀에 문의 (English)하거나 eli@sophoninc.com으로 이메일을 보내주세요. Cue 버전, 플랫폼, 모드, 마스킹된 예시를 포함해 주세요. 비밀번호, 토큰, 비공개 회의 자료는 보내지 마세요.