본문으로 건너뛰기

v1.4.0 — Type 4 (이슈 기반 리비전) 정식화

변화 요약​

출판 후 발견된 편집 요청을 GitHub Issue 기반으로 받기로 결정. 이전 v1.3.0 의 placeholder 였던 Type 4 를 정식 워크플로우로 승격하면서, "같은 증상이 원고 문제일 수도 빌드 깨짐일 수도 있다" 는 핵심 통찰을 트리아지 단계로 분리.

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

engine/publication-pipeline.md — Type 4 정식화​

유형 카탈로그 상태 변화​

유형이전 (v1.3.0)현재 (v1.4.0)
Type 4⏳ placeholder✅ 정식화

Type 4 흐름 5단계 (Stage R-0 ~ R-4)​

R-0  이슈 수집           (gh issue list --label editorial)
 │
R-1  트리아지             (manuscript-architect)
 │       └─ manuscript-fix / build-fix / rejected 분류
 ├─→  R-2A  원고 수정     (manuscript-architect)
 ├─→  R-2B  빌드/렌더링 수정  (docs-publisher)
 │
R-3  안전 재검수
 │       └─ 회귀 점검 (다른 글에 영향 없는지)
 │
R-4  PATCH 태그 배포      (docs-publisher)
        └─ gh issue close + 코멘트

안전 규칙 4가지​

  1. manuscript-fix 와 build-fix 를 한 PATCH 에 섞지 않음 (회귀 원인 식별)
  2. manuscript-fix 시 status: published 유지 (롤백 X, 새 리비전 O)
  3. rejected 도 코멘트 의무 (재발 방지)
  4. 재현 불가 시 보류 + 정보 요청 (무리한 추정 fix 금지)

신규 지식 (Layer 1)​

knowledge/issue-triage.md (신규)​

이슈 트리아지의 판단 기준 을 별도 문서로 분리. 여러 에이전트가 공유.

내용:

  • 라벨 컨벤션 (editorial / manuscript-fix / build-fix / rejected / regression)
  • 결정 트리 (3단계 — 원고 본문 → 로컬 빌드 → 캐시/CDN)
  • 시그널 표 (manuscript-fix 6종 / build-fix 7종 / rejected 3종)
  • gh CLI 명령 컨벤션 (트리아지 / close)
  • 통계 누적 활용 (월별 라벨 비율 → 다음 사이클 우선순위)

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

agents/manuscript-architect.md​

  • 트리거 추가: "이슈 확인", "editorial 이슈 점검", "이슈 #N 트리아지", "manuscript-fix 진행", "이슈 기반 리비전"
  • 모드 2.7 신설: 이슈 트리아지 (R-1)
  • 모드 2.8 신설: 이슈 기반 원고 수정 (R-2A)
  • 소유 자산에 [[issue-triage]] 추가

agents/docs-publisher.md​

  • 트리거 추가: "build-fix 진행", "이슈 #N build-fix", "PATCH 태그 발행", "리비전 배포"
  • 모드 5 신설: 이슈 기반 build-fix (R-2B)
  • 모드 6 신설: PATCH 태그 발행 (R-4)
  • 관련 지식 절 신설 — [[docs-publishing]] + [[issue-triage]]
  • 기존 "빌드 실패 진단" 모드는 5 → 7 로 번호 조정

미변경 (의도적)​

  • 에이전트 6명 그대로
  • 엔진 2개 그대로 (publication-pipeline 안에 Type 4 추가)
  • 신규 엔진 안 만듦 — Type 4 의 R-stage 들은 기존 publication-pipeline 의 변형으로 충분
  • 스킬 / Type 1 흐름 / 검수단 / docs-publishing 트러블슈팅 / manuscript-conventions / writing-style-guide / technical-terminology / doc-clarity-principles 모두 그대로

→ 1.4.0 은 새 진입 유형 1종(Type 4) + 새 지식 1권(issue-triage) + 두 에이전트의 모드 추가 의 minor.

다음 후보​

  • 첫 이슈 등록 → Type 4 1회 실제 운영해 흐름 검증
  • 트리아지 결과 라벨이 누적되면 정원지기가 패턴 분석 (manuscript 약점 vs build 약점 비율)
  • Type 2 (직접 작성형) 발생 대기
  • 루트 페이지 404 해소 (현재 build-fix 후보 1순위)