# GRID.OS 다음 제품 개발 안내 — 개발 스펙

팀 공유본 1.0 · 2026-09-13

제품 방향과 주요 흐름을 기준으로 정리한 개발 계약 초안입니다. 실제 제품 구현·계정 연결·배포 검증 완료를 뜻하지 않습니다.

## 제품 범위

- **이번 개발에 포함**: 팀원 어드민 8화면, 기능 자동 수집·버전 관리, 내 앱 적용·복구, 선택 빌드, 퍼스널 온보딩, Claude/Codex 공통 대화 기준, Mac 초대 베타.
- **이후 단계**: Windows 출시, 퍼스널 셀프 회원가입·결제, 팀 외 공개 기능 장터. 실제 제품 출하는 후보 검증 이후 별도 절차로 진행합니다.
- **이번 페이지에서 가능한 것**: 기획·확정 사항·개발 계약 읽기, 20개 화면의 입력·선택·점검·실패·복구 시연. 실제 AI 로그인·계정 발급·파일 설치·제품 빌드는 수행하지 않습니다.

## 확정 방향

- **개인 AI 계정으로 시작**: Claude 또는 ChatGPT 계정 중 하나를 공식 연결 경로로 연결합니다. GRID.OS 계정과 AI 계정은 별개입니다.
- **기능은 별도 제출 없이 자동 등록**: 기능별로 묶고 버전을 누적합니다. 검사 중인 기능도 상태를 보여주되 사용 가능 판정과 구분합니다.
- **종류에 따라 팀 공개**: 독립 위젯·스킬은 검사 통과 후 자동 공개. 본체 패치와 보안 경계 변경은 관리자 확인 후 공개. 지침 조각은 승계 제안으로 검토합니다.
- **목록은 표, 세부 내용은 상세 패널**: 효과·제작자·버전·호환성으로 비교합니다. 앱에서 적용과 파일 다운로드 두 경로를 제공합니다.
- **최종 적용 전에 AI 점검**: 제품 구성은 기능 목록과 오른쪽 구성표로 만듭니다. 구성 변경 뒤에는 AI 점검과 기계 검증을 다시 실행합니다.
- **선택과 자유대화를 함께**: 짧은 필수 대화에 충분한 심층 인터뷰 선택을 더합니다. 정정한 내용과 수동 선택은 우선 반영합니다.
- **온보딩 이후 첫 결과물은 나에 대한 보고서**: 구성 적용을 끝내고 내 공간에 진입한 다음 팝업으로 제안합니다. 파악한 사실·AI의 제안·앞으로 알아갈 내용을 보기 좋은 HTML로 정리합니다.
- **Mac 초대 베타부터**: 소수 사용자로 설치·AI 연결·온보딩을 검증한 후 유료 출시합니다. 문제 패키지는 해당 기능 적용만 중단하고 기존 앱과 자료를 유지합니다.

## 개발 계약

필드 이름은 계약 초안이며 기존 API·저장 경로와의 정확한 대응은 기준 소스 대조 후 고정합니다.

### 계정·팀·기기 접근

사용자에게 허용된 팀 기능과 본인 기기만 조회·변경하게 합니다.

**필수 데이터**

- GRID.OS userId · teamId · role · membershipState
- deviceId · ownerId · platform · appVersion · lastSeen
- 초대 식별자·만료·수락 상태, 다운로드/기기 연결 요청 식별자

**동작 규칙**

- GRID.OS 계정과 개인 AI 실행 계정을 분리합니다. 계정·역할·초대 기반은 기존 라이선스 서버에서 재사용할 범위를 대조합니다.
- 모든 조회·다운로드·적용 요청에서 팀·역할·기기 소유권을 검사합니다. 메뉴를 숨기는 것만으로 권한을 처리하지 않습니다.
- 만료·탈퇴·접근 해제·역할 변경 후 새 요청과 진행 중 요청의 유효성을 다시 검사합니다. 기존 업무 자료는 원격 삭제하지 않습니다.

**상태**

- 초대 대기 → 수락 → 활성
- 만료 / 취소 / 이메일 불일치 / 로그인 만료 / 접근 해제

