요구 쓰기

채팅 입력창에 요구를 쓰는 법 — 앱이 문장을 도메인과 기능으로 나누는 규칙, 요구를 다시 보내면 계획이 어떻게 바뀌는지, 요구가 어디로 보내지는지를 설명합니다.

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

채팅 모드의 입력창에 만들고 싶은 것을 한국어로 씁니다. 앱은 쓴 문장을 도메인(어떤 서비스인지)과 기능(그 서비스에 필요한 것)으로 나누어 cob 에 넘기고, cob 가 카탈로그에서 맞는 레시피와 브릭을 찾아 계획을 세웁니다. 어떻게 쓰면 어떻게 나뉘는지 알아 두면 처음부터 원하는 계획에 가깝게 보낼 수 있습니다.

입력창

채팅은 열려 있는 프로젝트 폴더를 생성 위치로 씁니다. 그 폴더가 Git 저장소이면 새 프로젝트도 그 안에 만들어져 Pages 게시가 멈출 수 있습니다(실행 결과와 게시의 경고). 열린 프로젝트가 없으면 입력창 대신 「프로젝트 폴더를 추가하면 채팅으로 기능을 조립할 수 있습니다」와 「프로젝트 추가」 단추가 보입니다. 프로젝트를 추가하는 방법은 프로젝트 관리에 있습니다.
빈 대화의 첫 화면에는 「무엇을 만들까요?」와 입력창, 예시 단추 세 개가 있습니다. 예시 단추를 누르면 그 문장이 입력창에 채워질 뿐 바로 보내지지 않으므로, 고친 뒤에 보낼 수 있습니다. 0.1.0 이후에 추가된 빌드에서는 맥락 제안이 켜져 있고 연결이 준비되어 있으면 시작 제안을 시도합니다. cob 의 카탈로그를 읽을 수 있고 모델 · 키 · URL 이 맞아 만들어지면 예시 단추 자리에 AI 가 고른 시작 제안이 나옵니다(맥락 제안). 2026-10-08 에 내려받을 수 있던 0.1.0 에는 예시 단추 세 개만 있습니다. 첫 화면 아래쪽의 「이미 있는 프로젝트로 시작」(「폴더 찾아보기」 · 「URL에서 복제」 · 「빈 프로젝트 만들기」)은 모두 프로젝트를 더하는 대화상자를 엽니다(프로젝트 관리).
Enter 키로 보내고 Shift + Enter 로 줄을 바꿉니다. 오른쪽의 위쪽 화살표 단추(스크린 리더에는 「보내기」)로도 보내며, 입력이 비어 있으면 보낼 수 없습니다.
입력창 아래에는 「<생성 위치 폴더 이름> 에 만들기」와 지금 쓰는 모델(<모델> · <공급자>)이 보입니다. 폴더 이름 옆에는 늘 같은 글자 「· 수동 확인」이 붙어 있는데, 바꿀 수 있는 설정이 아니고 이 앱은 계획 카드를 확인해야만 실행합니다. 모델 이름을 누르면 「설정」이 열리고, 처음 열리는 항목이 「AI 공급자」입니다. 화면 설명은 AI 공급자에 있습니다.
계획을 세우거나 실행하는 동안에는 입력창과 보내기 단추가 잠깁니다.

앱이 요구를 읽는 규칙

앱은 문장을 쉼표(,) · 세미콜론(;) · 줄바꿈에서 자릅니다. 첫 조각이 도메인이고, 나머지 조각은 다시 가운뎃점(·)에서 잘라 기능 하나씩으로 읽습니다. 조각 앞뒤의 공백은 버립니다. 쉼표 · 세미콜론 · 줄바꿈이 없으면 문장 전체가 도메인이면서 하나뿐인 기능이 됩니다.

쓴 요구	도메인	기능
`피부과 의원 EMR, 예약 · 접수 · 차트 · 수납`	피부과 의원 EMR	예약 · 접수 · 차트 · 수납(4개)
`북클럽 커뮤니티, 모임 · 게시판 · 알림`	북클럽 커뮤니티	모임 · 게시판 · 알림(3개)
`북클럽 커뮤니티`	북클럽 커뮤니티	문장 전체(1개)
`피부과 의원 EMR — 예약 · 접수 · 차트`	문장 전체	문장 전체(1개) — 쉼표가 없어 나뉘지 않습니다

