GRID.OS 핵심 구조 — 그리드·지침·뇌 — 스펙 브리핑

스펙 버전 v0.2 등급 L2 결정 8건 전건 승인 (2026-08-25) 코덱스 Sol Ultra 평의회 통과 — P0 13건 전건 반영

이 화면은 정본 마크다운 스펙의 보기 화면입니다. 정본: 01_기획·명세/03_인터널에디션/2026-08/2026-08-25_GRID.OS_핵심구조_그리드·지침·뇌_스펙.md (v0.3). 여기서 받은 결정은 즉시 정본에 되씁니다.

0핵심 구조 — 지침×뇌, 그리도스의 두 반쪽

이 스펙은 팀원 한정이 아니라 그리도스 전 제품 공통의 핵심 구조 정본입니다 (원우 정정 2026-08-25). 문서 위계: 이 스펙(뼈대) ↔ 뇌 개편 스펙(뇌 내부 구현, 계약으로 연결) / 팀원 온보딩은 이 뼈대의 1차 적용입니다.

지침 (AI.md)

«어떻게 일해야 하는가» — 규범.
사람이 승인해서 확정. 느리고 의도적으로 변함.
AI에게: 반드시 따를 것.

뇌 (기억 카드)

«무슨 일이 있었고 뭘 아는가» — 맥락.
대화·활동에서 자동으로 쌓이고 정제됨.
AI에게: 알고 시작할 것.

연결 고리 = 승격 파이프라인 — 흘린 말 → 뇌가 기억 카드로 정제 → 반복 확인 → «지침으로 올릴까요?» 제안 → 유저 승인 → AI.md 기록. 원우님이 2년간 손으로 돌려온 규칙 승격 루프의 자동판이며, «우리가 매일 쓰는 것만 판다»의 가장 큰 실물입니다.

일정은 분리(팀원 그리드는 뇌 없이 선출고), 설계는 연계(공통 계약 — 결정 카드 D6). 충돌하면 지침이 이기고, 이 우선순위는 문장이 아니라 코드로 강제합니다.

13분 요약

왜 만드는가 — 3.0을 팀에 배포한 첫날, 팀원이 자기 볼트를 그리드로 지정하지 못하는 무한 루프가 발견됐습니다. 앱이 «그리드 표식 있는 폴더»만 받는데, 표식을 설치해주는 온보딩은 연결된 뒤에야 뜨는 닭-달걀 구조입니다. 이 공백을 계기로, 그리도스 전 제품 공통의 그리드 시작 경로·지침 시스템(AI.md)·뇌 연계 계약을 한 번에 확정합니다. 결정 8장 중 7장이 전 제품 공통 결정이고, 팀원 한정은 D7 하나입니다.

사용자의 무엇이 달라지는가 — 팀원은 쓰던 볼트를 그대로(제자리·복제·흡수 중 선택) 그리드로 쓰기 시작하고, 신규 유저는 위치를 골라 새 그리드를 만들고 업무 폴더를 이식합니다. 누구의 그리드든 지침과 기억이 함께 자라는 구조로 태어나며, 신규 연결의 첫 기본값은 안전 권한이며, 권한 선택권은 유저에게 있습니다.

예상 기간 — 방향 확정 후 기술설계에서 산정 (팀원 2명 임시 통과는 D7 선택에 따라 즉시~수일) · 주요 위험 — 유저 볼트 훼손(전 경로 비파괴·백업·되돌리기로 방어) · 결정 필요 항목 — 8건

평의회 요약 — 원우님 지시로 코덱스 Sol Ultra가 초안(v0.1)을 코드와 대조해 적대 검토했습니다. 결과: P0 13건·P1 8건·P2 3건 — 전건 반영해 v0.2가 됐습니다. 굵은 것 4가지: ① 기록상 «수리 완료»였던 iCloud 수리가 실제 소스에 없음(재실측을 출발점으로 변경) ② 3택 중 복제·흡수는 신규 구현 필요 ③ 신규 연결이 유저 선택 없이 자유 권한으로 시작되는 위험 발견(초기 기본값을 안전으로 — 선택권은 유저에게 유지) ④ 팀원 임시 절차의 숨은 부작용 실측(절차 재설계 — D7). 검토 원문은 정본 옆에 보존.

2현재와 개발 후 비교

	지금	개발 후