**완료 조건**: 팀 간 URL/API 직접 접근, 초대 재사용·만료, 다른 기기 지정이 거부되고 정상 초대·내 기기 연결이 완료됩니다.

### 자동 수집·기능 카탈로그

안정된 개발 변경을 기능별로 묶고 덮어쓰지 않는 버전 목록으로 관리합니다.

**필수 데이터**

- featureId · version · authorId · teamId · baseVersion
- kind: 독립 기능(widget/skill) / corePatch / instructionFragment
- 파일 목록·크기·hash·발행자 서명·의존성·권한·검사·제공 상태

**동작 규칙**

- 승인된 개발 영역에서 안정된 변경 묶음을 수집합니다. 일반 업무·고객 자료·자격증명은 제외하고 애매한 묶음은 분류 확인 상태로 둡니다.
- 등록 중단은 로컬 큐에서 재개합니다. 동일 변경의 중복 등록과 뒤늦은 버전의 최신 덮어쓰기를 막습니다.
- 독립 위젯·스킬은 검사 후 자동 공개, 본체·보안 경계 변경은 관리자 확인 후 공개합니다. 지침 조각은 설치 패키지가 아닌 승계 제안으로 다룹니다.
- 기준 버전이 다른 본체 패치는 재기반이 필요합니다. 공개 중단·공식 기능 채택에도 원본과 기여 이력을 보존합니다.

**상태**

- 감지 → 등록 → 분류 → 검사 → 사용 가능
- 분류 확인 / 검사 실패 / 재기반 필요 / 관리자 확인 / 제공 중단

**완료 조건**: 제작자 A의 기능 1개가 자동 등록되어 팀원 B에게 정확한 버전으로 전달되고 중복·순서 역전·민감 자료 제외 시험을 통과합니다.

### 다운로드·내 앱 적용·복구

확인한 기능을 선택한 기기에 적용하고 결과와 되돌릴 지점을 남깁니다.

**필수 데이터**

- operationId · featureId · fixedVersion · targetDevice
- 구성 지문·검사 결과·발행자/서명/hash·현재 상태
- 스냅샷·적용 확인·재시작 확인·복구 확인 기록

**동작 규칙**

- 앱 열기 링크에는 기능/버전과 단기 요청 식별자만 담고 앱이 다시 조회·검사합니다. 링크 방문만으로 설치하지 않습니다.
- 독립 기능은 패키지 경로, 본체 변경은 후보 빌드/업데이트 경로를 사용합니다. 임의 소스 덮어쓰기와 업무 자료 변경을 자동 실행하지 않습니다.
- 서명·출처·무결성 검사 실패 시 해당 기능 적용만 중단합니다. 기존 정상 앱·자료를 유지하고 정상 패키지 재다운로드·재검사로 연결합니다.
- 적용 전 복구 지점을 준비합니다. 중단 뒤에는 이전 실행 확인부터 대조하고, 불명확한 쓰기 작업을 무조건 반복하지 않습니다.

**상태**

- 점검 → 준비 → 적용 → 재시작/실행 확인 → 완료
- 호환 불가 / 점검 무효 / 중단 / 결과 확인 필요 / 복구 중 / 복구 실패

**완료 조건**: 실제 기능 실행·재시작 후 유지·이전 구성 복구가 검증되고, 손상 패키지/오프라인/중단에도 기존 자료가 보존됩니다.

### 제품 구성·빌드 후보

선택된 기반과 기능 버전으로 재현 가능한 제품 구성을 고정합니다.

**필수 데이터**

- recipeId · edition · platform · baseVersion
- 고정 featureVersion 목록·필수 기능·기본값·온보딩 규칙
- recipeHash · candidateId · 산출물 hash · 검사/복구 기록

**동작 규칙**

