S21 Phone
Webzine/ Notebook/ 출판 파이프라인 — 원클릭 부트스트랩 + 출판 doctor 설계
Notebook · lakme-audio

출판 파이프라인 — 원클릭 부트스트랩 + 출판 doctor 설계

"기술이 어려운 게 아니라 **첫 3시간**이 어렵다." 진입장벽 3중(Termux·AI CLI·출판 시스템)을 **설치기 + 진단기 + 출판 명령어** 3종으로 5~10분에 압축하면 "개발자용 도구"가 "출판자가 쓰는 도구"로 넘어간다.

Source · _notebook/95-publishing-bootstrap-doctor_Claude.md Kind · markdown S21 Phone Editorial

“기술이 어려운 게 아니라 첫 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)


핵심 통찰

기술이 어렵지 않다. 첫 3시간이 어렵다.

그 3시간을 인스톨러가 5~10분으로 압축하면 이야기가 완전히 달라진다. 그래서 지금 필요한 건 설명서가 아니라 3종 도구다:

  1. 설치기 (ONE-CLICK BOOTSTRAP)
  2. 진단기 (출판 doctor)
  3. 출판 명령어 (말로 출판)

이 셋이 붙어야 “나 혼자 쓰는 시스템”이 “남에게 가르칠 수 있는 시스템”이 된다.


설계 1 — ONE-CLICK BOOTSTRAP (설치기)

사용자는 딱 하나만 실행한다:

Termux 설치 → 제공된 설치 명령 1개

그 명령이 자동으로:

  1. Termux 환경 검사
  2. 필요 패키지 설치
  3. Python / Git 확인
  4. Aider 설치
  5. 설정 파일 생성
  6. API 인증 안내
  7. GitHub CLI / 인증
  8. 작업 디렉터리 생성
  9. 출판 템플릿 설치
  10. 빌드 도구 설치
  11. 테스트
  12. 샘플 프로젝트 생성

→ 끝: “설치 완료 — 출판이라고 말하세요.”

선생님 버전 비교:


설계 2 — 출판 doctor (진단기)

문제가 생기면 출판 doctor 한 줄로 환경 전체를 검사, 깨진 곳을 한국어로 알려준다:

✓ Termux
✓ Python
✓ Git
✓ Aider
✓ API 인증
✓ GitHub 인증
✓ Repository
✓ Pages
✓ Tistory 설정
✓ Renderer
✓ Publishing pipeline

→ “남의 컴퓨터 붙잡고 ‘이거 입력하세요 → 뭐 떴어요? → 그거 말고요’ 하는 지옥”에서 해방.


설계 3 — 출판 명령어

설치·진단이 끝나면 실제 일은 “말로” 한다. 원고 하나 = 출판 <제목> 정도로 게이트·빌드·Pages·Tistory 동시 발행까지 이어지게.


보안 설계 (필수)


전환점 — 상품 정의

“티스토리 자동화” “말로 콘텐츠를 만들고 원본을 영구 보존하며 웹·인터랙티브·웹진까지 자동 출판하는 AI 출판 파이프라인”
개발자용 도구 출판자가 쓰는 도구
설명서를 가르침 설치기·진단기·명령어를 배포

핵심 자산은 코드가 아니라 이 구조의 방법론·템플릿·운영 규칙 — 지금 _notebook에 쌓여 있는 절차들.


다음 스텝 (스코프)

관련: [[surface-web-engine-native]] (티스토리=빌린 플랫폼, GitHub=SSOT) · [[reverse-publishing-pattern]] · [[tistory-textbook-methodology]]