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


무엇인가요
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 게이트웨이가 이미 주는 것으로 대부분의 앱이 완성돼요. 백엔드는 이럴 때만 정당해요.
- 등록된 MCP 커넥터로 없는 외부 API를 감쌀 때(브라우저의 직접
fetch는 CSP가 막아요) - 비밀키가 필요한 서버 쪽 연동
- 브라우저에서 할 수 없는 무거운 계산
- 여러 앱에 공용 기능·데이터를 내는 독립 서비스(
parts: ["backend"])
기본 앱: 문서 검토
기본으로 들어 있는 Document Review Workspace는 프런트엔드만으로 된 완성된 업무 흐름이에요.
- 비공개 문서를 올리고 추출을 대기열에 넣어요. 대기·처리 중·준비·실패·취소 상태가 남아요.
- 준비된 문서를 골라 질문해요. 검색은 그 문서들로만 걸러진 뒤 순위를 매기고, 답은 인용과 함께 와요. 근거가 없으면 답을 만들지 않아요.
- 인용을 보고 초안을 고치고, 확인한 뒤 schema로 검증한
reviews레코드로 저장해요. - 승인한 내용과 출처를 텍스트 파일로 내보내거나,
document-reviewRuntime 프로필로 이어 가요. - 이전 실행 기록을 다시 열고, 기다리던 질문이나 동의를 이어서 해요.
다음으로
앱 템플릿 · 시작 템플릿 · SDK · 앱 만들기