- 공통 로그인·자료 보호·복구·업데이트·기록은 필수 기반입니다. 끌 수 있는 일반 선택 기능으로 다루지 않습니다.
- AI는 문제를 설명하고 해결안을 제안합니다. 의존성·권한·OS·무결성 검사는 코드로 강제합니다. 조합 변경 뒤에는 이전 점검을 무효화합니다.
- 구성 지문과 잠금 버전을 고정해 같은 구성을 다시 만들 수 있게 합니다. 설치 파일의 비트 동일성은 별도 입증 전 약속하지 않습니다.
- 빌드 후보는 설치 파일·구성표·검증·변경점·복구 자료를 묶습니다. 후보 생성과 실제 팀/고객 배포를 분리합니다.

**상태**

- 구성 중 → 점검 → 문제 해결 → 재점검 → 후보 생성 → 검증
- 필수 누락 / 충돌 / 기준 변경 / 버전 취소 / 빌드 실패

**완료 조건**: 선택·점검한 구성과 후보의 기능 버전·산출물 지문이 같고, 잘못된 조합은 빌드되지 않습니다.

### 대화 기반 온보딩·실제 커스텀

사용자가 확인한 내용을 지원 기능 안의 폴더·기능·AI 지침으로 연결합니다.

**필수 데이터**

- interviewId · providerSession · 답변 원문 참조
- confirmedFacts · 출처 · profileRevision · 수동 선택
- configurationRevision · 변경 목록 · 검증/적용 결과 · reportId

**동작 규칙**

- AI 도구가 없는 단계는 앱의 고정 안내가 설치·로그인을 돕습니다. 연결과 실제 응답 성공을 따로 확인합니다.
- 선택 답변과 자유대화를 함께 받고 짧은 시작/충분한 인터뷰를 모두 지원합니다. 사용자의 정정·수동 제외는 이전 AI 추론보다 우선합니다.
- 대화 → 확인된 사실 → 변경안 → 점검 → 적용 → 실제 결과를 연결합니다. 정보 부족·미지원 기능은 추가 질문 또는 기본안으로 처리합니다.
- 기존 자료의 이동을 강제하지 않습니다. 새 그리드·기존 폴더 연결·복사 후 정리를 구분하고 변경 전 원본을 보존합니다.
- 온보딩 완료 후 내 공간에서 사용자 이해 보고서를 제안합니다. 보고서에는 사실·제안·미확인 내용을 구분합니다.

**상태**

- 연결 → 대화 → 이해·정정 → 구성 제안 → 검증·적용 → 완료
- 추가 질문 / 중단·재개 / 미지원 / 충돌 / 적용 실패 / 보고서 재시도

**완료 조건**: Claude/Codex 각각 7가지 대화·정정·중단·충돌 사례에서 실제 구성과 지침이 기대 결과에 맞고 기존 자료가 보존됩니다.

### Claude·Codex 공통 대화 기준

AI가 달라도 지시·권한·상태·중단·재개·결과 확인은 GRID.OS 기준으로 처리합니다.

**필수 데이터**

- 기존 conversation binding · providerSessionId · 입력 ID
- turn/run 시도 · CLI/protocol 버전 · capability 확인
- 지시·자료 revision · 처리 확인 · 오류 범주 · checkpoint

**동작 규칙**

- 기존 chat-session-bindings·chat-queue·run-events를 재사용합니다. 인터널 Codex 대화의 app-server도 기존 기반입니다.
- 같은 업무 지시·자료·허용 범위를 전달합니다. 도구·첨부·승인 지원 차이는 시작 전에 확인하고 변환할 수 없는 필수 기능은 명시합니다.
- 접수·진행·승인 대기·중단 중·결과 확인·완료를 구분합니다. 모델의 완료 문장이나 프로세스 종료만으로 파일 작업 성공을 판정하지 않습니다.
- 기존 세션 재개 실패를 새 세션으로 숨기지 않습니다. 다른 회사 AI로 이어갈 때는 사용자가 선택한 범위만 새 세션에 인계합니다.
- 사용자 AI 자격증명은 제품이 수집·중개하지 않는 경로를 기준으로 합니다. 기존 Claude 사용량 직접 읽기 경로는 그대로 이식하지 않고 공식 지원 대안을 검증합니다.

**상태**

- 접수 → 준비 → 진행 ↔ 승인 대기 → 결과 확인 → 완료
- 중단 중 / 중단됨 / 재연결 / 결과 확인 필요 / 실패