볼트 보유 팀원	지정 → 거부 → 재시작 무한 루프. 통과 경로 없음	제자리·복제·흡수 3택으로 시작. 옵시디언·오르카 병행, iCloud 가능
볼트 없는 신규	«새 그리드 만들기»가 시작 흐름에 없음	위치 선택(추천/직접) → 생성 → 업무 폴더 이식까지 한 흐름
지침 파일	CLAUDE.md·AGENTS.md 두 벌 수동 동기화 — 한쪽만 갱신되는 사고 실재	AI.md 하나만 쓰고 나머지는 앱이 자동 복사 — 갈라짐 원천 차단
새 그리드의 지침	영문 뼈대뿐 — 운영 루프 없음 (심장 없는 그리드)	보편 운영 뼈대 5종(한국어) + 감시 검사 — 지침·기록이 살아서 갱신
신규 연결 권한	자동으로 자유 권한 시작 (평의회 발견)	첫 시작 기본값은 안전 권한, 이후 온보딩·설정에서 유저가 자유 권한 선택 가능
그대로 유지	유저 볼트의 폴더 구조·노트 (전 경로 원본 비파괴) · 기존 백업·되돌리기 · 원우 그리드 (이번 범위 무접촉)

3범위 경계

이번 버전에 들어가는 것

온보딩 5절차 + 후보→활성 상태 머신 + (a) 제자리 경로 완성
(b) 복제·(c) 흡수 트랜잭션 신규 구현
AI.md 단일 정본 + 자동 미러 + 기존 지침 승계 행렬
코어 운영 지침 팩 5종(한국어) + 감시 검사 신설
지침×뇌 공통 계약 정의 (실작동은 뇌 개편 스트림)
iCloud — 기준선 재실측 → 안전 매트릭스 → 실측 영수증 출고 조건
팀원 2명 임시 통과 (D7)

들어가지 않는 것 / 다음으로 넘기는 것

대화형 온보딩 풀버전 (3.0 계획대로 3단계)
원우 그리드의 AI.md 전환 (별도 트랙)
뇌 승격 파이프라인 실작동 (뇌 개편 스트림 몫)
제미나이 등 제3 CLI 미러 · 다기기 동기화 · 팀 공유 그리드 재설계

4영역별 의사결정 카드

✅ 8건 전건 승인 완료 (2026-08-25, 기계 대조 통과) — 아래 카드는 승인 당시 내용의 기록입니다. D1은 등록 진행 게이지 요건, D8은 온보딩 유저 확인 문항 조건이 정본에 반영돼 닫혔습니다. 변경이 필요하면 해당 카드만 다시 열어 재승인합니다.

D1전 제품 공통온보딩 표준 흐름을 «5절차 + 기존 볼트 3택 + 후보→활성 상태 머신»으로 확정할까요?

빌드 대장 권고 — 확정을 권고합니다. 팀원·신규 유저 모두 이탈 없는 경로가 생깁니다. 평의회 반영: 단순히 «검사만 완화»하면 다른 자물쇠 3개(완성도·입주 대기·입주 기록)에 다시 걸리므로, 후보→최소 설치→검증→활성이라는 상태 머신으로 만듭니다. 3택 중 복제·흡수는 현재 코드에 없어 신규 구현임을 전제합니다.

대안 — 신규 생성만 우선 지원 (영향: 팀원 2명이 계속 막힘, 볼트 보유 유저층 이탈)

D2전 제품 공통지침 파일을 «AI.md 하나만 쓰고, 클로드·코덱스용 파일은 앱이 자동 복사»로 확정할까요?

빌드 대장 권고 — 확정을 권고합니다. «클로드만 갱신되고 코덱스는 안 되는» 사고가 구조적으로 사라집니다. 평의회 반영: 감지·복원은 신규 구현이며(기존 훅은 비교만 함), 기존 코어 블록 엔진과 작성자가 겹치지 않게 단일 작성자로 이관하고, 볼트에 이미 있는 지침은 6가지 경우별 승계 행렬(임의로 다르면 자동 병합 금지·검토 대기)을 따릅니다. 원우님 그리드 자체의 전환은 별도 트랙입니다.

대안 — 두 파일 수동 동기화 유지 (영향: 갈라짐 사고 재발 — 실사고 이력 有) · 심링크 (영향: iCloud에서 깨짐 — 기각)

