b2c-app-builder

B2C App Builder는 Clueless Creations의 MIT 라이선스 오픈 소스 프로젝트로, 소비자 앱 비즈니스 구축을 AI 에이전트를 위한 재사용 가능한 프리미티브 세트로 구성합니다. README에서는 이를 레스토랑 주방에 비유합니다. '스테이션'은 모든 소비자 앱 비즈니스가 공유하며 앱에 따라 변하지 않는 책임이며, '역량(capabilities)'은 각 스테이션이 생산해야 할 것을 정의하고, '제공자(providers)'가 이를 구현합니다. '레시피(recipes)'는 작업을 생성 및 운영 루프로 배치하며, 선택된 '지식(knowledge)'은 에이전트가 올바른 결정을 내리도록 돕는 미장플라스(mise en place) 역할을 합니다. 사용자는 기회와 제품을 선택하고 기준을 설정하는 총괄 셰프로 묘사됩니다. 이 프로젝트는 기술과 소스 지식만으로는 다음 작업이 무엇인지, 이전 작업의 결정 사항이 무엇인지, 어떤 제공자가 이를 실행하는지, 결과가 유효한지, 실패 시 어떻게 처리할지가 불분명하다고 설명합니다. 이에 대한 해답으로 역량, 레시피, 계획, 제한된 실행, 증거 및 복구를 제시하여, 여러 전문 에이전트와 제공자가 서로 단절된 조각이 아닌 하나의 비즈니스를 위해 협력하도록 합니다. 사용자는 자체 에이전트와 모델, 인프라, 제공자 계정 및 자격 증명, 실행 환경을 제공하며, 방법론 자체는 MIT 라이선스 하에 전체 제공됩니다. 스테이션으로 매핑된 대상 영역에는 기회 조사(사용자, 경쟁사, 수요, 방어 가능한 제품 가설), 제품 정의(약속, 첫 가치, 핵심 루프, 범위, 성공 측정 지표), 경험(아이덴티티, 온보딩, 상호작용, 모션, 접근 가능한 상태), 엔지니어링(명시적 계약 및 런타임 검증을 갖춘 네이티브 및 웹 표면), 수익 및 성장(구독, 획득, 퍼널, 기여도, 라이프사이클), 학습 및 운영(증거 검토, 개선 계획, 사용자 지원, 비즈니스 유지 관리)이 포함됩니다. 다섯 가지 프리미티브가 설명됩니다. '역량'은 운영 시맨틱과 수락 기준을 가진 비즈니스 책임이며, '제공자'는 선언된 지원 범위와 제한 사항을 가진 특정 운영의 구현체입니다. '레시피'는 구성 가능한 생성 또는 운영 루프이며, '지식'은 제한된 양으로 로드된 소스 가이드입니다. '증거'는 주장, 아티팩트 및 환경과 연결된 관찰 결과입니다. README는 제공자를 교체해도 권한이나 활성화의 의미가 재정의되지 않으며, 새로운 레시피가 동일한 실행 및 증거 메커니즘을 재사용하고, 빌더가 제품, 브랜드, 비즈니스 모델 및 운영 루프에 대한 제어권을 유지한다는 점을 강조합니다. 시작하려면 Node.js 24가 필요합니다. `npm install -g b2c-app-builder` 후 `b2c setup`을 실행하면 로컬 워크스페이스 레지스트리가 생성되고 Claude Code, Cursor, Codex를 위한 MCP 등록 명령어가 출력됩니다. 설치가 필요 없는 휴대용 형태로는 `claude mcp add --scope user b2c-app-builder -- npx -y -p b2c-app-builder b2c-app-builder-mcp` 명령을 사용합니다. 소스에서 설치할 경우 저장소를 클론한 뒤 `npm ci`와 `npm run setup`(내부적으로 `npm link` 실행)을 수행합니다. 초기 명령어로는 공개 역량, 제공자, 레시피를 나열하는 `b2c catalog --json`과, 변경 없이 구성을 미리 보는 `b2c compose --config contracts/public-api/examples/subscription-app.json --json`이 있습니다. 미리보기는 각 운영을 제공자로 해석하고 차단 요소를 나열하며, 선언 미리보기는 `canApply: false`를 보고합니다. 설치된 패키지 레시피를 활성화하려면 별도의 리비전 확인 구성 계획 및 활성화 명령을 사용합니다. 새 비즈니스의 경우, `b2c business-create`를 통해 워크스페이스 이름, 절대 경로, 제품 이름, 가설 및 권한을 가진 계획 워크스페이스를 등록합니다. 대상 경로는 비어 있거나 없어야 하며, 기존 워크스페이스는 `b2c workspaces register`로 채택할 수 있습니다. 이후 상태 및 계획 명령이 이어집니다. 설명된 라이프사이클은 계획 워크스페이스를 생성하고, 99개 워크플로우로 구성된 완전 비즈니스 레시피로 수락된 제품을 초기화하며, 적격 작업을 계획하고, 실행기를 통해 제한된 세션을 실행합니다. 증거 보고서는 현재의 수락 사항을 누락되었거나 오래된 증거 및 중단된 요청과 분리하며, 리비전 확인 복구를 통해 이를 종료합니다. 구성(Compositions)은 레시피를 타겟에 바인딩하며, YAML(`apiVersion: b2c/v1`, 레시피 ID/버전, 타겟 플랫폼 및 런타임, 운영을 제공자 버전 및 연결에 매핑하는 바인딩)을 통해 단일 운영의 제공자를 오버라이드할 수 있습니다. 연결 값은 별도로 관리되는 연결의 이름이며, 자격 증명이 아닙니다. 모바일 앱 운영은 별도의 역량으로 처리됩니다. 에이전트는 고객 여정을 따라가고, 버그를 재현하며, 디자인을 검토하고 스크린샷이나 데모 영상을 캡처합니다. 기본 제공자로 에이전트 호스트의 네이티브 시뮬레이터 도구를 사용하며, MobAI와 같은 대안을 선택할 수 있습니다. Tuck 예시는 여행 계획, 짐 싸기, 랜딩 페이지를 포함한 실제 앱 및 웹 캡처를 보여주며, 캡처 출처 및 검증 제한에 대한 갤러리 링크를 제공합니다. 상태 표는 선언된 지원 사항과 실제 구현 사항을 구분합니다. 구현된 항목에는 소스 기반 지식, 워크플로우 카탈로그, CLI 및 로컬 MCP, 워크스페이스 생성, 계획, 제한된 실행, 검토 및 증거, `b2c/v1` 검색, 구성 미리보기 및 공유 CLI/MCP 스키마와 계약 테스트를 통한 비즈니스 상태, 콘텐츠 핀, 미리보기 체크 및 복구를 포함한 로컬 패키지 임포트 및 구성 활성화가 포함됩니다. 제공자 실행 경로는 명시적인 호스트 어댑터이며, 선언만으로는 절대 실행되지 않습니다. 벤치마크 품질의 완전한 소비자 비즈니스 하나를 구축하는 것이 다음 마일스톤이며, 유사한 시장 보고서는 구현되었으나 다중 비즈니스 마일스톤은 아직 입증되지 않았습니다. 기여와 관련하여, 프로젝트는 더 나은 소비자 앱 참조, 운영 계약, 제공자 및 레시피를 요청하며, 대부분의 기여가 새로운 스테이션보다는 스테이션을 실행하는 방법을 추가하는 것임을 명시합니다. 퍼스트 파티 및 커뮤니티 확장은 동일한 적합성 테스트 스위트를 통과해야 합니다. AGENTS.md 파일은 범위에 따라 작업을 `b2c-app-builder`, `b2c-contributor` 또는 `b2c-maintainer` 기술로 라우팅합니다. 제3자 크레딧 및 법적 고지는 `catalog/upstreams` 하위의 업스트림 매니페스트에서 렌더링됩니다.