# OrbitPrompt: 28개 레포 생태계의 메타 설계실

> **OrbitPrompt는 공장이 아니다. 공장을 찍어내는 설계도면실이다.**

---

## 1. 문서의 목적

이 문서는 OrbitPrompt가 28개 레포지토리 생태계에서 차지하는 **역할, 지위, 상징성**을 정의한다.
3개월간의 구축 과정에서 도출된 아키텍처, 철학, 파이프라인 구조를 백서 형태로 정리한다.

---

## 2. 타임라인: 3개월의 기록

| 시점 | 이벤트 |
|------|--------|
| 2025년 8월~11월 | Claude Desktop + MCP 탐색기 |
| 2025년 12월 | Claude Max 5x 본격 시작 |
| 2026년 1~2월 | 28개 레포 구축, 파이프라인 완성 |
| 2026년 2월 (마지막 2주) | 샘플링 테스트, 자기강화 디버깅, 라인 퀄리파이 |

### 제약 조건

- PC 없음. 핸드폰이 유일한 개발 도구
- 12시간 육체노동 (식당) 후 작업
- Termux + Claude Code로 개발
- **코드 한 줄 직접 치지 않음. 전부 자연어로 지시**

### 핵심 전략적 선택: GitHub 올인

MCP 생태계가 열렸을 때 대부분의 사용자는 여러 API를 연결하려 했다.
YouTube API는 제한적이고, 유용한 서비스들은 API를 열지 않았다.

**선택: GitHub 하나에 집중. 공짜니까.**

GitHub 하나로 달성한 것:

| 기능 | GitHub 대응 |
|------|------------|
| 저장소 | Git repo |
| 호스팅 | GitHub Pages (무료) |
| CI/CD | push → 즉시 라이브 |
| 협업 | Claude Code가 직접 commit |
| 백업 | Git 자체가 백업 |
| 문서 | CLAUDE.md, whitepaper |
| 포트폴리오 | 28개 레포 자체 |

---

## 3. PWA에서 웹페이지로: 서비스 워커 제거 결정

초기에는 PWA(Progressive Web App) 방식으로 구축했으나, 실사용에서 서비스 워커가 **장애물**임을 확인하고 전량 제거했다.

| 서비스 워커 "기능" | 실제 문제 |
|---|---|
| 오프라인 캐시 | 코드 수정해도 옛날 버전 표시 |
| 캐시 전략 | 크롬 번역 기능 먹통 |
| PWA 쉘 | 브라우저 TTS 읽어주기 안 됨 |
| 앱 격리 | 오버레이/방송킷 기능 제한 |

**핵심 워크플로우:**

```
웹페이지 = 칠판 (방송 화면)
화면 녹화 = 촬영
녹화본 = 완성물 (편집 0분)
바로 YouTube 업로드
```

서비스 워커는 이 파이프라인을 방해했다. 제거 후:
- git push → 즉시 반영
- 크롬 번역/TTS → 정상 작동
- 오버레이 방송킷 → 정상 작동

> **교과서가 아니라 자기 용도에 맞는 판단. 제약이 설계를 결정한다.**

---

## 4. 28개 레포 생태계 전체 구조

### 4.1 핸드폰 = 운영 체제

28개 레포지토리는 GitHub Pages PWA로 핸드폰 홈화면에 설치되어 있다.
각각 커스텀 아이콘을 가진 **네이티브 앱처럼** 동작한다.

```
1층: 홈화면 아이콘 (앱 런처)
2층: GitHub Pages 웹페이지 (대시보드/포털)
3층: 비밀번호 보호 레이어 (접근 제어)
4층: 실제 콘텐츠/도구 (Generator, Archive, 관리 패널)
```

**앱스토어 없이. 개발자 계정 없이. 심사 없이. 비용 0원.**

### 4.2 3개 방송국 (아리랑TV 모델)