처음 두 줄은 도메인과 기능이 의도대로 나뉘는 좋은 예이고, 셋째 줄은 기능을 쓰지 않아 문장 전체가 기능 하나가 되는 예, 마지막 줄은 쉼표가 없어 나뉘지 않는 나쁜 예입니다. cob 는 기능마다 카탈로그에서 맞는 브릭이나 레시피 기능을 찾습니다. 직접 채우지 못한 기능은 계획 카드의 「구현 필요」에 올라옵니다(조립 계획 읽기). 그래서 기능을 가운뎃점으로 나누어 쓰면 어떤 기능이 채워지고 어떤 기능이 비는지가 카드에 기능 단위로 드러납니다.

팁

기능은 가운뎃점(·)으로 하나씩 나누어 쓰세요. 쓴 말이 그대로 기능의 이름으로 cob 에 넘어가고, 계획 카드에는 그 이름이 「기본 포함」 · 「후속 적용」 줄의 조각 옆이나 「구현 필요」 줄에 나옵니다.

참고

첫 화면의 예시 단추(예: 「피부과 의원 EMR — 예약 · 접수 · 차트」)는 도메인과 기능을 「—」로 잇고 쉼표가 없어서, 그대로 보내면 위 표의 마지막 줄처럼 읽힙니다. 기능을 나누어 읽히려면 도메인 뒤의 「—」를 쉼표로 고쳐 보내세요. AI 가 만든 시작 제안도 도메인 뒤에 쉼표가 없으면 마찬가지입니다.

함께 만들기는 요구가 아니라 카드에서 고릅니다

「데모 데이터」 · 「소개 페이지 (Pages)」 · 「운영 콘솔」은 요구 문장이 아니라 계획 카드의 체크로 정합니다. 예를 들어 북클럽 커뮤니티, 모임 · 게시판, 운영 콘솔까지 라고 써도 「운영 콘솔」 체크는 켜지지 않습니다. 쉼표로 떼어 쓴 「운영 콘솔까지」는 기능 하나의 이름으로 읽혀(모임 · 게시판 · 운영 콘솔까지, 3개) cob 에 넘어갈 뿐입니다. 자세한 내용은 함께 만들기 옵션에 있습니다.

다음 요구를 보내면

요구를 보낼 때마다 새 계획을 세웁니다. 이 대화에서 이미 답을 받은 요구들을 줄바꿈으로 이어 붙이고 새 요구를 맨 끝에 붙여, 처음부터 다시 계획하는 방식입니다.

도메인은 대화에서 가장 먼저 답을 받은 요구의 첫 조각으로 정해집니다. 다음 요구에서 쓴 조각은 모두 기능으로 읽힙니다. 예를 들어 피부과 의원 EMR, 예약 · 접수 · 차트 다음에 수납 추가 를 보내면 도메인은 그대로이고 기능은 예약 · 접수 · 차트 · 수납 추가(4개)가 됩니다.
새 요구를 보내면 앞의 확인 대기 계획은 바로 「이전 계획 — 대체됨」으로 접히고 확인할 수 없습니다. 새 계획이 나오기 전에도, 새 요구가 실패했을 때도 마찬가지이니 그때는 「다시 시도」로 새 계획을 받으세요. 확인할 수 있는 계획은 가장 마지막 하나뿐입니다.
질문만 따로 답하는 모드는 없습니다. 입력창 안내(「계획을 다듬어 달라고 말하거나 질문하세요」)에 따라 질문을 보내도 그 문장이 요구에 붙어 새 계획이 나옵니다.
답을 받지 못한 요구(말풍선 아래에 「응답을 받지 못함」이 붙습니다)는 다음 요구에 이어 붙지 않습니다.
계획 카드에서 고친 이름과 체크 상태는 「확인하고 실행」을 누른 뒤에 보내는 요구부터 이어집니다. 확인하기 전에 요구를 다시 보내면 새 카드는 앞 카드에서 고치던 값이 아니라 마지막으로 확인한 계획의 값으로 시작하고, 확인한 적이 없으면 처음 값으로 시작합니다.

