본문으로 건너뛰기

v1.5.0 — 사내 매체 다리 (internal-liaison)

변화 요약

internal-doc-tools 스킬(Confluence/Notion/Jira/이미지 영입판)이 프로젝트에 들어오면서, manuscript 와 사내 매체를 잇는 양방향 다리를 정원에 심었다.

핵심 통찰: 이 다리가 들어올 자리는 이미 비어 있었다.

  • publication-pipeline Type 3(외부 입력형)이 ⏳ 자리만 확보 상태로 대기 중이었고,
  • docs-publisher 와 엔진의 위임표가 "Notion/Confluence 미러링 → tamer Mode B 제안" 으로 새 꽃을 기다리고 있었다.

새 능력은 그 두 자리를 동시에 채운다 — 영입(읽기)미러(쓰기).

사용자 결정(이번 사이클): 주력 매체 = Notion 양방향. Confluence/Jira 쓰기는 능력만 열어두고 비주력.

신규 에이전트 (Layer 2)

agents/internal-liaison.md (신규) — 사내 매체 연락관

[[docs-publisher]] 가 원고를 바깥(공개 사이트) 으로 보낸다면, 연락관은 안(사내 Notion) 으로 미러하고 안의 글감을 들인다.

  • 모드 1 미러(쓰기): published 원고 → Notion upsert(멱등) + 미러 표식 콜아웃
  • 모드 2 영입(읽기): 사내 문서 fetch → draft/<slug>.md 인계 (Type 3 Stage I-0)
  • 모드 3 점검: 게이트·시크릿·인증·미러 목록 진단
  • 트리거는 에이전트 frontmatter 에만 등록 (internal-doc-tools 의존 → 표준 SKILL.md 오염 금지, skill-separation 원칙)

신규 지식 (Layer 1)

knowledge/internal-media.md (신규)

사내 매체 연동의 운영 기준 을 별도 문서로 분리.

  • internal-doc-tools 4능력 라우터 + 스크립트/시크릿 경로
  • 활성화 게이트/internal-doc-tools 선행 실행 필수
  • 단일 출처 규칙 — manuscript 가 진실, 사내 사본은 단방향 파생본
  • 영입(읽기) vs 미러(쓰기) 양방향 원칙 + Notion 읽기 MCP 폴백 전략
  • Notion 명령 빠른 참조 / 트러블슈팅 / 채택 의사결정 기록

갱신된 워크플로우 (Layer 3)

engine/publication-pipeline.md

  • Type 3 영입부 정식화: ⏳ → ✅. Stage 0 자리에 "Stage I-0: 영입(internal-liaison)" 절차 추가. fetch → 정화 → draft 인계 후 Type 1 Stage 1~ 공통.
  • Stage 6 (선택) 사내 미러 신설: Type 1 게시 후 독립 coda. published 글을 Notion 으로 멱등 미러. 단일 출처 규칙 명시.
  • 위임표: "외부 입력형 영입", "사내 미러" → [[internal-liaison]] 로 명시 (기존 tamer Mode B 폴백에서 승격)

agents/docs-publisher.md

  • 위임표: "사내 매체 미러/영입" → [[internal-liaison]] 추가 (기존 "Confluence 미러링 → tamer Mode B" 자리를 정식 위임으로 교체)

미변경 (의도적)

  • 엔진 2개 그대로 — 미러/영입은 새 엔진 없이 publication-pipeline 의 Stage(I-0, 6)로 흡수 (v1.4.0 의 Type 4 처리 방식과 동일)
  • 검수단 3인(doc-reviewer/style-enforcer/terminology-keeper)·full-review·manuscript-architect 흐름 그대로
  • Confluence 미러·Jira 쓰기는 정식 모드로 만들지 않음 — 사용 사례 미발생. 두 번째 요청 누적 시 tamer Mode B
  • 이미지 생성은 기존 image-gen 경로 우선 (internal-doc-tools 의 image-gen.mjs 는 중복 보조 경로)

→ 1.5.0 은 새 에이전트 1명(internal-liaison) + 새 지식 1권(internal-media) + 엔진 Type 3 정식화 + Stage 6 신설 의 minor.

정원지기 평가 (3축)

점수메모
워크플로우 개선도A비어 있던 Type 3·미러 자리를 정확히 채움. 새 엔진 없이 기존 물길에 흡수 — 구조 비용 최소
Claude 스킬 활용도4/5internal-doc-tools 의 Notion 양방향을 정식 연동. Confluence/Jira/이미지는 미연동(의도) — 5점은 실제 운영 1회 후
하네스 성숙도L47에이전트·2엔진·6지식. 양방향 매체 다리까지 확보. L5 는 미러/영입 실운영 검증 후

다음 후보

  • 첫 미러 실행 → 멱등 upsert·미러 표식 동작 검증 (L5 승급 신호)
  • 첫 영입 실행 → 사내 식별자 정화율·draft 골격 적합성 점검
  • 게시-동시-미러 자동화(Stage 6 자동 발동) — 수동 미러 2회 누적 후 검토
  • Confluence 미러 요청 누적 시 internal-liaison 모드 추가 (tamer Mode B)
  • Jira 소재 인용이 글에 실제 쓰이면 manuscript-architect 의 소재 조사 절차에 편입