본문으로 건너뛰기

v1.3.0 — 첫 사이클(v1.0.0 사이트 태그) 회고를 엔진에 반영

변화 요약​

원고 1편(010-문서시스템-하네스도입)이 사이트 태그 v1.0.0 으로 게시되기까지의 실제 흐름을 정원지기가 회고한 결과, publication-pipeline 엔진의 정의가 실제 사이클과 어긋난 지점이 여러 개 발견되어 정식화·보강했다.

엔진 자체는 같은 v1.2.0 형태로 유지하되, 유형 카탈로그 와 Stage 분리 가 더 정확해졌다.

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

engine/publication-pipeline.md — 전면 개편​

유형 카탈로그 신설​

유형진입상태
Type 1초안 시작형 (draft/<>.md)✅ 검증됨
Type 2직접 작성형 (manuscript/articles/ 바로)⏳ placeholder
Type 3외부 입력형 (Notion/GDoc 등)⏳ placeholder
Type 4수정/리비전형 (이미 published)⏳ placeholder
Type 5시리즈형 (관련 N편 묶음)⏳ placeholder

"새 유형을 미리 만들지 않는다. 두 번 발생해야 자리가 잡힌다."

Type 1 상세 — 실제 사이클 반영​

이전 v1.2.0 의 5단계(Stage 1~5) → v1.3.0 의 6+1 단계:

Stage변경
Stage 0 (신설)draft/<slug>.md 초안 작성 — 자유 형식, 사람 작업
Stage 1 (변경)단순 골격 생성 → "초안→정식 원고 변환" 로 확장 (1A: drafterless / 1B: drafted-first / 1C: 보조 자산 판단)
Stage 2 (신설)편집장 개입 — image-gen 스킬 호출로 히어로 카드/절별 시각자료 생성
Stage 3 (유지)full-review 엔진 호출
Stage 3.5 (신설)보강 적용 + 재검수 루프 — 차단 사유 해소
Stage 4 (유지)형식 lint + status 승급
Stage 5 (수정)main push → v* 태그 push 로 트리거 변경

새 유형 발견 절차​

사용자가 기존 유형으로 안 잡히는 진입을 들고 오면 → tamer 가 Type N 후보 로 식별 → 카탈로그 placeholder 추가 → 2회 누적 시 본격 Stage 작성.

갱신된 에이전트 (Layer 2)​

agents/manuscript-architect.md​

신규 트리거 추가:

  • "이 초안으로 원고 만들어 / draft 로 원고 짜줘"
  • "초안 → 원고 변환"
  • "보조 이미지 판단 / 히어로 카드 / 절별 이미지 생성"
  • "권장 보강 적용"

실행 모드 확장:

  • 1A: Drafterless 골격 생성 (기존)
  • 1B (신규): Drafted-first 변환 — 초안 정독, 외부 자료 보강, frontmatter 작성
  • 1C (신규): 보조 자산 생성 판단 — 시각화 가치 점검, image-gen 호출, alt 텍스트 임베드
  • 2.5 (신규): 권장 보강 적용 — full-review 차단 사유 해소

갱신된 지식 (Layer 1)​

knowledge/docs-publishing.md — 트러블슈팅 4건 누적​

v1.0.0 사이클에서 실제로 막혔던 4가지를 트러블슈팅 표에 영구 보존:

증상한 줄 조치
gh run list 의 workflow name 이 파일 경로로 표시YAML 파싱 실패 — 로컬 yaml.safe_load 로 줄 식별
step name: 에 콜론+공백 포함 시 즉시 실패step 이름을 큰따옴표로 감싸기
태그 push 에 not allowed to deploy due to environment protection rulesgh api -X POST .../deployment-branch-policies -f name='v*' -f type='tag'
Pages 가 internal repo 에서 public: falsegh api -X PUT .../pages -f public=true

미변경 (의도적)​

  • agents/ 영수증: tamer / doc-reviewer / style-enforcer / terminology-keeper / manuscript-architect / docs-publisher 6명 그대로
  • engine/ 두 개(full-review, publication-pipeline) 그대로
  • knowledge/ 5권 모두 그대로
  • 스킬(image-gen) 그대로
  • frontmatter / status / 자리표시자 규약 그대로

→ 1.3.0 은 하네스 자체의 골격은 그대로 두고, 한 사이클을 굴린 결과를 엔진과 에이전트의 절차 정의에 누적한 패치-수준 변화. 다만 신규 mode (1A/1B/1C, 2.5) 가 추가되어 trigger 표가 늘었으므로 minor 로 표기.

다음 후보​

  • 두 번째 글 사이클로 Type 1 흐름의 안정성 재검증
  • Type 2 (직접 작성형) 의 첫 사례 발생 시 절차 작성
  • 루트 페이지(/tech-writing-harness/) 의 404 해소 — 카드형 목록 또는 첫 글 redirect
  • Node 20 → 24 워크플로우 actions 버전 업그레이드 (2026-09 까지 여유)