조립 계획 읽기

요구를 보내면 나오는 설명 글과 「조립 계획」 카드의 줄마다 무엇을 뜻하는지, 확인하기 전에 고칠 수 있는 것, 계획이 나오지 않을 때의 안내를 설명합니다.

제공 중 마지막 확인: 2026-10-09

요구를 보내면 채팅에 두 가지가 차례로 나옵니다. 하나는 AI 가 쓴 설명 글이고, 다른 하나는 「조립 계획」 카드입니다. 카드의 레시피 · 조각 · 데이터 팩 · 비어 있는 기능 · 예상 시간은 cob 가 카탈로그에서 고른 것입니다. 설명 글을 쓰는 AI 에게는 그 사실만 한국어로 풀어 쓰라고 지시하며, 글과 카드가 다르면 카드가 기준입니다. 카드를 확인하기 전에는 프로젝트 폴더도 GitHub 저장소도 만들어지지 않습니다.

계획이 나오기까지

요구를 보내면 입력창이 잠기고 「카탈로그를 대조하고 계획을 세우는 중…」이 보입니다.
앱이 cob 에게 카탈로그와 계획을 묻습니다. 이 단계는 프로젝트를 만들지 않습니다.
cob 가 돌려준 사실을 AI 에게 보여 주며 다시 쓸 수 있는 조각 · 비어 있는 조각 · 예상 시간을 한국어로 풀이하게 하면, 그 설명 글이 채팅에 흘러 들어옵니다.
설명 글이 끝나면 그 아래에 「조립 계획」 카드가 붙고 입력창이 다시 열립니다.

참고

설명 글은 cob 가 낸 계획 단계도 근거로 삼으므로 cob apply · cob compose 처럼 뒤따르는 적용 단계를 이야기할 수 있습니다. 하지만 「확인하고 실행」이 돌리는 것은 카드 맨 아래 줄에 적힌 단계뿐이고, 후속 적용은 이 실행에 들어 있지 않습니다.

카드 읽기

카드 머리에는 「조립 계획」과 「레시피 · 브릭 카탈로그 기준」이 있고, 오른쪽에 아직 확인 전이라는 뜻의 「확인 필요」 표지가 붙습니다. 해당하는 내용이 없는 줄은 나오지 않습니다.

줄	보이는 때	뜻
프로젝트 이름	늘	새 프로젝트의 이름입니다. 요구에서 제안한 이름이 들어 있고 여기서 고칠 수 있습니다
레시피	늘	cob 가 고른 검증된 레시피의 이름입니다. 맞는 레시피가 없으면 「없음 — 기본 조립」이 보입니다. 레시피가 있는 계획은 생성 단계에서 멈출 수 있습니다(실행 결과와 게시의 경고)
기본 포함	있을 때	고른 레시피가 이미 갖춘 기능과 맞아 기본 조립에 들어가는 조각입니다
후속 적용	있을 때	브릭이나 다른 레시피의 기능과 맞았지만 기본 조립에는 들어 있지 않은 후보, 그리고 요구와 키워드가 맞는 재사용 패키지입니다. 검토한 뒤 따로 적용해야 합니다
데이터 팩	있을 때	도메인과 키워드가 맞는 데이터 팩의 이름입니다. 추천만이고, 추천했다고 생성물에 자동으로 들어가지는 않습니다
구현 필요	있을 때	카탈로그에 직접 채우는 브릭이나 레시피 기능이 없는 기능입니다. 요구에 쓴 기능 이름 그대로 나오고, 따로 구현해야 합니다
예상 시간	늘	「약 N분 · 휴리스틱 추정」입니다. 실제 시간이 아니라 cob 의 추정값입니다. 기본 11분에, 브릭이나 다른 레시피의 기능과 맞은 요구 기능 하나마다 3분(카드의 「후속 적용」 조각 옆에 적힌 기능 수), 「구현 필요」 기능 하나마다 20분을 더해 세고, 재사용 패키지와 데이터 팩은 세지 않으며, 의존성을 내려받는 시간과 배포 시간은 빠져 있습니다

