본문으로 건너뛰기

v1.2.0 — 원고 관리 + 출판 파이프라인 영입

변화 요약

manuscript/ 단일 출처 + Docusaurus 출판 패턴을 book-happtalk 에서 영입. 이에 맞춰 정원에 두 명의 전문가를 더 심었다 — 편집장과 출판 전문가.

추가된 에이전트 (Layer 2)

  • manuscript-architect — 원고 편집장. frontmatter/자리표시자/파일명/status 워크플로우를 소유. 골격 생성·lint·승급 판정 담당.
  • docs-publisher — 정적 사이트 출판 전문가. Docusaurus 빌드 + GitHub Pages 배포 담당. 빌드 실패 진단·트러블슈팅 책임.

추가된 지식 (Layer 1)

  • manuscript-conventions.md — 원고 규약 (frontmatter / 자리표시자 / 파일명 / status)
  • docs-publishing.md — Docusaurus + GH Pages 운영 가이드, 트러블슈팅

추가된 워크플로우 (Layer 3)

  • publication-pipeline.md — 골격 생성 → 본문 작성 → 검수 → 승급 → 빌드 → 배포 5단계 풀 파이프라인. Stage 3 에서 [[full-review]] 엔진을 호출해 기존 3인 검수단을 그대로 활용.

프로젝트 루트 변경 (하네스 외부)

  • manuscript/ 디렉터리 신설 — 단일 출처
    • README.md 사용자용 안내
    • _template.md 새 글 골격
    • articles/ 실제 원고
  • docs-docusaurus/ 디렉터리 신설 — Docusaurus 빌드 도구
    • 의존성 0인 copy 스크립트가 manuscript → docs/ 변환
    • frontmatter status 로 빌드 대상 필터링
  • .github/workflows/deploy-docusaurus.yml 신설 — main push → GH Pages 배포

트리거 추가

트리거활성화 대상
원고 골격 만들어 / 새 글 골격manuscript-architect (Stage 1)
원고 lint / 자리표시자 검수해manuscript-architect (Stage 4)
status 승급해manuscript-architect (Stage 4)
docs 배포해 / 사이트 빌드해docs-publisher (Stage 5 로컬)
출판 파이프라인 실행publication-pipeline (Stage 1~4)

채택 결정 기록

  • 단일 도구 (Docusaurus) — book-happtalk 의 multi-tool hub 패턴은 생략
  • 버전 디렉터리 없음 — docs-docusaurus/ 평탄 구조
  • docs preset (blog X) — frontmatter/order 흐름과 일치
  • routeBasePath: '/' — 사이트 root 가 곧 문서

전환 신호와 함께 [[docs-publishing]] 에 기록되어 있다.

다음 후보

  • 첫 게시 글 (010-harness-intro.md 등) 작성
  • 외부 링크 유효성 검증 에이전트
  • 카테고리 도입 (현재 articles/ 평탄 구조)
  • 검색 만족도가 낮으면 Algolia DocSearch 검토