D3전 제품 공통새 그리드 기본 지침을 «보편 운영 뼈대 5종(한국어)만, 원우님 업무 규칙 미포함»으로 확정할까요?

빌드 대장 권고 — 확정을 권고합니다. 뼈대(지침 상속·새 폴더 지침 생성·작업 기록·세션 인계·규칙 승격 루프)만 제공하고 업무 규칙은 유저가 길러갑니다. 지침을 감시하는 기계 검사는 현행 닥터에 없어 신규로 정의합니다(평의회 반영).

대안 — 원우 그리드 규칙 전체 이식 (영향: 남의 업무 규칙 강제, 유지보수 불가)

D4전 제품 공통새 그리드 추천 위치를 «앱이 관리하는 홈 폴더»로 하고, 직접 지정 옵션을 함께 둘까요?

빌드 대장 권고 — 확정을 권고합니다. 유저에겐 «그리도스 기본 위치(추천)»로 보이되, 데이터는 앱 업데이트에 지워지지 않는 자리에 둡니다. 정확한 경로·이름 충돌·개인/팀 귀속 규칙은 기술설계에서 확정합니다.

대안 — 앱 번들 내부 (영향: 업데이트 때 그리드 유실 위험 — 기각)

D5전 제품 공통iCloud 공사를 «기준선 재실측 → 안전 매트릭스 → 실제 iCloud 테스트 영수증을 출고 조건»으로 이번 범위에 포함할까요?

빌드 대장 권고 — 포함을 권고합니다. 평의회 검증에서 중요한 사실이 확인됐습니다: 기록상 «수리 완료»였던 부분이 실제 소스에 없습니다. 그래서 «몇 곳 남았나»부터 다시 재는 것을 출발점으로 삼고, 실제 iCloud 폴더에서의 테스트 통과를 출고 조건으로 못박습니다.

대안 — 후속으로 미룸 (영향: iCloud 유저의 저장·이식 간헐 실패, 원인을 유저가 알 수 없음)

D6전 제품 공통지침×뇌 연계를 «일정은 분리, 설계는 계약 신설로 연결»로 확정할까요?

빌드 대장 권고 — 확정을 권고합니다. 평의회 반영으로 정직해진 부분: 뇌 개편 스펙에는 아직 «기억→지침 승격» 단계 자체가 없어, 형식을 골라 쓰는 게 아니라 계약(승격 큐·주입 우선순위·온보딩 이벤트 형식)을 새로 정의해야 합니다. 이번에 정의하고, 실작동은 뇌 개편 스트림이 구현합니다. 충돌 시 지침 우선은 문장이 아니라 주입 코드로 강제합니다.

대안 — 뇌 개편 완성까지 대기 (영향: 팀원 출고가 뇌 일정에 묶임) · 각자 설계 (영향: 만나는 지점이 어긋나 재공사)

D71차 적용 — 팀원대기 중인 팀원 2명(송한영·김승일)을 어떻게 통과시킬까요?

빌드 대장 권고 — (i) 정밀 런북 즉시 실행을 권고합니다 — 표식 설치 + 안전 권한 수동 고정 + 전체 변경 목록·복구 한계 사전 고지 + 테스트 볼트 선검증. 평의회 반영: v0.1의 단순 수동 절차는 부작용(전역 훅 설치·부분 복구 한계·자유 권한 시작)이 실측돼 기각했고, 코덱스는 (ii) 최소 구현 선행(수일)을 권합니다. 첫인상 손상이 진행 중이라는 점과 안전 사이의 판단입니다.

대안 — (ii) 최소 구현 선행: 정식 경로로 통과, 수일 소요 (코덱스 권고) · (iii) 기획 확정·구현까지 대기 (영향: 수 주 대기)

D8전 제품 공통팀원용 GRIDA 에디션(업무보드 없음)에서 일정.md(업무 데이터 파일)를 어떻게 할까요?

빌드 대장 권고 — «최소 조회 화면 제공»을 권고합니다. 평의회 지적: 보드가 없는데 일정 파일만 설치하면 AI만 읽고 유저는 볼 수 없는 숨은 업무 장부가 생깁니다. 최소한의 보기 화면을 주면 숨은 장부 문제가 사라지고 AI의 업무 맥락도 유지됩니다.