「기본 포함」 · 「후속 적용」의 조각 이름은 카탈로그의 식별자 그대로입니다(예: brick:<브릭 이름> · recipe:<레시피 이름>/<기능 이름>). 이름 옆의 작은 글자는 그 조각이 채우는 기능입니다. 한 조각이 여러 기능을 채우면 기능이 모두 나열됩니다.

카드 아래쪽에는 「함께 만들기」 체크 세 개와, Pages 를 켰을 때의 「Pages 저장소」 줄이 있습니다. 둘은 함께 만들기 옵션에서 설명합니다. 맨 아래 줄의 왼쪽에는 확인하면 이어서 돌 단계(사전 점검 → 생성 → 검증, Pages 를 켰다면 → Pages 게시)가, 오른쪽에는 「계획 다듬기」와 「확인하고 실행」 단추가 있습니다.

프로젝트 이름

이름은 소문자로 시작하고, 소문자 · 숫자와 낱말 사이의 밑줄(snake_case)로만 쓸 수 있습니다. 밑줄을 연달아 쓰거나 끝에 둘 수 없습니다. clinic_emr · book_club2 는 쓸 수 있고 Clinic · 2fast · a__b 는 쓸 수 없습니다. 이름 칸 아래의 글이 지금 상태를 알려 줍니다.

칸 아래의 글	뜻
「`<생성 위치 폴더>`/`<프로젝트 폴더>` 에 만듭니다」	쓸 수 있는 이름입니다. 폴더 이름은 이름의 밑줄이 하이픈이 된 것입니다(`clinic_emr` → `clinic-emr`)
「소문자 · 숫자 · 밑줄(snake_case)로 써 주세요」	이름 규칙에 맞지 않습니다
「이미 있는 폴더입니다 — 다른 이름을 쓰세요」	생성 위치에 같은 폴더가 이미 있습니다

확인하기 전에 할 수 있는 것

이름과 체크를 고칩니다. 고친 값은 「확인하고 실행」을 누를 때 한꺼번에 쓰입니다.
「계획 다듬기」를 누릅니다. 입력창으로 포커스가 옮겨 갈 뿐 아무것도 보내지지 않습니다. 바꾸고 싶은 점을 쓰고 보내면 새 계획이 나옵니다. 새 요구가 이전 계획을 대체하는 방식은 요구 쓰기에 있습니다.
확인하지 않고 둡니다. 계획 카드는 다른 요구로 대체되거나 앱을 끌 때까지 대화에 남아 있습니다.

「확인하고 실행」은 아래 어느 하나라도 해당하면 눌러지지 않습니다.

빌더가 계획을 세우거나 실행하는 중입니다.
프로젝트 이름이 규칙에 맞지 않습니다.
생성 위치에 같은 이름의 폴더가 이미 있습니다.
Pages 가 켜져 있고, Pages 저장소 이름의 모양이 틀렸거나 확인하는 중이거나 이미 있는 저장소입니다.

확인하고 나면

「확인하고 실행」을 누르면 계획 카드가 「계획 확인됨」 한 줄로 접히고, 이름 · 레시피(있을 때) · 「기본 포함」 개수 · 「구현 필요」 개수 · 예상 시간이 그 줄에 요약됩니다. 이어서 아래에 실행 카드가 생기고 오른쪽 패널과 아래쪽 「디버그 로그」가 열립니다. 각 영역은 화면 구성에 있고, 실행 카드는 실행 결과와 게시에서 설명합니다. 다음 요구로 대체된 계획은 「이전 계획 — 대체됨」으로 접힙니다.

계획이 나오지 않을 때

계획 단계에서 막히면 대화 아래에 안내가 나옵니다. 보낸 요구는 그대로 남아 있고, 막힌 원인을 고치면 「다시 시도」로 같은 요구를 다시 보낼 수 있습니다. 먼저 cob 가 준비되지 않은 경우입니다.

안내	뜻	할 일
「cob 실행 파일을 찾지 못했습니다」	cob 가 설치되어 있지 않거나 `PATH` 에 없습니다	「명령 복사」로 설치 명령을 복사해 터미널에서 실행하고 「다시 시도」
「cob 갱신이 필요합니다」	설치된 cob 가 빌더 기계 API(`plan --spec`) 이전 버전입니다	「명령 복사」로 복사한 명령으로 갱신하고 「다시 시도」
「bricks 체크아웃이 없습니다」	cob 가 조립할 브릭 목록이 이 컴퓨터에 없습니다	「bricks 받기」 — 내려받은 뒤 계획을 다시 만듭니다
「레시피 카탈로그를 찾지 못했습니다」	cob 가 레시피를 한 건도 돌려주지 않았습니다	「명령 복사」로 복사한 명령으로 cob 를 갱신하고 「다시 시도」

