Golden Image

Golden Image 소개

Golden Image는 Mothership 앱을 만드는 기반이에요. React 앱 템플릿과 SDK, Python·Node worker, 검사 도구, 문서 검토 예제 앱이 들어 있어요.

Golden Image의 기본 앱, 문서 검토. Mothership 안에서 돌아요.Golden Image의 기본 앱, 문서 검토. Mothership 안에서 돌아요.
Golden Image의 기본 앱, 문서 검토. Mothership 안에서 돌아요.

무엇인가요

Mothership 앱 하나를 만드는 저장소의 출발점이에요. 저장소 하나가 앱 하나이고, 기본은 프런트엔드만 있는 앱이에요. make build가 만든 ZIP을 Mothership에 올리면 앱이 돼요. 따로 호스팅할 것이 없어요.

  • 프런트엔드: React 앱. 호스트의 mount/unmount 계약을 지키는 entry.ts, 디자인 토큰을 받는 UI 킷(src/ui/), Pretendard 글꼴까지 들어 있어서 폐쇄망에서도 같은 빌드가 돌아요.
  • SDK: 데이터, 상태, 파일, AI, 지식 검색, Runtime, 커넥터, 작업을 부르는 @mothership/sdk-core·sdk-react와 계약 schema(agent-contracts). 계약 1.2.0.
  • 백엔드(선택): Python(FastAPI) 또는 Node(TypeScript) worker. 꼭 필요할 때만 더해요.
  • 검사 도구: schema 검증, Mothership 등록 규칙, 프런트·백엔드 짝 검사(scripts/check.py).
  • 프로필과 기반 업데이트: 고정된 프로필로 새 앱을 만들고, 앱 작성자의 변경을 지키면서 SDK·빌드 도구를 올려요.

대원칙: 되도록 프런트엔드만

Mothership 게이트웨이가 이미 주는 것으로 대부분의 앱이 완성돼요. 백엔드는 이럴 때만 정당해요.

  1. 등록된 MCP 커넥터로 없는 외부 API를 감쌀 때(브라우저의 직접 fetch는 CSP가 막아요)
  2. 비밀키가 필요한 서버 쪽 연동
  3. 브라우저에서 할 수 없는 무거운 계산
  4. 여러 앱에 공용 기능·데이터를 내는 독립 서비스(parts: ["backend"])

기본 앱: 문서 검토

기본으로 들어 있는 Document Review Workspace는 프런트엔드만으로 된 완성된 업무 흐름이에요.

  1. 비공개 문서를 올리고 추출을 대기열에 넣어요. 대기·처리 중·준비·실패·취소 상태가 남아요.
  2. 준비된 문서를 골라 질문해요. 검색은 그 문서들로만 걸러진 뒤 순위를 매기고, 답은 인용과 함께 와요. 근거가 없으면 답을 만들지 않아요.
  3. 인용을 보고 초안을 고치고, 확인한 뒤 schema로 검증한 reviews 레코드로 저장해요.
  4. 승인한 내용과 출처를 텍스트 파일로 내보내거나, document-review Runtime 프로필로 이어 가요.
  5. 이전 실행 기록을 다시 열고, 기다리던 질문이나 동의를 이어서 해요.

다음으로

Esc