대안 — 읽기 전용 컨텍스트로만 유지 (영향: 유저가 자기 업무 데이터를 앱에서 못 봄) · 설치 제외 (영향: AI가 업무 맥락 없이 시작)

5온보딩 표준 흐름 (개념도)

판단용 개념 흐름입니다 — 실물 화면 시안은 이 브리핑 승인 후 UI 시안 게이트에서 따로 컨펌받습니다.

Q1. 쓰던 볼트(그리드)가 있나요?

있다 → Q2. 어떻게 쓸까요? (3택)

(a) 제자리 그대로 — 내 볼트를 그 자리에서 그리드로. 옵시디언·오르카 병행, iCloud 가능. 최소 그리드화만

(b) 복제해서 — 볼트는 그대로 두고, 사본을 원하는 위치에 그리드로 (신규 구현)

(c) 흡수 개편 — 그리도스 표준 구조의 새 그리드로 재편 + 위치 지정 (신규 구현)

없다 → Q3. 새 그리드 생성

Q4. 위치 선택 — 추천: 앱 관리 홈 폴더 / 옵션: 직접 지정

Q5. 업무 이식 — 기존 업무 폴더를 선택하면 지침과 함께 흡수

▼ 어느 경로든 (후보 → 최소 설치 → 검증 → 활성 상태 머신 위에서)

원본 비파괴 + 백업 + 되돌리기 · 첫 기본값 안전 권한(이후 유저 선택) · AI.md 지침 계층 설치 · 온보딩 답변은 규범(지침)/맥락(뇌)/설정으로 갈라 저장

6위험과 복구

유저 볼트 훼손 — 모든 경로 원본 비파괴. 설치 전 백업, 되돌리기 제공. 되돌리기 범위는 지금의 3파일에서 훅·상태 파일·미러까지로 확장해 정의합니다(평의회 반영).

권한 노출 — 신규 연결이 유저 선택 없이 자유 권한으로 시작되던 현행 동작을 «첫 기본값 안전 + 유저 선택 유지»로 교체합니다(평의회 발견, 원우 정정 반영).

iCloud 오판 — 기준선 재실측부터 시작해, 실제 iCloud 폴더 테스트 통과를 출고 조건으로 둡니다.

미러 충돌 — AI.md와 복사본이 동시에 바뀐 경우 자동 덮어쓰기하지 않고 양쪽 백업 후 검토 대기. 지침 오염 — 승격은 항상 유저 승인 후.

두 스트림 어긋남 — 이 스펙과 뇌 개편 스펙에 상호 참조를 걸었고, 계약 변경 시 양쪽 재승인합니다.

7접힌 기술 상세

개발부대가 쓰는 실측 근거·계약 (필요할 때만 펼쳐 보세요)

무한 루프 — looksLikeGrid(index.js:315)가 pick/set-grid에서 표식 없는 폴더 거부, resolveGridRoot(:341)가 config를 무시하고 폴백. 해소는 후보→활성 상태 머신 + pending 경로 결속({realpath,dev,ino,nonce}) + permMode safe 원자 기록.

평의회 P0 13건 처리 — 정본 스펙 §14 반영 로그에 전건 매핑. 코덱스 결정 제안 15건 중 제품 수준 1건(D8)만 원우 카드로, 나머지는 기술 계약 E-1~E-15로 재편(구현 기준선·복제/흡수 트랜잭션·특수 파일 표·온보딩 state v3·D2 분석 계약·주입 매트릭스·뇌 이벤트·승격 큐·iCloud 매트릭스·승인 도구 정합 등).

미러 엔진 — 3-way 판정(마지막 동기 해시 + 생성기 버전), 보장 시점 3개(부팅·debounce·세션 생성 직전), legacy core-block writer 이관으로 단일 작성자.

승계 행렬 — 부재/한쪽만/동일/전용 예외만 다름/임의로 다름/기존 AI.md 6경우. provider overlay 분리. 임의 차이는 자동 병합 금지.

iCloud — canonical·shadow 소스 모두 strict 신원 비교 확인, 기록상 수리(identityMatchesIgnoringCtime) 부재 — 기준선 재실측이 선행 조건.

에디션 전제 — 팀원 배포본은 GRIDA Edition(보드 미탑재). 일정.md 지위는 D8.