HOW TO USE SPARK

아이디어 회의를
개발 문서로 바꾸는 법.

SPARK가 AI를 직접 호출하지는 않습니다. 요청문을 Codex 또는 Claude에 전달하고, AI가 만든 JSON을 다시 가져오는 방식입니다.

2회 AI 요청5단계 팀 워크숍0개 API 키
QUICK START

전체 흐름 한눈에 보기

  1. 01

    주제와 조건 입력

    해커톤 주제를 쓰고 필요하면 개발 시간, 팀원, 기술과 제약사항을 조정합니다.

  2. 02

    아이디어 요청

    요청문을 복사해 Codex 또는 Claude에 보내고, 반환된 JSON을 SPARK에 붙여넣습니다.

  3. 03

    팀에서 하나로 결정

    후보 3개의 문제, AI 역할, 데모와 구현 가능성을 비교하고 선택 이유를 남깁니다.

  4. 04

    개발 패키지 요청

    디자인 레퍼런스를 정한 뒤 두 번째 요청문으로 SSOT·디자인·구조·테스트 문서를 만듭니다.

  5. 05

    문서 검토와 전달

    일관성 검사를 확인하고 개발 문서 ZIP과 프로젝트 JSON을 저장합니다.

01—02

주제를 입력하고 첫 번째 AI 요청을 보냅니다.

  1. 주제와 조건 입력

    주제는 짧게 입력합니다. 팀 조건이 기본값과 다를 때만 ‘조건 더 입력하기’를 엽니다.

  2. ‘Codex·Claude 요청 복사’ 선택

    클립보드에 후보 3개를 요청하는 프롬프트가 복사됩니다.

  3. Codex 또는 Claude에 그대로 전송

    AI가 설명 없이 spark-ideas-v2 JSON만 출력할 때까지 같은 대화에서 수정 요청합니다.

  4. ‘아이디어 결과 붙여넣기’로 가져오기

    AI의 응답 전체를 복사해 입력칸에 붙여넣고 ‘아이디어 가져오기’를 누릅니다.

붙여넣을 것처음 복사한 요청문이 아니라 AI가 답한 JSON 결과
03

후보를 비교하고 팀의 선택 근거를 남깁니다.

후보 카드를 선택하면 상세 내용과 팀 점수를 수정할 수 있습니다. 문제 명확성, AI 필요성, 30초 데모, 구현 가능성을 우선 확인하세요.

확인할 것입력 → AI 판단 → 실제 행동

세 단계가 화면에서 끊기지 않아야 합니다.

남길 것이 아이디어를 선택한 이유

심사 기준과 제한 시간 안의 구현 근거를 씁니다.

선택 이유를 작성한 뒤 ‘이 아이디어로 확정하기’를 누르면 디자인 단계로 이동합니다.

04

디자인 레퍼런스와 두 번째 AI 요청으로 문서를 완성합니다.

  1. 디자인 레퍼런스 선택

    getdesign.md·getdesign.kr의 DESIGN.md 프롬프트를 ‘참고 DESIGN.md 내용’에 붙여넣거나 직접 방향을 작성합니다.

  2. ‘개발 패키지 요청 복사’ 선택

    확정 아이디어와 디자인 조건이 포함된 두 번째 프롬프트가 복사됩니다.

  3. Codex 또는 Claude에 전송

    AI가 spark-build-pack-v2 JSON을 반환하도록 요청합니다.

  4. 개발 패키지 결과 붙여넣기

    반환된 JSON을 가져오면 SSOT, DESIGN.md, ARCHITECTURE.md, 테스트와 실행 문서가 생성됩니다.

디자인 URL시각 설계의 참고 출처이며 기존 서비스 비교용 공식 출처 URL과는 별개입니다.
05

일관성을 확인하고 두 파일을 저장합니다.

개발자에게 전달

개발 문서 ZIP

SSOT, 디자인 가이드, 구조, 테스트, 작업 규칙을 한 번에 내려받습니다.

회의를 이어서 작업

프로젝트 JSON

팀의 후보, 선택 이유와 생성 문서를 저장하고 나중에 다시 불러옵니다.

문서를 직접 고쳤다면 일관성 검사의 오류와 경고를 확인하세요. 기능 ID F-001~F-003이 화면, 모듈, 테스트에서 같은 의미로 연결돼야 합니다.

HELP

가져오기가 안 될 때

JSON 형식이 올바르지 않다고 나옵니다.

AI 답변의 설명 문장은 제외하고 JSON 전체만 붙여넣으세요. 계약 이름이 첫 요청은 spark-ideas-v2, 두 번째 요청은 spark-build-pack-v2인지 확인합니다.

공식 출처 URL 관련 메시지가 나옵니다.

디자인 레퍼런스 URL을 요구하는 메시지가 아닙니다. 기존 서비스 비교가 실제 공식 페이지로 확인됐는지를 뜻합니다. URL이 없다면 SPARK가 자동으로 ‘추가 확인 필요’로 처리합니다.

아이디어를 수정했더니 문서를 다시 만들라고 합니다.

아이디어와 문서가 달라졌기 때문입니다. 선택 이유를 다시 확정한 뒤 새 개발 패키지 요청을 복사해 문서를 재생성하세요.

작업하던 내용이 보이지 않습니다.

같은 브라우저라면 자동 저장 내용을 복구합니다. 다른 기기로 옮길 때는 ‘현재 작업 저장’으로 받은 프로젝트 JSON을 불러오세요.

READY?

이제 주제 하나로 시작하세요.

팀과 화면을 함께 보며 후보를 비교하면 됩니다.

워크숍 시작하기 →