조립스페이스 문서

빠른 시작

터미널과 파일을 사용할 수 있는 AI 코딩 에이전트에서 시작하세요.

1. 프로젝트 준비

   프로젝트에서 사용할 프로젝트를 열거나 생성합니다. start는 이미 존재하는 프로젝트에 연결하는 명령입니다.

2. 작업 폴더 열기

   에이전트에서 프로젝트 코드를 저장할 폴더를 엽니다. 기존 코드가 있다면 해당 작업 폴더에서 시작하세요.

3. 메시지 전달

   아래 PROJECT 두 곳을 실제 프로젝트 이름으로 바꿔 전달하세요. 프로젝트의 시작하기 탭에서는 이름이 포함된 메시지를 바로 복사할 수 있습니다.

JoripSpace 프로젝트 `PROJECT`를 시작해줘.

1. `npm install -g @joripspace/cli@latest`로 공식 CLI를 설치하거나 업데이트해줘.
2. `joripspace start PROJECT --json`을 실행하고, 반환된 온보딩 안내와 에이전트 문서를 읽어 연결을 완료해줘.
3. 기존 프로젝트 상태를 확인하고, 제작·배포를 이어가기 위한 다음 단계를 안내해줘.

연결 승인이 필요하면 에이전트가 안내한 조립스페이스 화면에서 승인하고 일회용 연결 코드를 전달하세요. 연결 후에는 만들 기능을 설명해 제작과 배포를 요청할 수 있습니다.

AI 에이전트 연결

start는 프로젝트 상태, 온보딩 안내, 다음 작업을 반환합니다. 에이전트는 반환된 안내와 문서를 현재 대화에서 직접 읽고 작업을 이어갑니다.

AGENTS.md

프로젝트 작업 안내를 기록합니다. 기존 사용자 문서는 유지하며 조립스페이스 안내 블록을 관리합니다.

CLAUDE.md

AGENTS.md를 참조하도록 연결합니다. 문서가 자동으로 읽히지 않는 환경에서는 에이전트가 직접 읽어야 합니다.

다음 실행 경로

onboarding.invocation에 현재 세션에서 사용할 실행 파일의 절대경로, 인자와 작업 폴더가 반환됩니다.

이 시작 흐름에는 플러그인·스킬 설치나 MCP 등록이 필수가 아닙니다. 터미널·파일·네트워크 접근이 없는 채팅 전용 환경에서는 명령을 실행할 수 없습니다.

빈 프로젝트는 반환된 템플릿 선택 안내를, 기존 프로젝트는 현재 소스와 배포 상태에 맞는 다음 작업을 따르세요.

CLI 설치와 실행

Windows, macOS, Linux에서 Node.js 18 이상과 npm이 필요합니다. 새 환경에는 지원 중인 Node.js LTS를 사용하세요.

설치 없이 npx로 실행

원하는 작업 폴더에서 실행하세요. 전역 설치는 선택 사항입니다.

npx -y @joripspace/cli@latest start PROJECT --json

전역 설치 또는 업데이트

npm install -g @joripspace/cli@latest
joripspace --version
joripspace start PROJECT --json

명령어 확인

인자와 옵션은 설치한 CLI의 도움말을 기준으로 확인하세요. PROJECT에는 실제 프로젝트 이름을 넣습니다.

joripspace --help
joripspace start --help
joripspace deploy --help

다른 폴더를 지정할 때는 --cwd를 사용하세요. 공백이 포함된 경로는 따옴표로 감쌉니다. 인증정보는 작업 폴더의 Git 제외 파일 .env.joripspace에 저장되며, 정상 연결 후 같은 작업 폴더에서 다시 사용할 수 있습니다.

제작과 배포

1. 현재 상태 확인

   에이전트가 기존 소스, 프로젝트 실행 스크립트와 start의 다음 작업을 확인합니다.

2. 구현과 로컬 검증

   만들거나 수정할 기능을 전달하세요. 프로젝트에 맞는 빌드·검사를 실행하고 실제 화면과 동작을 확인합니다.

3. 조립스페이스로 배포

   연결된 GitHub 배포가 있으면 설정된 브랜치와 트리거를 따릅니다. 그 외에는 프로젝트에 맞는 CLI 배포 명령을 사용합니다.

4. 공개 주소 확인

   배포 결과와 서비스 URL을 확인하고 요청한 기능이 실제로 동작하는지 검증합니다.

프로젝트를 연결하는 것만으로 새 앱을 만들거나 배포하지는 않습니다. 원하는 기능과 배포 요청을 에이전트에 전달하세요.

현재 프로젝트의 구조를 확인하고 요청한 기능을 구현해줘. 로컬에서 빌드와 동작을 검증한 뒤 조립스페이스에 배포하고, 실제 서비스 주소와 확인 결과를 알려줘.

DB와 스토리지

DB · env.DB

서비스에서 조회·수정할 구조화된 데이터를 저장합니다. 실제 조회 조건과 인덱스를 함께 설계하고 스키마 변경은 마이그레이션으로 관리하세요.

스토리지 · env.STORAGE

사용자가 업로드한 파일과 운영 중 생성한 파일을 저장합니다. 파일의 메타데이터는 DB에서 관리할 수 있습니다.

배포에 포함할 파일

로고, 고정 디자인 이미지 같은 사이트 자산은 프로젝트 소스에 포함합니다. 업로드 파일과 구분해 관리하세요.

아래 도움말에서 현재 CLI가 지원하는 DB·파일 관리 명령을 확인할 수 있습니다.

joripspace db --help
joripspace storage --help

외부 서비스 비밀 키는 프로젝트 Secret으로 관리하고 브라우저 코드나 공개 저장소에 넣지 마세요.

문제 해결

공식 자료와 지원

문의: [email protected]