**완료 조건**: 같은 고정 자료와 권한의 CD01~CD12를 두 제공자에서 통과합니다. 필수 기준 차이를 모델 고유 특성으로 덮지 않습니다.

## 어드민 8페이지

### P01 로그인·초대 수락

- 이용 역할: 팀원·관리자 공통
- 목적: GRID.OS 계정으로 팀에 들어오기
- 데이터: 계정 이메일, 초대받은 팀·초대한 사람, 초대 유효 상태
- 행동: 로그인·계정 생성, 초대 수락, 다른 계정 로그인, 초대 재요청
- 정상 결과: 로그인과 팀 소속 확인 후 홈. 기존 앱과 같은 GRID.OS 계정 사용. AI 계정 비밀번호는 받지 않음.
- 예외: 만료·취소된 초대, 이메일 불일치, 팀 미가입, 연결 실패를 구분하고 재로그인·재초대로 연결.
- 경계: 초대 기반 가입 권고. 초대 링크 소지만으로 다운로드 권한을 주지 않고 수락된 멤버십 확인. 현행 어드민은 운영자 단일 토큰이라 계정 로그인·역할 분리는 신규 구축이며 라이선스 서버 계정·초대 링크를 재사용.

### P02 팀 홈

- 이용 역할: 팀원·관리자 공통
- 목적: 새 기능과 내 앱에 필요한 행동 확인
- 데이터: 최근 자동 등록 기능, 검증된 새 버전, 내 기기 연결 상태, 최근 적용·실패·복구
- 행동: 기능 상세, 내 기기 연결, 검사 결과, 업데이트 비교
- 정상 결과: 팀원은 기능 탐색·내 앱 적용, 관리자는 검사 대기·제품 후보도 제공.
- 예외: 기능 0건·기기 미연결·조회 실패 각각 안내. 실패 시 마지막 조회 시각과 재시도.
- 경계: 공유 대상 기능만 팀에 표시. 다른 사람의 개인 업무나 그리드 내용은 노출하지 않음.

### P03 기능 목록·비교

- 이용 역할: 팀원·관리자 공통
- 목적: 필요한 기능 고르기
- 데이터: 이름·제작자·설명·시연, 버전·기준 앱·OS, 검사 중/사용 가능/제한, 필수 기능·대안
- 행동: 검색·제작자/상태 필터, 표 목록·오른쪽 상세, 기능 2개 비교, 상세 열기
- 정상 결과: 같은 역할의 기능을 효과·환경·검증 결과로 나란히 비교.
- 예외: 검색 0건, 검사 중, 제공 중단, 분류 불확실을 이유와 함께 표시.
- 경계: 자동 등록과 설치 허용은 별도. 검사 중은 목록에 보이나 적용·빌드 선택 제한.

### P04 기능 상세·버전

- 이용 역할: 팀원·관리자 공통, 제품 채택은 관리자
- 목적: 영향을 이해하고 적용 경로 선택
- 데이터: 시연·사용 방법·제작자, 버전별 변경점·검증 일시, 내 앱 호환 여부, 권한·필수 기능·충돌·복구
- 행동: 내 GRID.OS에 적용, 파일 다운로드, 이전 버전 비교, 관리자: 제품 포함, 제작자: 설명 보정
- 정상 결과: 정확한 버전 선택 후 내 앱 사전 점검 또는 제품 구성표로 이동.
- 예외: 기기 미연결·버전 불일치·검사 실패·버전 취소·권한 부족은 행동을 막고 다음 선택 안내.
- 경계: 수정 버전을 기존 버전으로 덮지 않음. 다운로드 이력과 제품 구성표는 원래 버전을 참조. 채택 시 제작자 원본은 «공식화됨»으로 접고 백업, 릴리스 노트에 기여자 표기.

### P05 내 기기·적용 기능

