“기술이 어려운 게 아니라 첫 3시간이 어렵다.” 진입장벽 3중(Termux·AI CLI·출판 시스템)을 설치기 + 진단기 + 출판 명령어 3종으로 5~10분에 압축하면 “개발자용 도구”가 “출판자가 쓰는 도구”로 넘어간다.
배경 — 왜 이 설계가 나왔나
커뮤니티 리서치에서 확인된 것: 이 구조(말 → 검증 → 원본 Git 보존 → Pages+Tistory 동시 출판)의 상품성은 교육·출판 시장에 있다. 교사·강사·연구자·교육기관이 “말로만 콘텐츠를 만들고 영구 보존·자동 출판”하는 가치를 바로 알아듣는다.
그런데 그 상품화의 진짜 장벽은 기술이 아니라 진입(온보딩)이다. 이 구조를 남에게 설명하며 설치시키는 일이 “교육 콘텐츠”가 아니라 “설치 지원 업무”가 되어버린다.
진입장벽 3중
| 층 | 내용 |
|---|---|
| ① Termux | pkg·python·pip·PATH·저장소 권한·실행 권한부터 낯설음 |
| ② AI CLI | Aider 설치 + provider·API endpoint·API key·환경변수·Git 설정 맞추기 |
| ③ 출판 시스템 | GitHub 인증 → repo → Pages → 빌드 → Tistory → 자동화 |
커뮤니티 실증 (Reddit / Termux)
r/termux에서 Aider 설치가 multidict·numpy·scipy에서 막힌 사례가 실제 존재.- DeepSeek 사용자: Aider를 두고 “설치가 고통스러웠다” — 여러 agent harness를 갈아타며 설정 문제를 겪음.
- Termux에서 AI 에이전트 설치 = 패키지 설치 → CLI 설치 → 모델/API 설정 → WebUI 설치의 다단계.
- 반대로 최근엔 Termux 특수 환경을 이해하도록 만든 전용 AI 도구가 등장할 정도로, 환경 구축 자체가 사용자에게 큰 장벽.
핵심 통찰
기술이 어렵지 않다. 첫 3시간이 어렵다.
그 3시간을 인스톨러가 5~10분으로 압축하면 이야기가 완전히 달라진다. 그래서 지금 필요한 건 설명서가 아니라 3종 도구다:
- 설치기 (ONE-CLICK BOOTSTRAP)
- 진단기 (출판 doctor)
- 출판 명령어 (말로 출판)
이 셋이 붙어야 “나 혼자 쓰는 시스템”이 “남에게 가르칠 수 있는 시스템”이 된다.
설계 1 — ONE-CLICK BOOTSTRAP (설치기)
사용자는 딱 하나만 실행한다:
Termux 설치 → 제공된 설치 명령 1개
그 명령이 자동으로:
- Termux 환경 검사
- 필요 패키지 설치
- Python / Git 확인
- Aider 설치
- 설정 파일 생성
- API 인증 안내
- GitHub CLI / 인증
- 작업 디렉터리 생성
- 출판 템플릿 설치
- 빌드 도구 설치
- 테스트
- 샘플 프로젝트 생성
→ 끝: “설치 완료 — 출판이라고 말하세요.”
선생님 버전 비교:
- ❌ “Termux 설치하고 Python 환경 구축한 다음 GitHub CLI 인증하고 Aider에 DeepSeek API 연결한 다음 repo clone하고…” → 90% 첫날 탈락
- ✅ “이거 설치하세요. 끝나면 출판 준비 완료라고 뜹니다.” → 완전히 다른 상품
설계 2 — 출판 doctor (진단기)
문제가 생기면 출판 doctor 한 줄로 환경 전체를 검사, 깨진 곳을 한국어로 알려준다:
✓ Termux
✓ Python
✓ Git
✓ Aider
✓ API 인증
✓ GitHub 인증
✓ Repository
✓ Pages
✓ Tistory 설정
✓ Renderer
✓ Publishing pipeline
→ “남의 컴퓨터 붙잡고 ‘이거 입력하세요 → 뭐 떴어요? → 그거 말고요’ 하는 지옥”에서 해방.
설계 3 — 출판 명령어
설치·진단이 끝나면 실제 일은 “말로” 한다. 원고 하나 = 출판 <제목> 정도로 게이트·빌드·Pages·Tistory 동시 발행까지 이어지게.
보안 설계 (필수)
- API 키를 설치 스크립트 안에 박아 넣지 않는다.
- 사용자가 직접 한 번 입력/인증 → 설치기는 그 값을 안전하게 로컬 설정에 저장.
- GitHub 인증도 사용자가 직접 (
gh auth login). - 책임 분리: 설치기 = 환경 구축, 사용자 = 자기 계정 인증.
전환점 — 상품 정의
| 전 | 후 |
|---|---|
| “티스토리 자동화” | “말로 콘텐츠를 만들고 원본을 영구 보존하며 웹·인터랙티브·웹진까지 자동 출판하는 AI 출판 파이프라인” |
| 개발자용 도구 | 출판자가 쓰는 도구 |
| 설명서를 가르침 | 설치기·진단기·명령어를 배포 |
핵심 자산은 코드가 아니라 이 구조의 방법론·템플릿·운영 규칙 — 지금 _notebook에 쌓여 있는 절차들.
다음 스텝 (스코프)
- [ ]
bootstrap.sh스캐폴드 — 위 12단계를 한 스크립트로 (환경 검사→설치→샘플→완료 문구) - [ ]
doctor.sh— 11개 체크 항목 + 한국어 진단 출력 - [ ]
출판명령 래퍼 — 원고 → 게이트 → 페어 빌드 → Pages + Tistory - [ ] 보안 경계 — API 키/GitHub 인증은 사용자 직접, 스크립트엔 비밀 하드코딩 금지
- [ ] (보류) 실제 배포 — 지금은 S21 특화, 일반화는 UX 한 겹 이후
관련: [[surface-web-engine-native]] (티스토리=빌린 플랫폼, GitHub=SSOT) · [[reverse-publishing-pattern]] · [[tistory-textbook-methodology]]