브라우저 미리 보기에 성공했어도 바로 출시하지 말고, 먼저 코드를 독립 저장소와 새 실행 환경에서 다시 만들고 테스트해야 합니다. Cursor Start from Scratch 검수의 통과 기준은 화면이 열리는지가 아니라 코드 인계, 재현 가능한 빌드, 비밀값 격리, 사람의 승인, 복구 절차입니다. Xcode나 Apple SDK가 들어간다면 실제 맥 환경에서 별도로 빌드와 서명까지 확인해야 합니다.
이 글은 저장소 없이 제품 아이디어를 확인하려는 독립 개발자, Cursor Cloud Agents로 새 프로젝트를 만들려는 창업 팀, 그리고 CI와 권한 또는 맥 빌드를 맡은 플랫폼 엔지니어를 위한 실행 문서입니다. 단순 시연만 필요한 사람은 가벼운 기준을 적용하고, 운영 서비스로 갈 사람은 아래 증거가 없으면 다음 단계로 넘어가지 않아야 합니다.
마지막 갱신: 2026년 8월 28일. 기능 상태와 접근 조건은 Cursor 공식 변경 기록, Origin 공식 문서, Cloud Agents 공식 문서을 기준으로 다시 확인해야 합니다.
생성 단계: 시연용과 운영용의 분리
Cursor Start from Scratch는 제삼자 소스 코드 저장소에 연결하지 않은 상태에서도 Cloud Agent 작업을 시작하고, Origin 프로젝트를 만들며, 브라우저에서 결과를 미리 볼 수 있는 흐름입니다. Vercel 연결을 통한 게시 경로도 공식 문서에 설명되어 있습니다. 다만 Origin은 아직 early beta로 안내되고 있으므로, 이 기능 상태를 운영 품질 보증으로 해석하면 안 됩니다. Origin의 현재 범위와 상태는 출시 전 검수 기준을 세울 때 함께 확인해야 합니다.
생성 전에 프로젝트의 최종 목적을 하나로 고정합니다. 일회성 발표 화면인지, 사내 사용 도구인지, 외부 사용자가 계속 접속할 서비스인지에 따라 반려 기준이 달라집니다. 아래 기록을 프롬프트와 별도의 문서로 남기면 나중에 Agent 대화가 사라져도 판단 근거가 남습니다.
| 시작 전에 정할 항목 | 시연용 원형 | 사내 도구 | 운영 서비스 |
|---|---|---|---|
| 데이터 | 가짜 또는 비식별 데이터 | 제한된 실제 데이터 | 보존, 삭제, 접근 규칙이 있는 실제 데이터 |
| 외부 연결 | 모형 응답 허용 | 시험용 계정 분리 | 운영 계정과 장애 처리 계획 필요 |
| 통과 의미 | 화면과 핵심 흐름 확인 | 정해진 사용자가 업무 수행 | 재빌드, 보안, 관찰, 복구까지 확인 |
| 환경 | 브라우저 미리 보기 | 제한된 시험 환경 | 독립 실행 환경과 배포 체계 |
| 반려 조건 | 핵심 화면이 깨짐 | 권한과 데이터 상태가 불명확함 | 비밀값 노출, 재현 실패, 복구 불가 |
특히 Xcode, Apple SDK, 맥 전용 명령이나 서명 도구가 필요한지 처음부터 표시합니다. 웹 화면이 열렸다는 사실만으로 해당 도구 체인의 빌드 가능성을 대신 증명할 수 없습니다.
인계 단계: 대화 속 결과와 관리 가능한 코드
Cursor Cloud Agents 생성물의 보존
Cursor Cloud Agents 생성 결과를 정식 개발로 넘기려면 Agent 대화와 임시 실행 상태에 의존하지 않는 파일 묶음을 만들어야 합니다. 디렉터리 구조, 의존성 목록, 실행 명령, 환경 변수 설명, 테스트 명령, 알려진 제한 사항이 한곳에 있어야 합니다. 다른 개발자가 새 세션 없이 프로젝트를 복제하고 실행할 수 있어야 합니다.
첫 인계 때는 다음 자료를 함께 보관합니다.
- 변경된 파일 목록과 생성 시점의 기준 버전
- 프로젝트를 시작하고 빌드하는 명령
- 필요한 런타임과 패키지 관리자
- 환경 변수 이름과 값의 주입 방법
- 정상 입력, 실패 입력, 빈 상태에 대한 기대 결과
- Agent가 임시로 만든 샘플 계정과 테스트 데이터의 삭제 기록
- 아직 사람이 확인하지 않은 코드와 외부 서비스 목록
샘플 비밀키, 기본 관리자 계정, 실제처럼 보이는 시험 데이터는 저장소에 들어가기 전에 제거합니다. 값만 지우는 것으로 끝내지 말고, 코드가 빈 환경 변수에서 안전하게 실패하는지도 확인해야 합니다. Cloud Agents의 권한과 보안 동작은 공식 보안 문서의 최신 설명과 대조합니다.
Cursor Origin 프로젝트의 저장과 책임
Cursor Origin 프로젝트는 화면에서 계속 열리는 것보다, 누가 소유하고 누가 변경을 승인하는지가 중요합니다. 소유자, 공개 범위, 구성원 역할, Privacy Mode, 병합 권한을 기록합니다. [Cursor Origin 검수]에서 확인할 핵심은 프로젝트가 만들어졌다는 사실이 아니라, 책임자가 바뀌어도 운영을 이어갈 수 있는가입니다.
| 확인 대상 | 통과 증거 | 반려 조건 |
|---|---|---|
| 소유권 | 조직 또는 담당자와 저장소 위치가 문서에 기록됨 | 개인 세션에만 남아 있음 |
| 변경 이력 | 커밋, 변경 파일, 검토 기록이 연결됨 | Agent 대화에서만 변경 이유를 확인할 수 있음 |
| 접근 권한 | 읽기, 쓰기, 검토, 병합 역할이 구분됨 | 모든 구성원이 같은 권한을 가짐 |
| 복구 | 표준 Git 방식으로 복제하고 이전 기준 버전으로 돌아감 | 원래 세션이 없으면 복구할 수 없음 |
표준 Git 복제를 실제로 수행해 코드가 새 폴더에 내려오는지 확인합니다. Git clone 공식 문서에 맞는 방식으로 복제한 뒤, 원래 Cloud Agent 환경에 남아 있던 캐시 없이 설치와 실행을 다시 진행합니다. 이 과정이 성공해야 “저장소 없이 만든 프로젝트를 저장했다”고 판단할 수 있습니다.
미리 보기 단계: 화면 통과와 기능 통과의 비교
브라우저 미리 보기는 빠른 확인 수단이지 전체 시스템의 합격 판정이 아닙니다. 정적 화면, 서버 로직, 데이터 보존, 외부 API를 서로 분리해 확인해야 합니다. 포트 전달로 화면이 표시되어도 서버가 재시작 뒤 상태를 잃거나, 외부 API 오류를 성공 응답처럼 처리할 수 있습니다.
시험은 정상 흐름만으로 끝내지 않습니다. 필수값 누락, 잘못된 형식, 권한 없는 요청, 외부 API 지연, 새로 고침, 서버 재시작을 순서대로 실행합니다. 각 결과에는 실행 명령, 입력 조건, 로그, 화면 또는 응답 기록을 연결합니다. 실패한 현상을 숨기지 말고, 운영에서 허용할 실패인지 반려할 실패인지 분류합니다.
이 단계의 결정은 다음처럼 나눕니다.
- 정적 화면만 확인됨: 시연용 원형으로 유지합니다.
- 서버 기능은 되지만 저장과 재시작 검증이 없음: 사내 제한 시험으로만 둡니다.
- 데이터 흐름, 오류 처리, 외부 연결을 새 환경에서 재현함: 저장소 인계 단계로 이동합니다.
- 실패 원인이 Agent 세션의 숨은 상태에 있음: 생성 단계로 되돌립니다.
AI 코딩으로 빠르게 만든 결과일수록 테스트가 없는 파일을 “완성된 기능”으로 오인하기 쉽습니다. 코드 양이나 화면 수를 품질 지표로 삼지 말고, 실패를 다시 실행할 수 있는 기록을 품질 지표로 삼아야 합니다. 사내에서 원격 개발 환경을 함께 검토한다면 맥 원격 개발 환경 용량 안내도 환경 분리 기준을 잡는 데 참고할 수 있습니다.
CI 단계: 숨은 상태와 재현 가능한 빌드의 대결
정식 개발 환경으로 넘긴 뒤에는 새 실행 환경에서 의존성을 설치하고, 빌드하고, 테스트를 실행합니다. Agent가 이미 내려받은 패키지나 임시 파일을 그대로 사용하면 재현 검증이 아닙니다. 설치 실패, 버전 잠금 누락, 운영 환경에서만 발생하는 환경 변수 오류를 이 단계에서 드러내야 합니다.
CI에는 최소한 형식 검사, 단위 테스트, 보안 검사, 출시 전 설정 검사를 넣습니다. 검사 명령과 실패 시 병합을 막는 조건을 저장소 문서에 적습니다. Cloud Agent가 만든 변경도 예외 없이 같은 문을 통과해야 하며, 사람의 승인 없이 자동 병합되는 경로는 별도로 차단합니다.
| 실행 환경 | 확인할 항목 | 다음 판단 |
|---|---|---|
| 새 로컬 환경 | 의존성 설치, 빌드, 테스트 | 실패하면 저장소 또는 실행 문서 수정 |
| CI 환경 | 잠금 파일, 비밀값 주입, 검사 결과 | 결과가 남지 않으면 운영 승인 보류 |
| 격리된 클라우드 맥 | Xcode 프로젝트 빌드, 테스트, 서명 | 맥 도구 체인에 문제가 있으면 출시 보류 |
| 게시 환경 | 설정, 로그, 이전 버전 복구 | 복구 확인 전 공개 범위 확대 금지 |
iOS나 macOS 앱은 웹 미리 보기와 다른 검증 경로를 가집니다. 실제 Xcode 프로젝트를 독립된 로컬 또는 클라우드 맥에서 빌드하고, 필요한 서명과 배포용 산출물을 확인해야 합니다. Apple은 맥용 배포 서명 코드 생성과 내보내기 절차를 별도로 안내합니다. 따라서 브라우저에서 작동한 웹 화면을 근거로 Apple 도구 체인까지 통과했다고 기록해서는 안 됩니다.
Vercel을 게시 대상으로 삼더라도 Git 연결, 빌드 명령, 환경 변수, 이전 배포 복구를 따로 확인합니다. Vercel의 Git 연결 문서는 연결 경로를 설명하지만, 생성된 애플리케이션의 테스트와 보안 상태를 보증하지는 않습니다.
출시 단계: 통과와 제한 공개를 가르는 점수
출시 판단은 기능이 많으냐가 아니라 위험을 설명할 수 있느냐로 결정합니다. 아래 항목을 모두 확인할 수 있으면 정식 출시 후보입니다. 일부만 충족하면 내부 또는 제한된 시범 운영으로 범위를 묶고, 핵심 항목이 비어 있으면 Agent 생성 단계로 되돌립니다.
| 검수 영역 | 통과 증거 | 점수 |
|---|---|---|
| 코드 인계 | 새 환경에서 복제와 실행 성공 | 2 |
| 빌드 재현 | 의존성 설치부터 테스트까지 같은 절차로 성공 | 2 |
| 권한 관리 | 소유자와 검토자, 병합 권한이 설명됨 | 2 |
| 비밀값 격리 | 저장소와 로그에 실제 비밀값이 없음 | 2 |
| 복구 | 이전 기준 버전으로 복구하고 재실행 성공 | 2 |
점수는 내부 운영을 위한 도구일 뿐, 공식 제품 보증 수치가 아닙니다. 총점이 높아도 비밀값이 노출되었거나 복구를 실행하지 못했다면 정식 출시로 올리지 않습니다. 반대로 기능이 적은 원형이라도 데이터가 가짜이고 외부 공개가 차단되어 있다면 제한 시범 운영으로 관리할 수 있습니다.
첫 운영 기간에는 실패한 Agent 작업, 사람이 수정한 파일, 빌드 실패 원인, 환경 차이를 계속 기록합니다. 이 기록이 쌓이지 않으면 워크플로가 실제로 안정적인지 판단할 근거가 없습니다. 자동화가 만든 결과를 확대 적용할수록, 예외를 수동으로 덮는 팀의 부담도 함께 측정해야 합니다.
출시 직전의 최종 선택
Cursor Start from Scratch로 만든 프로젝트는 아이디어 확인과 초기 제품 구조를 빠르게 얻는 데 강합니다. 그러나 독립 저장소, 검토 책임, 재현 빌드, 비밀값 관리, 복구가 갖춰지기 전에는 생산 코드로 분류하지 않는 편이 안전합니다. 이 기준은 Cursor Cloud Agents의 편리함을 부정하는 것이 아니라, Agent 세션과 운영 시스템 사이의 책임 경계를 분명히 하는 방법입니다.
현재 방식이 브라우저 미리 보기나 단일 개발자 장비에 머물면 세 가지 문제가 생깁니다. 다른 사람이 같은 상태를 재현하기 어렵고, 숨은 캐시와 개인 권한 때문에 CI에서 실패하며, Xcode나 맥 전용 도구가 필요한 순간 실행 환경이 끊깁니다. 장비를 직접 구입하면 초기 비용과 관리 책임을 떠안고, 일반 서버만 쓰면 Apple 도구 체인을 검증할 수 없습니다.
따라서 짧은 기간의 원형 검증이나 독립된 맥 빌드 시험이 목적이라면 MacPull의 맥 환경을 별도 실행 공간으로 사용해 현재 환경과 결과를 비교하는 편이 현실적입니다. 특히 맥 미니 전력 운영 조건을 함께 검토하면 지속 실행 조건을 정하는 데 도움이 됩니다. 장기적으로 고정된 고부하 작업이나 물리 장치 연결이 필요하다면 직접 보유가 더 적합할 수 있지만, 임시 CI 검증과 맥 도구 체인 확인이라면 MacPull 이용 절차를 기준으로 독립 환경을 먼저 대조해 보는 것이 좋습니다.