- 이용 역할: 본인 기기만
- 목적: 어느 앱에 어떤 기능이 있는지 확인
- 데이터: 기기 별명·OS·앱 버전, 최근 연결 시각, 설치 기능·출처·버전, 커스텀·업데이트 상태
- 행동: 앱에서 기기 연결 승인, 대상 기기 선택, 호환성 새로 확인, 업데이트 비교, 연결 해제
- 정상 결과: 명시적으로 고른 기기만 적용. 미응답 기기는 대기/만료 상태로 안내.
- 예외: 앱 미설치·오프라인·연결 만료·기기 중복·버전 불명. 파일 다운로드 경로 제공.
- 경계: 웹 링크를 여는 것만으로 설치하지 않음. 딥링크에 임의 명령·경로를 넣지 않음. 관리자도 타인 기기 임의 조작 불가.

### P06 적용 이력·복구

- 이용 역할: 본인 이력
- 목적: 적용 결과와 되돌릴 방법 확인
- 데이터: 기능·버전·기기, 점검/준비/적용/재시작/확인, 실패 원인·재시도 여부, 복구 지점·이전 구성
- 행동: 진행 상태, 실패 지점 재시도, 이전 구성 복구, 진단 내보내기
- 정상 결과: 앱의 실제 실행 확인 후 성공 표시. 복구도 실행·자료 확인 뒤 완료.
- 예외: 응답 없음·다운로드 중단·서명 불일치·적용 실패·복구 실패를 구분.
- 경계: 진단 내보내기는 비밀정보 제거와 포함 자료 확인. 기능 제거와 데이터 삭제를 구분.

### P07 제품 구성·빌드·배포 후보

- 이용 역할: 관리자·제품 담당자만
- 목적: 기능을 골라 출시 후보로 고정
- 데이터: 제품·에디션·기반·OS, 선택 기능·고정 버전, 필수·충돌·검증 상태, 설치 파일·구성표·검증·복구
- 행동: 구성 복제·기능 선택, 후보 빌드, 검증 상세, 후보 다운로드, 별도 출하 승인
- 정상 결과: 관리자·제품 담당이 선택→AI 점검·기계 검증→후보→검증을 수행합니다. 실제 출하는 별도 절차입니다.
- 예외: 빌드 실패·충돌·기반 변경·버전 취소·실기 미검증에 진행률과 재시도 지점 표시.
- 경계: 메뉴 숨김과 별개로 서버 API에서 역할 검사. 후보 생성과 배포 권한 분리.

### P08 팀원·권한·등록 검사

- 이용 역할: 관리자만
- 목적: 팀 접근과 기능 제공 상태 관리
- 데이터: 팀원·초대·가입/대기/중지, 역할·접근 범위, 자동 등록·검사 실패·분류 확인, 버전 제공 중단·감사 기록, 보안 경계 변경 격리·재기반 필요
- 행동: 초대·재초대, 역할 변경·접근 해제, 묶음 분리·합치기, 검사 재시도·제공 중단
- 정상 결과: 권한 변경을 즉시 새 요청에 반영. 진행 중 다운로드·적용 요청도 정책에 따라 중단·재검증.
- 예외: 마지막 관리자 제거 차단, 중복·만료·잘못된 이메일, 수집 실패·비밀정보 검출 격리.
- 경계: 직접 URL/API도 팀 경계를 검사. 접근 해제는 기존 로컬 업무 자료를 원격 삭제하는 권한이 아님. 보안 경계 변경·기준 버전 불일치 패치는 자동 게시하지 않고 관리자 판정.

## 공통 대화 검증

CD01~CD12를 동일한 자료·권한으로 Claude/Codex에 각각 적용하는 12쌍 기본 시험입니다. 실제 실행 전입니다.

