/cc-bricks:create-project — 새 프로젝트 "처음부터 세팅" 자동 안내

coco-de/co-bricks의 cob 도구(CLI + MCP)를 이용해, 빈 상태에서 모노레포 코드 골격과 Firebase/GCP/iOS/GitHub Secrets 인프라까지 초기 세팅을 한 번의 흐름으로 진행합니다.

한마디로#

새 가게를 열 때 ① 건물 골조·인테리어(코드 골격)를 세우고 → ② 전기·수도·인터넷(클라우드 인프라)을 연결하는 두 단계를, 미리 준비된 표준 설계도(cob 브릭)로 자동으로 처리해 주는 도우미입니다. "프로젝트 이름과 조직명 한 장"만 정하면, 폴더 구조·기능 뼈대·배포에 필요한 계정과 열쇠(Secrets)까지 순서대로 갖춰 줍니다.

• 완전히 새로운 프로젝트를 처음 만들 때 (그린필드)
• 기존 kobic 스타일 표준 구조(Flutter + Serverpod + CoUI 모노레포)를 그대로 따라 시작하고 싶을 때
• 여러 기능(feature)을 한 스펙(project.yaml)으로 한꺼번에 찍어내고 싶을 때

👉 이미 만들어진 프로젝트에 기능 하나만 추가하려면 이 커맨드가 아니라 cob compose(풀스택 feature 1개) 또는 각 feature-* 스킬을 쓰세요. 이 커맨드는 "프로젝트 자체를 처음 만드는" 진입점입니다.

⚠️ 인프라(B)는 CLI 전용입니다. cob MCP는 코드 생성 계열(cob_create/cob_create_from_config 등)만 노출하며 init/firebase/gcp/ios/secrets는 노출하지 않습니다. 인프라 단계는 반드시 cob CLI로 진행하고, firebase/gcloud/gh/fastlane 로그인이 선행되어야 합니다.

어떻게 쓰나요#

# 대화형(권장): 이름·조직·feature 포함 여부를 프롬프트로 하나씩 확인
/cc-bricks:create-project

# 이름을 미리 지정 (그 외는 대화형/기본값)
/cc-bricks:create-project --name my_app

# 인프라 부트스트랩까지 이어서 진행
/cc-bricks:create-project --name my_app --with-infra

# 코드만 생성 (인프라는 나중에)
/cc-bricks:create-project --name my_app --code-only

# project.yaml 스펙으로 모노레포+features 일괄 생성
/cc-bricks:create-project --spec project.yaml

1. 사전 점검(Gate 0) — cob CLI 설치 여부 확인. 없으면 설치 안내 후 중단(degrade). 인프라 단계 선택 시 firebase/gcloud/gh/fastlane 로그인 상태도 함께 점검.
2. 입력 정리 — 프로젝트명(snake_case)·조직·TLD·GitHub·백엔드(serverpod)·포함할 feature 목록을 수집. --spec 지정 시 project.yaml(spec v1)을 단일 진실원으로 사용.
3. 코드 스캐폴드(A) — cob create(대화형/단일 모노레포) 또는 cob generate -s project.yaml(모노레포 + N feature 합성)로 골격 생성. 라우트 등록·워크스페이스 갱신은 cob이 담당(모노레포 브릭은 post_gen 만, feature 합성은 pre_gen 만 실행).
4. 검수 — 생성된 폴더/워크스페이스/라우트 등록 확인, melos bootstrap 등 빌드 준비. 이어서 project-init 스킬의 "생성 직후 기준선 점검" 7항(서버 패키지 <project>_server·<project>_client 명명, coui 최신 태그, HookWidget·한 파일 한 공개 타입·타입 안전 라우트, 유니버설/앱 링크, co_golden 갤러리 Pages, co_bdd, 사내 패키지)을 확인하고 어긋난 것을 먼저 고칩니다.
5. 인프라 부트스트랩(B, 선택) — --with-infra 시 cob init 7-stage 실행 안내(각 스테이지는 실패해도 경고만 남기고 다음 진행, iOS 디렉토리 없으면 iOS 자동 스킵).
6. 마무리 — 다음 단계(첫 feature는 cob compose, 개발 사이클은 /cc-dev:run) 안내.

command -v cob >/dev/null || {
  echo "⚠️ cob 미설치 — 아래로 설치 후 재시도:"
  echo "  dart pub global activate --source git https://github.com/coco-de/co-bricks.git"
  echo '  echo '"'"'export PATH="$PATH:$HOME/.pub-cache/bin"'"'"' >> ~/.zshrc && source ~/.zshrc'
  exit 0   # 파이프라인 차단이 아닌 안내 후 중단
}

firebase create → gcp service-account → firebase init(configure)
  → firebase sha → ios create → secrets encode → secrets push

<project>/                         # 모노레포 루트 (melos)
├── app/<project>/                 # Flutter 앱
├── backend/<project>_server/      # 실행·조립·교차 기능·DB 통합 테스트 호스트
├── backend/<project>_client/      # 호스트 합성 SDK
├── feature/<d>/
│   ├── app/                      # <d>; lib/src/i18n/ 기능 번역
│   ├── console/                  # console_<d>; lib/src/i18n/ 기능 번역
│   ├── server/                   # <d>_server, type: module; lib/src/{endpoint,service,model,…}
│   ├── client/                   # <d>_client 생성 SDK
│   ├── bundle.json               # 조립 선언
│   └── host-integration.json     # 호스트 결합 계약
├── melos.yaml / pubspec.yaml      # 워크스페이스 (cob이 등록)
└── .envrc                         # (인프라 시) Secrets base64 + App ID