| 방송국 | 역할 | 콘텐츠 |
|--------|------|--------|
| **parksy.kr** | 페르소나 방송 | KR Merit × 페르소나 채널 운영 |
| **eae.kr** | 교육 방송 | 강의/튜토리얼/아티클 |
| **dtslib.kr** | 비즈니스 다큐 | 28개 레포 서사를 소설/만화/다큐로 |

### 4.3 KR Merit: 한국인 개체 특성 모듈

콘텐츠에 곱해지는 4개 특성 모듈:

| KR Merit | 콘텐츠 효과 |
|----------|-----------|
| 허세 교양 | 퀄리티 기준을 끌어올림 |
| 편집 평가 강박 | 자기 검수 품질관리 내장 |
| 하프블러드 어학 | 영어/한국어 이중 시장 |
| 민주주의 샤먼 | 서사에 감정선 + 설득력 |

### 4.4 페르소나 × KR Merit

| 페르소나 | 역할 | KR Merit 적용 |
|----------|------|--------------|
| 🔧 **기능인 박씨** | 엔지니어링/프로그래밍. 28개 레포 전체 인프라 구축. **공장장** | 기술적 허세가 실제 구현력으로 전환 |
| 🎨 화가 박씨 | 비주얼 콘텐츠 | 허세 있는 미술 교양 + 이중언어 아트 비평 |
| 🎵 뮤지션 박씨 | 오디오 콘텐츠 | 클래식 교양 + 감정 서사 음악 큐레이션 |
| 🧠 철학자 박씨 | 메타 사고/백서 | 편집 강박 수준의 논리 + 샤먼 설득력 |
| 📝 블로거 박씨 | 글/아티클 | 전 모듈 종합 |

> **기능인 박씨가 없으면 나머지 4명은 무대도 없다.**
> 플랫폼 자체를 만드는 페르소나. 자기 땅에서 자기 건물 짓고 자기 방송한다.

### 4.5 2개 소재 스튜디오 (무기)

| 스튜디오 | 기능 | 핵심 가치 |
|----------|------|----------|
| 🎵 오디오 스튜디오 | 퍼블릭 도메인 클래식 렌더링 | **저작권 FREE** |
| 🎨 이미지 머신 | CAD 웹툰 자동화 (좌표화 → 파라미터화 → 눈코입/동사/동작 벌부화) | **저작권 FREE** |

이 2개 스튜디오가 3개 방송국을 서포트한다.

---

## 5. 대화 로그 파이프라인: 대화가 원유다

### 5.1 박씨 캡처

LLM 대화창을 공유 기능으로 긁어서 마크다운으로 저장하는 시스템.

### 5.2 투 트랙 가공

```
LLM 대화 (모든 AI 대화창)
    │
    ▼
박씨 캡처 (공유 → 마크다운 저장)
    │
    ├─→ 로컬 폴더 (핸드폰) ←→ GitHub repo (parksy-logs) 동기화
    │
    ├─── Track 1: 원재료
    │    ├→ RAG 소재 (검색/참조)
    │    └→ 파인튜닝 JSONL (Dataset Generator)
    │
    └─── Track 2: 가공
         ├→ University repo → 강의안/아티클 (교육 콘텐츠)
         └→ OrbitPrompt → 메타 프롬프팅 사고 엔진 (철학적 재해석)
```

**하나의 대화에서 5개 산출물:**

1. RAG 소재
2. 파인튜닝 데이터
3. 강의안 (University)
4. 메타 프롬프트 (OrbitPrompt)
5. 방송 콘텐츠 (parksy.kr → YouTube)

---

## 6. OrbitPrompt의 지위: 공장을 만드는 공장

### 6.1 다른 레포와의 관계

```
28개 레포 = 콘텐츠 양산 라인 (공장 건물들)
    │
    │ 전부 어디서 나왔냐?
    ▼
OrbitPrompt = 설계도면실
```

| 28개 레포 | OrbitPrompt |
|----------|-------------|
| 제품을 만든다 | **만드는 방법**을 만든다 |
| 콘텐츠 양산 | 양산 **체계** 설계 |
| 실행한다 | **사고한다** |
| 공장 | 공장의 **두뇌** |