- **CD01 설치·로그인·상태 실패**: 도구 없음, 로그아웃, 확인 불가를 구분하고 실제 응답을 확인합니다.
- **CD02 같은 지시·자료**: 지시 버전과 고정 자료를 기준으로 근거 있는 답변을 만듭니다.
- **CD03 파일 작업 완료**: 허용 경로의 파일 내용·저장·재시작 후 보존을 확인합니다.
- **CD04 승인·거절·취소**: 요청 범위가 확대되지 않고 해당 작업에만 반영됩니다.
- **CD05 중간 정정 2건**: 입력 접수와 실제 반영의 순서·중복을 확인합니다.
- **CD06 중단과 뒤늦은 사건**: 중단 확인 전 완료하지 않고 다른 실행을 덮지 않습니다.
- **CD07 연결·서버 재시작**: 원래 세션으로 돌아오거나 명확한 복구 실패를 표시합니다.
- **CD08 쓰기 직후 응답 손실**: 이미 실행한 내용을 대조하고 불명확한 작업을 자동 반복하지 않습니다.
- **CD09 도구·첨부 지원 차이**: 실행 전에 차이와 가능한 다음 행동을 설명합니다.
- **CD10 만료·한도·장애**: 원인을 구분하고 입력을 보존합니다.
- **CD11 AI 변경 인계**: 확정 지시·현재 결과·다음 행동을 선택한 범위로 전달합니다.
- **CD12 CLI·모델·사건 순서 변경**: 호환성을 확인하고 중복·과거 사건에도 상태를 유지합니다.

입력/실행 ID, 자료 지문, CLI 버전, 예상·실제 상태, 제공자 사건과 결과 확인 근거를 남깁니다. 같은 문장 출력 여부로 판정하지 않습니다.

## 개발 순서

- **00 기준 고정** (0.5–1일 가설): 배포된 .55·실소비 소스·개발 저장소와 .56 이월 작업을 대조합니다. / 산출물: 기준 지문·대상 파일·제외 범위·다음 시험 1개
- **01 계약·공통 대화 보강** (기존 설계 2–4일 + 추가 4–8일 가설): 기존 결속·큐·실행 기록을 재사용하고 두 연결부에 같은 인수 기준을 적용합니다. / 산출물: 공통 계약·지원 기능표·CD01~CD12 시험 자료
- **02 기능 교환 한 경로 완주** (6–10일 가설): 팀원 A의 기능이 자동 등록되어 팀원 B의 앱에서 적용·복구되도록 만듭니다. / 산출물: 카탈로그·공개 규칙·적용/복구 결과
- **03 제품 조합·후보 빌드** (3–5일 가설): 기능과 버전을 고정하고 AI 점검·기계 검증·후보 보관을 연결합니다. / 산출물: 구성표·후보·검증·변경점·복구 자료
- **04 퍼스널 맞춤 시작** (4–7일 가설): 초대·공식 AI 연결·대화·구성 적용·완료 후 보고서를 연결합니다. / 산출물: 두 AI의 온보딩 사례·재시작 후 결과
- **05 Mac 초대 베타 검증** (3–5일 + 외부 대기 가설): 새 사용자 Mac·다른 팀원 기기에서 설치·업데이트·복구를 확인합니다. / 산출물: 서명/공증·실기 증거·출하 후보

기존 전체 추정 22–38작업일에 공통 대화 보강 4–8일을 단순 합산한 26–46작업일 가설입니다. .56과의 중복·재사용·실기 결과를 반영해 착수 전 재산정합니다. 각 행은 배치 설명용 범위이며 별도 운영/인증 보강분이 있어 행 합계가 전체 가설과 같지는 않습니다. 달력상 약속이나 AI 연속 실행 시간이 아닙니다.

## 출하 전 확인

- **개발 기준**: 실소비 소스·기준 버전·.56 이월 중복·수집 대상 영역 고정
- **계정·제공 조건**: 실제 CLI 버전의 로그인·승인·재개와 적용되는 제품 제공 조건 확인
- **두 기기 실사용**: 제작자와 적용자의 실제 기기에서 기능 교환·업데이트·복구 검증
- **Mac 출하**: 새 사용자 환경, 서명·공증, 필수 시나리오·원본 보존 검증 완료

## 근거

- 기획 정본: 2026-09-11 제품 조립·기능 교환·퍼스널 기획 + 09-13 확정 사항
- 상세 명세: 2026-09-13 연결 체험·공통 대화 기준 / 정적 코드 조사
- OpenAI 공식 연결: https://learn.chatgpt.com/docs/app-server
- Claude Code 공식 실행: https://code.claude.com/docs/en/headless
- Claude Code 제품 제공 조건: https://code.claude.com/docs/en/legal-and-compliance