주의

채팅 빌더가 만드는 것은 생성 위치 아래의 새 프로젝트 폴더입니다. Pages 를 켜면 GitHub 저장소도 만듭니다. 이미 만든 프로젝트에 기능을 덧붙이는 단계는 없습니다. 같은 이름의 폴더가 이미 있으면 「확인하고 실행」이 눌러지지 않으니, 카드에서 다른 이름을 쓰세요.

요구가 가는 곳

요구를 보낼 때마다 아래로 전달됩니다. 비밀 값이나 개인 정보는 요구에 쓰지 마세요.

받는 곳	보내는 것	언제
내 컴퓨터에서 도는 cob	도메인과 기능으로 나눈 요구 명세(표준 입력으로 넘기는 JSON)	요구를 보낼 때마다
고른 AI 공급자	이 대화의 요구 전체와, cob 가 알려 준 계획 사실(카탈로그 사실 · 프로젝트 이름과 세 체크가 담긴 cob 단계 명령 · 판단 근거). 계획을 설명하는 글을 쓰게 합니다	요구를 보낼 때마다
같은 AI 공급자(맥락 제안)	계획 카드 아래: 요구와 계획 사실. 0.1.0 이후 빌드는 끝난 실행의 결과와 멈춘 실행의 사유, 첫 화면의 카탈로그 사실과 앞선 요구도	맥락 제안을 켜 둔 경우 — 전체 표는 맥락 제안
Jev	이 대화의 요구 전체와, 도메인 · 레시피 후보의 이름 · 설명 · 기능 키워드	「설정」의 「빠른 판단 (Jev)」에 키를 저장했거나 환경 변수 `TYPESAFE_API_KEY` 가 있을 때만. 후보가 있으면 요구 1건마다 두 번(도메인 후보 · 레시피 후보) 묻습니다

Jev 는 선택 사항입니다(AI 공급자). 키가 없거나, 응답이 늦거나 오류이거나, 확신이 낮으면 앱 안의 카탈로그 일치 규칙으로 판단합니다. 이 판단은 설명 글에 참고 사실로 전해질 뿐 카드의 레시피는 cob 가 정합니다. 앱은 cob 같은 자식 프로세스에 허용 목록의 환경 변수만 넘기고 TYPESAFE_API_KEY 는 그 목록에 없으므로, 앱이 띄운 cob 는 Jev 를 직접 부르지 않습니다(소스를 읽어 확인한 내용입니다).

자주 겪는 문제

한글로만 썼더니 프로젝트 이름이 new_project 로 제안됩니다

이름 제안은 요구에 든 영문 낱말(앞의 세 개까지)을 소문자 snake_case 로 잇습니다. 예를 들어 피부과 비급여 의원 EMR, 예약·접수·CRM 은 emr_crm 이 됩니다. 영문 낱말이 없으면 new_project 를 제안합니다. 이름은 대화의 첫 요구에서만 제안하고, 이후 요구는 그 이름(확인했다면 확인한 이름)을 이어 씁니다. 계획 카드의 「프로젝트 이름」에서 고치세요. 이름 규칙은 조립 계획 읽기에 있습니다.

보내기 단추가 눌러지지 않습니다

입력이 비어 있거나, 빌더가 계획을 세우거나 실행하는 중이거나, 연결 설정이 아직 준비되지 않은 경우입니다. 입력창 아래 모델 자리에 「연결 설정 읽는 중…」이 보이면 설정을 읽는 중이고, 「연결 URL 설정 필요」가 보이면 「설정」 › 「AI 공급자」에서 API base URL 을 적용해야 합니다. 방법은 AI 공급자에 있습니다.

「응답을 받지 못함」이 붙었습니다

그 요구에 대한 계획을 만들지 못했다는 표시입니다. 대화 아래에 이유와 「다시 시도」 단추가 나옵니다. 이유는 조립 계획 읽기의 「계획이 나오지 않을 때」에 정리해 두었습니다.

다음 단계

요구를 보내면 나오는 카드를 읽어 봅니다. 조립 계획 읽기로 이어서 보세요.