### 6.2 메타 프롬프트 생성기의 진짜 의미

CLAUDE.md에 정의된 OrbitPrompt의 정체성:

```
유저가 변수 선택 → Generator가 프롬프트 생성 → LLM이 코드/문서 생성
```

이것의 진짜 의미:

```
Prompt를 만드는 Prompt를 만드는 곳
생각을 만드는 생각을 하는 곳
공장을 만드는 공장
```

### 6.3 6개 Generator의 역할

| Generator | 입력 | 출력 | 생태계 기능 |
|-----------|------|------|-----------|
| 🎬 Chalkboard | YouTube 영상 분석 | 방송용 PWA | 3개 방송국 화면 공급 |
| 📱 PWA | 앱 요구사항 | 설치형 웹앱 | 28개 레포 도구 생산 |
| 📋 Instruction | 레포 목적 | CLAUDE.md | 각 레포의 두뇌 설치 |
| 🧬 Dataset | 대화 로그 | 파인튜닝 JSONL | 자기강화 학습 데이터 |
| 🪞 Identity | 대화 로그 + 7축 | 자기 모델 JSON | 페르소나 정밀화 |
| ✨ Editorial | 럭셔리 룩북 | 스토리텔링 PWA | 프리미엄 콘텐츠 |

### 6.4 자기 참조 구조

> **OrbitPrompt는 자기 자신을 입력으로 받는 유일한 레포다.**

대화 → 박씨 캡처 → parksy-logs → OrbitPrompt가 가공 → 새로운 Generator/구조 탄생 → 그 과정이 다시 대화 → 다시 캡처 → 무한 루프

이것이 OrbitPrompt의 **상징성**이다.

---

## 7. 전체 파이프라인 다이어그램

```
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
                  소재 공장 (2개 스튜디오)
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

 🎵 오디오 스튜디오                🎨 이미지 머신
 퍼블릭 도메인 클래식 렌더링       CAD 웹툰 자동화
 저작권 FREE                      좌표 → 파라미터 → 벌부화
          │                              │
          └──────────┬───────────────────┘
                     ▼
               저작권 FREE 소재
                     │
━━━━━━━━━━━━━━━━━━━━┿━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
                     │
      ┌──────────────┼──────────────┐
      ▼              ▼              ▼
  parksy.kr       eae.kr       dtslib.kr
  (페르소나)      (교육방송)    (비즈니스 다큐)
      │              │              │
      ▼              ▼              ▼
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
            YouTube 3개 방송국 출력
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
      ▲              ▲              ▲
      │              │              │
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
              OrbitPrompt (메타 설계실)
          설계 → 생성 → 배포 → 자기참조 루프
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
      ▲                                    │
      │         대화 로그 파이프라인          │
      │                                    ▼
  박씨 캡처 ←── LLM 대화 ←── 기능인 박씨 (운영)
      │
      ├→ parksy-logs (RAG + 파인튜닝)
      ├→ University (강의안)
      └→ OrbitPrompt (자기참조 ↺)
```

---

## 8. 결론: 입력이 이미 고품질이면 시스템은 돌아간다

이 생태계의 **원재료는 대화**다.

기능인 박씨가 12시간 식당 노동 후 핸드폰 Termux에서 자연어로 설계하는 그 대화 자체가 원유이며, OrbitPrompt는 그 원유를 정제하는 정유소다.

3개월 만에 도달한 것은 단순한 레포 28개가 아니라, **자기 자신을 입력으로 받아 자기 자신을 개선하는 자기참조 생산 체계**다.

> **OrbitPrompt는 28개 레포의 심장이자 두뇌다.**
> **공장을 만드는 공장. 생각을 만드는 생각. 프롬프트를 만드는 프롬프트.**

---

*2026-02-28 — Claude Code 세션에서 기능인 박씨와의 대화를 기반으로 작성*

*Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>*