네 안내의 준비 방법은 준비물에 있고, 설정 화면에서 미리 점검하는 법은 빌더에 있습니다. 그 밖의 원인은 「빌더가 멈췄습니다」 카드로 나오고, 카드의 글이 원인을 말합니다. 설정을 가리키는 글이면 「설정 열기」 단추가 함께 나옵니다. 문구별 원인은 문제 해결에도 모아 두었습니다.

카드의 글	뜻
「`<공급자 id>` API 키가 없습니다」	앞에는 공급자 이름이 아니라 `openai` · `anthropic` 같은 공급자 id 가 보입니다. 고른 공급자의 키가 키 저장소에도, 환경 변수에도(공식 주소로 연결했거나 같은 주소를 가리키는 `…_BASE_URL` 이 있을 때만 인정됩니다) 없습니다. 「설정 열기」로 키를 저장하세요
「`<공급자>` 모델이 설정되지 않았습니다」	Ollama · 사용자 지정 공급자는 모델 ID 를 직접 골라야 합니다
「연결 URL이 설정되지 않았거나 올바르지 않습니다」	연결 URL 이 비었거나 올바르지 않습니다. 설정에서 API base URL 을 적용하세요
「키가 거부되었습니다」 · 「이 모델에 접근할 수 없습니다」 · 「모델 또는 URL을 찾지 못했습니다」 · 「공급자 요청 한도를 넘었습니다」	공급자가 각각 401 · 403 · 404 · 429 로 답했습니다. 설정의 키 · 모델 · URL 을 확인하고, 한도는 잠시 뒤에 다시 시도하세요
「모델 응답 시간이 초과되었습니다」	응답이 60초 안에 끝나지 않았습니다
「모델 응답을 받지 못했습니다」	이 표에 따로 적은 이유가 아닌 그 밖의 모델 호출 실패입니다(공급자의 서버 오류 · 네트워크 오류 · 비정상 종료 · 빈 응답 · 2 MiB 를 넘는 응답 포함). 앱은 공급자가 돌려준 오류 내용을 화면에 그대로 내지 않으므로, 설정의 URL · 모델 · 키를 확인하세요. 앱에는 「연결 URL이 일치하지 않습니다」 · 「지원하지 않는 공급자입니다」라는 안내도 있지만 화면에서 그 문구가 나오는 경우를 확인하지 못했고, 같은 원인이 이 문구로 보일 수 있습니다
「모델 응답이 너무 깁니다」	응답이 65,536자를 넘었습니다. 설정의 공급자 · 모델을 확인하고 다시 시도하세요
「cob catalog 실패 (종료 코드 N)」 · 「cob plan 실패 (종료 코드 N)」 · 「cob plan이 검증되지 않은 레시피를 반환했습니다」 · 「cob 응답을 해석하지 못했습니다」	cob 쪽 문제입니다. cob 를 갱신하고 다시 시도하세요
「계획을 만들지 못했습니다」	위 어느 안내에도 들지 않는 그 밖의 예외입니다. cob 쪽일 수도 앱 쪽일 수도 있고 화면은 원인을 더 알려 주지 않습니다. 「다시 시도」 해 보고, 반복되면 cob 를 갱신하고 설정을 확인한 뒤 다시 시도하세요

참고

「다시 시도」는 같은 요구를 보냈던 때의 연결(공급자 · 모델 · URL) 로 다시 보냅니다. 키는 보낼 때마다 새로 찾으므로 키를 저장한 뒤에는 「다시 시도」를 쓰면 됩니다. 공급자 · 모델 · URL 을 바꿨다면 「다시 시도」가 아니라 새 요구를 보내세요.

다음 단계

카드 아래쪽의 체크를 알아봅니다. 함께 만들기 옵션으로 이어서 보세요.