실행 결과와 게시
「확인하고 실행」을 누른 뒤 실행 카드가 보여 주는 단계와 결과, 멈췄을 때 다시 돌리는 방법, 「새 프로젝트 열기」와 「Pages 열기」, 게시가 하는 일을 설명합니다.
목차
「확인하고 실행」을 누르면 계획 카드가 한 줄로 접히고 그 아래에 실행 카드가 생깁니다. 실행 카드는 cob 가 도는 단계를 하나씩 보여 주고, 끝나면 결과와 다음 동작을 보여 줍니다.
실행 카드의 단계
| 단계 | cob 명령 | 하는 일 | 도는 때 |
|---|---|---|---|
| 사전 점검 | doctor |
새 프로젝트가 아니라 생성 위치 폴더를 점검합니다. GitHub 인증과, .fvmrc 가 있으면 SDK, 그 폴더에 GitHub origin 이 있으면 그 저장소의 push 권한 · Actions 설정까지 봅니다. 막히면 여기서 멈춥니다 |
늘 |
| 프로젝트 생성 | fullstack |
계획대로 생성 위치 아래에 새 프로젝트 폴더를 만듭니다 | 늘 |
| 검증 | verify |
만든 프로젝트가 cob 의 검증 게이트를 통과하는지 확인합니다 | 늘 |
| Pages 게시 | publish |
GitHub 에 비공개 저장소를 만들고 push 한 뒤 Pages 로 배포합니다 | 「소개 페이지 (Pages)」를 켠 경우 |
카드 머리에는 <이름> 생성 중, N / M 단계, 경과 시간이 보입니다. 경과 시간은 1초마다 갱신되고 12초 · 1:05 꼴로 나옵니다. 단계마다 상태 아이콘이 붙습니다: 완료는 체크 표시, 진행 중은 도는 표시, 실패는 느낌표, 대기는 빈 원이고 대기 중인 단계에는 「대기」라는 글자도 보입니다. cob 가 단계 안에서 보내는 세부 단계는 단계 이름 아래의 작은 칩으로 나옵니다.
오른쪽 패널의 「진행 상황」 · 「출력」과 아래쪽 「디버그 로그」는 같은 실행을 다른 눈높이로 보여 줍니다. 자세한 내용은 화면 구성에 있습니다.
참고
실행 카드에는 실행을 중간에 멈추는 단추가 없습니다. 실행하는 동안에는 입력창이 잠겨 있어서, 실행이 끝나거나 멈출 때까지 새 요구를 보낼 수 없습니다.
주의
레시피가 있는 계획은 「프로젝트 생성」에서 멈출 수 있습니다. 계획에 레시피가 있으면 앱이 cob 에 --recipe 를 넘깁니다. 앱이 설치하라고 안내하는 cob 는 레시피 기반 생성을 시작할 때 bricks 에 사용 중단된 동기화 코드(co_sync)가 남아 있으면 프로젝트를 쓰기 전에 멈추므로, 그 참조가 남아 있는 동안에는 레시피가 있는 계획이 이 검사에서 멈춥니다. 2026-10-09 에 cob 소스를 읽고 bricks 에 그런 참조가 남아 있는 것까지 확인했고, 같은 계열의 cob 를 임시 폴더에서 실행해도 같은 곳에서 멈췄습니다. 앱 화면에서 직접 돌려 보지는 않았습니다. 증상과 대처는 아래 「자주 겪는 문제」에 있습니다.
끝났을 때
성공하면 카드 제목이 <이름> 생성 완료 로 바뀝니다. 단계 아래에는 결과가 이 순서로 나옵니다.
| 보이는 것 | 뜻 |
|---|---|
| 「기본 프로젝트 완료」 | 기본 조립이 끝났고 프로젝트 폴더가 만들어졌습니다 |
| 「기본 프로젝트 완료 · 후속 후보와 갭은 미적용」 | 계획 카드의 「후속 적용」 후보 가운데 cob 가 apply_candidate · compose_candidate 로 표시한 것과 「구현 필요」 기능을 이 실행이 적용하지 않았다는 뜻입니다. 아래 줄에 하나씩 나열됩니다. 그런 항목이 하나도 없으면 「기본 프로젝트 완료」만 나옵니다 |
· <조각 이름>: 후속 적용 필요 (apply_candidate) · (compose_candidate) |
검토한 뒤 따로 적용해야 하는 후보입니다. 괄호 안은 cob 가 붙인 종류로, apply_candidate 는 브릭을 적용할 후보이고 compose_candidate 는 다른 레시피의 기능을 조합할 후보입니다 |
· <기능>: 구현 필요 |
카탈로그가 직접 채우지 못해 직접 구현해야 하는 기능입니다 |
| 「새 프로젝트 열기」 | 만든 폴더를 프로젝트 목록에 추가하고 엽니다 |
| 「Pages 열기」 | 게시 단계의 출력에서 앱이 https://….github.io/… 꼴의 Pages 주소를 읽어 낸 경우에만 나옵니다. 누르면 그 주소를 브라우저로 엽니다 |
「새 프로젝트 열기」를 누르면 지금까지의 대화도 새 프로젝트로 옮겨 갑니다(빠른 시작의 8단계).
참고
「새 프로젝트 열기」 뒤에는 열려 있는 프로젝트가 방금 만든 프로젝트로 바뀌고, 생성 위치도 그 폴더가 됩니다. 같은 대화에서 요구를 이어 보내면 새 프로젝트는 그 폴더 안에 만들어지고, 앞의 프로젝트가 Pages 로 게시되어 Git 저장소가 되었다면 뒤의 프로젝트는 그 저장소 안에 있게 됩니다(아래 「Pages 게시」의 경고).
주의
실행 기록은 앱을 끄면 사라집니다. 대화는 디스크에 저장되지 않으므로 실행 카드와 오른쪽 패널의 진행 상황 · 출력도 함께 없어집니다. 만들어진 프로젝트 폴더는 디스크에 그대로 남습니다.
멈췄을 때
어느 단계든 실패를 보고하면 실행이 거기서 멈추고 카드 제목이 바뀝니다. 만들어진 프로젝트의 경로를 아는 상태에서 멈췄다면(검증 · Pages 게시 단계가 대표적입니다) <이름> 생성됨 · <단계> 실패 이고, 그렇지 않으면 <이름> 생성 실패 입니다. 경로를 알면 「새 프로젝트 열기」도 그대로 나옵니다.
멈춘 자리에는 빨간 상자가 붙고 아래를 보여 줍니다.
- 제목: 「
<단계>에서 멈췄습니다」(예: 「검증에서 멈췄습니다」). 단계를 알 수 없으면 「실행이 멈췄습니다」입니다. - 꼬리표: 「도구 없음」 · 「인증」 · 「네트워크」 가운데 하나. 앱이 실패를 분류하지 못하면 꼬리표를 달지 않습니다.
- 사유: cob 가 남긴 사유입니다. 알려진 형태의 비밀 값(토큰 · 키 · URL 속 자격 증명)은 가려서 보입니다.
- 요약 줄:
verify 실패 (종료 코드 N)같은 작은 글자입니다. - 「출력 보기 (N줄)」: cob 가 보낸 실패한 명령의 출력 꼬리(20줄 이하)입니다. 누르면 펼쳐지고 「출력 접기」로 접습니다. cob 가 꼬리를 보내지 않았다면 이 단추는 없습니다. cob 는 검증 게이트나 생성 단계의 템플릿 검사가 멈췄을 때 꼬리를 보내고, 사전 점검과 Pages 게시 단계에서는 보내지 않습니다.
- 「정책 프록시가 막은 호스트: …」: 이 실행 동안 빌더의 정책 프록시가 막은 호스트 이름입니다. 있을 때만 보입니다. 허용 목록은 샌드박스에 있습니다.
꼬리표는 먼저 이 컴퓨터 안의 규칙으로 정합니다. 규칙으로 가르지 못할 때 「설정」의 「빠른 판단 (Jev)」 키가 있으면 실패 요약 한 줄만 Jev 에 보내 묻고, 사유와 출력 꼬리는 보내지 않습니다.
다시 돌리기
멈춘 단계에 따라 실행 카드에 나오는 동작이 다릅니다.
| 멈춘 단계 | 나오는 것 |
|---|---|
| 사전 점검 | 「다시 실행」 — 아무것도 만들어지지 않았으므로 처음부터 다시 돕니다 |
| 프로젝트 생성 | 단추 없음 — 「생성이 중간에 멈춰 이어서 돌릴 수 없습니다 — 남은 폴더를 정리하거나 다른 이름으로 다시 계획하세요.」 |
| 검증 | 「검증부터 다시」. Pages 를 켰다면 「검증 없이 Pages 게시…」도 나옵니다 |
| Pages 게시 | 「이 이름으로 게시」 양식 — 저장소 이름을 고쳐 다시 게시합니다 |
- 다시 돌리면 새 실행 카드가 생기고, 도는 동안 제목이
<이름> — <단계>부터 다시입니다. 앞 카드는 기록으로 남습니다. 다시 돌리는 단추는 가장 마지막 실행 카드에만 있고, 빌더가 쉬고 있을 때만 나옵니다. - 「검증부터 다시」는 이미 만든 프로젝트를 다시 만들지 않고 검증부터 돕니다. 「다시 실행」과 달리 앞 단계를 되풀이하지 않습니다.
- 「검증 없이 Pages 게시…」를 누르면 저장소 이름 칸과 「이 이름으로 게시」 단추가 열립니다. 게시는 GitHub 에 저장소를 만드는 외부 동작이라서, 만들 저장소와 하는 일을 보여 준 양식에서만 시작합니다. 게시 단계에서 멈췄다면 이 양식이 처음부터 열려 있습니다.
- 저장소 이름의 모양이 틀렸거나, 확인하는 중이거나, 같은 이름의 저장소가 이미 있다고 확인되면 「이 이름으로 게시」가 눌러지지 않으니 이름을 고치세요. 있는지 확인하지 못했을 때는 눌러지고, 이미 있는 저장소라면 게시 단계에서 다시 멈춥니다. 저장소 이름 규칙과 상태 글은 함께 만들기 옵션에 있습니다.
- 생성이 중간에 멈추면 반쯤 만들어진 폴더가 남아 같은 자리에서 이어 돌 수 없습니다. 남은 폴더를 정리하거나 다른 프로젝트 이름으로 다시 계획하세요. 생성이 폴더를 쓰기 전에 거절된 경우(위의 레시피 경고)에는 남는 폴더가 없습니다.
Pages 게시
「소개 페이지 (Pages)」를 켜고 실행하면 마지막 단계에서 GitHub 에 비공개 저장소를 만들고 push 한 뒤 Pages 로 배포합니다. 이 앱이 프로젝트를 올려 주는 곳은 GitHub Pages 하나입니다. 소유자 기본값이 coco-de 라서 본인 owner/name 으로 고쳐야 할 수 있다는 점과 gh 로그인 · 요금제 조건은 함께 만들기 옵션의 경고에 있습니다.
게시는 첫 배포가 끝나기를 기다리므로 시간이 걸릴 수 있습니다. cob 의 기본 대기 상한은 20분입니다. 배포가 끝나고 cob 가 github.io 주소를 알려 주면 「Pages 열기」가 나타납니다.
주의
생성 위치가 Git 저장소 안이면 게시가 멈춥니다. cob 의 게시 단계는 새 프로젝트가 다른 Git 저장소 안에 있으면 시작하기 전에 「프로젝트가 다른 Git 저장소 내부에 있습니다. 별도 디렉터리에서 게시하세요」라며 거절합니다. cob fullstack 은 프로젝트를 만들 때 git init 을 하지 않으므로(생성이 끝나면 직접 git init 하라고 안내하고, git init 은 저장소 밖에 있는 프로젝트의 게시 단계에서 합니다), 생성 위치로 연 프로젝트 폴더가 Git 저장소이면 새 프로젝트가 그 안에 만들어져 이 경우에 해당합니다. 빠른 시작의 「새 프로젝트 만들기」는 「git 저장소로 초기화」가 처음부터 켜져 있어 그 폴더도 Git 저장소입니다. 소스를 읽어 확인했고, 같은 계열의 cob 를 임시 폴더에서 실행해도 같은 메시지로 거절됐습니다. 앱 화면에서 직접 돌려 보지는 않았습니다. 이 경우에는 Git 저장소 밖의 폴더를 생성 위치로 열고 처음부터 만들거나, 「소개 페이지 (Pages)」를 끄고 실행하세요.
자주 겪는 문제
실행이 「사전 점검」에서 멈춥니다
실행 카드에 「사전 점검에서 멈췄습니다」와 cob 가 알려 준 사유가 나옵니다. 사전 점검은 gh 로그인 여부를 확인하므로 터미널에서 gh auth status 가 통과하는지 먼저 확인하고, 나머지 준비물은 준비물에서 점검한 뒤 「다시 실행」을 누르세요. 점검 대상은 생성 위치 폴더라서, 그 폴더에 .fvmrc 가 있는데 .fvm/flutter_sdk 가 그 버전을 가리키지 않거나, 그 폴더의 GitHub 저장소(origin)에 push 권한이 없거나 Actions 가 꺼져 있어도 멈춥니다.
「프로젝트가 다른 Git 저장소 내부에 있습니다」로 게시가 멈췄습니다
새 프로젝트가 Git 저장소 안에 만들어졌다는 뜻입니다. 생성 위치로 연 폴더(또는 그 위의 폴더)가 Git 저장소이면 cob 는 게시를 시작하기 전에 「별도 디렉터리에서 게시하세요」라고 안내하며 거절합니다. 프로젝트 폴더는 이미 만들어졌고 검증도 끝난 상태입니다. 이미 만든 프로젝트는 「별도 디렉터리에서 게시하세요」라는 안내대로 Git 저장소 밖으로 옮긴 뒤, 터미널에서 cob 문서가 안내하는 cob publish --project-dir <프로젝트 폴더> --repo <owner/name> --apply 로 게시할 수 있습니다. 이 앱에서는 Git 저장소 밖의 폴더를 생성 위치로 열고 처음부터 만들거나, Pages 를 끄고 만드세요. 소스를 읽어 확인했고, 같은 계열의 cob 를 임시 폴더에서 실행해 같은 메시지를 확인했습니다. 앱 화면에서 직접 돌려 보지는 않았습니다.
「프로젝트 생성에서 멈췄습니다」 — 「사용 중단된 동기화 참조가 도너 브릭에 남았습니다」
레시피가 있는 계획에서 나올 수 있는 멈춤입니다. cob 는 레시피 기반 생성을 시작할 때 bricks 의 monorepo · app · serverpod_backend 브릭을 훑어, 사용 중단된 동기화 코드(co_sync)가 남아 있으면 프로젝트를 쓰기 전에 「신규 생성은 --base kernel을 사용하세요」라는 안내와 함께 멈춥니다. 그래서 프로젝트 폴더는 만들어지지 않고 「새 프로젝트 열기」도 나오지 않으며, 이 메시지는 아래쪽 「디버그 로그」에 남고 경우에 따라 카드의 사유로도 보입니다. 걸린 것이 참조가 아니라 파일 이름이면 「사용 중단된 동기화 파일이 도너 브릭에 남았습니다」로 나옵니다. 레시피가 없는 계획(「없음 — 기본 조립」)은 이 검사를 거치지 않습니다. 앱에는 레시피를 빼거나 이 검사를 건너뛰고 실행하는 선택이 없으니 cob 와 bricks 가 고쳐진 뒤 다시 시도하세요. 소스를 읽어 확인했고(bricks 에 그 참조가 남아 있는 것까지), 같은 계열의 cob 를 임시 폴더에서 실행해 프로젝트 폴더가 만들어지지 않은 채 이 안내로 멈추는 것을 확인했습니다. 앱 화면에서 직접 돌려 보지는 않았습니다.
「생성됨 · 검증 실패」가 나왔는데 프로젝트를 써도 되나요?
프로젝트 폴더는 만들어졌고 디스크에 남아 있습니다. 「새 프로젝트 열기」로 열어 볼 수 있습니다. 다만 검증을 통과하지 못했다는 뜻이므로, 사유를 읽고 「검증부터 다시」로 다시 확인하세요.
「Pages 열기」 단추가 없습니다
「소개 페이지 (Pages)」를 켜지 않았거나, 게시 단계가 아직 끝나지 않았거나, 멈췄거나, cob 가 주소를 알려 주지 않았거나, 알려 준 주소를 앱이 읽지 못한 경우(github.io 꼴이 아닌 주소)입니다. 멈췄다면 위의 「다시 돌리기」를 따르고, 게시는 끝났는데 단추만 없다면 저장소의 Pages 설정에서 주소를 확인하세요.
cob 의 원문 출력은 어디서 보나요?
cob 가 실패와 함께 보낸 출력의 마지막 줄들(검증 게이트 · 생성 단계의 템플릿 검사)은 실행 카드의 「출력 보기」에 있고, 실행하는 동안 cob 가 낸 출력은 아래쪽 패널의 「디버그 로그」 탭에 있습니다. 디버그 로그는 가장 최근 실행 하나만 담습니다. 2,000행이나 2 MiB 를 넘으면 오래된 행부터 버리고, 한 행이 8,192자를 넘으면 자릅니다. 디버그 로그 화면은 코드 모드에 있습니다.
다음 단계
실행 결과 아래에 붙는 AI 제안은 맥락 제안에서 설명합니다. 멈춘 화면의 문구로 원인을 찾으려면 문제 해결을 보세요.