톡브릿지 활용 트랙 (TalkBridge How-To Track)
글 한 편 = 독자가 오늘 끝내는 한 가지 일.
1. 이 트랙은 무엇이 다른가
| 하네스 시리즈 | 해피톡 스핀오프 (080~) | 톡브릿지 활용 트랙 | |
|---|---|---|---|
| 무엇을 쓰나 | 우리가 AI와 일하는 방식 | 제품이 푸는 CX 문제 | 제품을 잘 쓰는 법 |
| 독자 | AI에 관심 있는 IT 입문자 | CX 리더·운영 담당자 | 톡브릿지 파트너·도입 검토자 (운영자 / 개발자) |
| 화자 | 중립 서술자 또는 페르소나 | 해피톡 제품팀 | 톡브릿지 팀 ("저희", "여러분") |
| 어조 | 평어 | 존댓말 | 존댓말 |
| 은유 | 정원·꽃·물길 | 없음 | 없음 |
| 마무리 | 라틴어 격언 + 💙 | 체크리스트·CTA | 다음 단계 + CTA |
category | harness / tool / field-note | product | talkbridge |
200편(M020)이 톡브릿지를 만든 이야기를 정원의 말로 썼다. 이 트랙은 톡브릿지를 쓰는 이야기다. 그쪽 어휘(정원·하네스·에이전트 스무 명·PDSA)는 이쪽에 오지 않는다.
2. 독자 — 두 라벨
| 라벨 | 누구 | 다루는 것 | 번역 규칙 |
|---|---|---|---|
| 운영자 | 코딩 없이 상담을 운영하는 분 — 소상공인·CX 담당자 | MCP · 브릿지 스킬 · Discord/Slack 간편 연동 · 센터 설정 · 과금 | 개발 용어는 생활 비유로. 명령줄 없음 |
| 개발자 | 자체 시스템에 붙이는 분 | API · 웹훅 · 서명 · 멱등 · CLI · 게이트웨이 · Self-Build Bot | 코드 예시 허용. 약어는 첫 등장 풀어쓰기 — 단 개발자 상식 약어(API · CLI · REST · HTTP(S) · DNS · TLS · JSON · SQL · URL)는 면제. 제품·프로토콜 고유 약어(MCP · SSE · HMAC · SDK 등)는 반드시 풀어쓴다 (M021 검수에서 확정) |
- 글마다 하나를 고른다. 둘 다 필요하면 두 편으로 쪼갠다
- 표기: 3줄 요약 앞에 한 줄 —
> 이 글은 **운영자**(코딩 없이 상담을 운영하는 분)를 위한 글입니다. - [[reader-centered-voice]]의 독자 호명·입문 독자 렌즈는 이 트랙에도 적용한다 — 특히 ⑥ "쉽게 말해" 문장
3. 화자와 어조
- 화자는 톡브릿지 팀. "저희 톡브릿지는", "여러분의 채널에서". 특정 개인 페르소나를 세우지 않는다
- 존댓말. 평어 혼용 금지
- 독자를 직접 부른다 — "지금 카카오 채널 심사를 기다리고 계신다면"
- 겸손한 단정: 되는 것은 "됩니다", 안 되는 것은 "아직 안 됩니다"로 분명히. 되는 척하지 않는다
- [[writing-style-guide]] §사람 목소리는 여기도 적용한다. 단 따라하기 절의 번호 목록과 준비물 목록은 트랙 구조상 예외(스타일 수호자가 세지 않는다)
4. 구조 템플릿
글마다 줄이거나 합칠 수 있으나 순서는 지킨다:
# 제목 — 독자의 일이 보이게 ("점심시간에 폰 없이 상담 세 건 처리하기")
> 이 글은 **운영자/개발자**를 위한 글입니다. ← 독자 라벨
> 3줄 요약 ← 이 글을 읽고 나면 할 수 있게 되는 것
## 1. 이런 순간이 있으셨나요 ← 시작 장면: 현장의 한 마디 (인용체 1~2줄)
## 2. 준비물 ← 계정·채널 상태·키·앱. 각각 "어디서 확인하나" 한 줄
## 3. 따라하기 ← 번호 단계. 단계마다 끝에 "확인: ~가 보이면 된 것입니다"
## 4. 이렇게 하면 막힙니다 ← 조심할 것 2~4개 (세션·키·과금·권한)
## 5. 다음 단계 ← 이어서 할 일 한두 가지 + CTA
- 제목에 제품 기능명이 아니라 독자의 일을 쓴다. "MCP 연동 가이드"(✗) → "Claude에서 대화로 카카오 상담 답하기"(✓)
- 3절은 화면 캡처 또는 명령 블록과 짝을 이룬다. 캡처에는 가상 브랜드("○○베이커리")만
- 4절 없이 게시하지 않는다 — 막히는 곳을 미리 말해 주는 것이 이 트랙의 값어치다
5. 사실 규율
- 명령·화면 경로·숫자·제약은 [[talkbridge-product]]에 있는 것만 쓴다. 없으면 문서를 열어 확인하고 정본에 추가한 뒤 쓴다
- 사실마다 문서 절대 URL을 인라인 또는 "참고 문서" 절에 둔다 (
https://api.talkbridge.io/...) - 요금을 언급하면 "상담 1건 = 상담방이 열린 날 기준(KST), 같은 고객과 같은 날 여러 번 대화해도 1건" 정의를 반드시 같이 쓴다 (2026-09-20 문서 표현으로 갱신)
- 준비 중 기능은 "준비하고 있습니다" 수위. 출시 확정·시점 약속 금지
- 카카오 심사 절차는 카카오의 몫 — 일수를 단정하지 않고 카카오 문서로 안내
5-b. 문제를 누구의 것으로 쓰는가 (2026-09-13 확정)
이 트랙은 문제 → 톡브릿지가 준비한 해답 순서로 전개한다. 문제의 주체를 틀리면 제품이 문제를 못 푸는 것처럼 읽힌다.
| 쓰지 않는다 | 쓴다 |
|---|---|
| "톡브릿지를 붙이시는 분들께 가장 많이 듣는 어려움은…" | "카카오톡으로 상담 서비스를 만들려다 다른 플랫폼이나 직접 연동으로 시도하셨던 분들께 듣는 어려움은…" |
| 어려움만 나열하고 끝 | 어려움 뒤에 "톡브릿지는 바로 이 자리를 없애려고 만들었습니다" + 준비한 해답 |
| 톡브릿지 사용 중에 생긴 문제처럼 보이는 서술 | 직접 붙일 때 겪는 일 ↔ 톡브릿지로 시작할 때 대비표 |
- 파트너의 실제 문의를 인용할 때도 어느 시점의 문의인지를 분명히 한다 — 도입 전(직접 연동 시도)인지, 도입 후 운용 중인지
- 제품의 알려진 한계(cli-feat 등)는 숨기지 않는다. 다만 한계 → 지금의 우회 → 다음 버전 계획 순으로 적어 해결 경로가 함께 보이게 한다
- 자사 문서의 갭을 적을 때는 "저희가 먼저 걸어 보고 메웠다"는 개선 서사로 — 갭의 존재만 남기지 않는다 (M021 2절 선례)
6. 금지
- 정원·꽃·물길 은유, 라틴어 격언, "하네스의 이야기는 계속됩니다 💙", 평어 — 하네스 시리즈 컨벤션 전부
- 하네스·에이전트·저장소·제품 내부 구현·개발 과정 언급 (200편의 영역)
- 예외: 톡브릿지 제품·저장소가 쓰는 고유명(블룸 정원의 하네스, 정원지기, 전문가 페르소나명,
/harness-creator)은 인용한다. 서술 은유(꽃·물길·햇빛·씨앗)로 확장하지 않는다 — tb-01에서 확정
- 예외: 톡브릿지 제품·저장소가 쓰는 고유명(블룸 정원의 하네스, 정원지기, 전문가 페르소나명,
- 실고객·실브랜드 식별자, 실제 연결 키·시크릿·웹훅 URL, 상담 내용 실물
- 경쟁 제품 비하. 비교는 "톡브릿지가 하는 것"만으로
- 집필 사정 메타 문장([[reader-centered-voice]] §2-3-b)
허용: 카카오톡·카카오 상담톡·Discord·Slack·Claude·ChatGPT 이름 명시. 해피톡 등 패밀리 서비스 언급.
7. 이미지 — 캐릭터 카드 (2026-09-13 개정)
정본은 [[talkbridge-visual-style]]. 요약하면:
- 캐릭터 카툰 — 고정 캐릭터 다섯(다리·말풍선 손님·상담원·개발자 곰·검수 로봇), 모델
gpt-image-2.5-flare, 무텍스트. 아키텍처 그림이 아니라 그 절의 결론을 담은 이야기 카드다 - 카드 아래에는 "그림으로 말하면" 인용 박스 2~3줄 — 기술어 없이 같은 내용을 한 번 더
- 화면도 카툰으로 그린다(2026-09-13 개정) — 실제 스크린샷 대신 캐릭터가 보고 있는 화면으로. 버튼·글자를 모사하지 않고 칸 구성과 아이콘만([[talkbridge-visual-style]] §3 화면을 그릴 때). 실물 캡처는 저장소 README로 안내. 정확한 흐름·구조는 mermaid. 예외: 캡처가 곧 데모인 개발 보강 절은 공개 저장소 캡처를 왜곡 없이 싣는다([[talkbridge-visual-style]] §3 예외, 2026-09-16 M022)
- 저장:
manuscript/articles/images/<order>-<slug>/, 캐릭터 시트는images/_talkbridge-characters/ - (구 규칙: 인포그래픽·플랫 벡터 — M021 1차 게시까지 적용. 캐릭터 카툰으로 대체됐다)
8. 파일 · frontmatter
| 항목 | 규칙 |
|---|---|
| 브리프 | draft/tb-NN-<slug>.md (NN 두 자리, 01부터). 백로그는 draft/tb-00-톡브릿지-주제백로그.md |
| 원고 | manuscript/articles/<order>-<slug>.md, order는 기존 시퀀스를 이어 210부터 10 단위 |
category | talkbridge |
code | 기존 M 시퀀스 이어감 (M021~) — [[docs-publishing]] §글 링크 체계 |
title | 독자의 일. 시리즈 순번 접두 없음 |
description | 독자 라벨 + 이 글로 끝내는 일 한 줄 |
| status 흐름 | 기존과 동일 draft → review → published ([[manuscript-conventions]]) |
화자 모드 게이트([[writing-modes]]): 이 트랙은 화자가 규약으로 고정되므로 브리프에 "화자: 톡브릿지 팀 · 존댓말"을 적고 질문을 생략한다.
9. 마무리 CTA (고정 문구, 글마다 한 줄 변형 가능)
톡브릿지 센터에서 카드 등록 없이 시작하실 수 있습니다 — 30일 동안 상담 3건이 무료입니다. https://console.talkbridge.io/ · 문서 https://api.talkbridge.io/ · 막히시면 help@talkbridge.io
10. 검수 체크리스트 (talkbridge-guide 트랙 규약 검수)
| # | 점검 | 통과 |
|---|---|---|
| ① | 독자 라벨 한 줄이 3줄 요약 앞에 있다 | 있음 |
| ② | 제목·1절이 독자의 한 가지 일을 말한다 | 기능명 제목 아님 |
| ③ | 시작 장면(현장의 한 마디)이 있다 | 1절 |
| ④ | 따라하기 각 단계에 "확인" 문장이 있다 | 빠진 단계 0 |
| ⑤ | "이렇게 하면 막힙니다" 절이 있고 세션·키·과금·권한 중 해당 항목을 다룬다 | 2개 이상 |
| ⑥ | 사실마다 문서 URL, 요금엔 "1건" 정의 병기 | 누락 0 |
| ⑦ | 금지 항목(§6) 0건 | grep: 정원·하네스·에이전트·💙·격언 |
| ⑧ | CTA 마무리 | §9 |
| ⑨ | 캡처·예시에 가상 브랜드만 | 실식별자 0 |
검수 조합: [[full-review]] 세 눈(명료성·문체·용어) + [[talkbridge-guide]](사실 대조·이 체크리스트). 스타일 수호자는 이 트랙의 톤 규칙(존댓말·팀 화자)으로 톤 매칭을 본다.
관련
- [[talkbridge-guide]] · [[talkbridge-product]]
- [[writing-modes]] — 트랙과 화자 모드는 직교. 이 트랙은 화자 고정
- [[reader-centered-voice]] · [[writing-style-guide]] · [[manuscript-conventions]]