JYP Garden

DAP 위키 운영 가이드 (마스터 플랜)

Properties1
tagsconcept, dap, operations, master-guide, synthesis, knowledge

10 min read

DAP 위키 운영 가이드 (마스터 플랜)

Phase 2-1 Deliverable

DAP 위키 마스터 플랜(Phase 1-1~1-5)의 최종 통합 가이드

이 페이지는 위키 운영의 4가지 핵심 축(데이터 흐름·관리 프로세스·품질 기준·현장 검증)을 하나로 엮은 진입점입니다. 새로운 팀원 온보딩, 자동화 구현, 지속 가능한 운영의 기초입니다.

🎯 왜 이 가이드가 필요한가?

문제: DAP 위키가 커질수록 유지보수 비용이 기하급수적으로 증가
근본 원인: 데이터 관리의 틀(structure)이 없으면 
          각자 마음대로 작성 → 중복·모순·orphan pages 누적

해결책: 명확한 규칙 + 자동화 + 정기 검증 → 비용 선형 증가로 전환

결과: 3개월 내 "운영 플레이북" 완성 → 이후 팀 온보딩 & 콘텐츠 수집 가속화

📐 4개의 핵심 축 (마스터 플랜 구조)

1️⃣ 데이터 흐름 설계 (Phase 1-1)

문서: dap-wiki-data-pipeline

핵심:

Raw Sources  →  Wiki Pages  →  Interconnected Knowledge
   (입력)         (처리)           (출력)
   
4단계 파이프라인:
Step 1: Ingest      (수집: raw/ 파일 생성)
Step 2: Transform   (변환: sources/ 페이지)
Step 3: Synthesize  (합성: concepts/ 강화)
Step 4: Link        (연결: 메타 페이지 + log)

4가지 인제스트 모드:

  • Mode A: 사용자가 파일 제공 (raw/에 저장)
  • Mode B: URL 제공 (WebFetch로 자동 변환)
  • Mode C: 자연어 검색 (“데이터 거버넌스 글 찾아줘”)
  • Mode D: NotebookLM 심층 분석 (2개 이상 URL 비교)

2️⃣ 관리 프로세스 정의 (Phase 1-2)

문서: wiki-operations-management-processes

핵심: 5가지 반복 프로세스

프로세스주기소요시간목표
Ingest수시 (주 1-3회)10-18분/소스소스 수집 + raw 파일화
Curate주 1회 (월요일)30분우선순위 리스트 + 다음주 계획
Link즉시 (수집 후 24시간 내)15-18분/소스Concept 강화 + 메타 업데이트
Lint주 1회 (금요일)25분(자동) + 15분(수동)품질 검증 + 이슈 발굴
Update월 1회 (말일) + 분기 1회40분메타 갱신 + 새 규칙 반영

주간 캘린더:

월(Curate) → 화~목(ad-hoc Ingest) → 금(Lint) → 월말(Update)

SLA:

  • Ingest → Transform: 24시간 내
  • Link 완료: 수집 후 24시간 내
  • Lint 완료: 매주 금요일

3️⃣ 품질 기준 수립 (Phase 1-3)

문서: wiki-quality-standards

핵심: 4가지 검증 축

┌─────────────────────────────────┐
│ 1. Frontmatter Schema           │ (필드 + 타입 검증)
│    (sources, concepts, projects,│
│     insights, entities)         │
├─────────────────────────────────┤
│ 2. Metadata Validation          │ (날짜, 배열, 논리성)
├─────────────────────────────────┤
│ 3. Link Validation              │ (그래프 구조)
│    - Orphan pages 감지          │
│    - Project ↔ Zettel 단방향    │
│    - Cross-refs 완성도          │
├─────────────────────────────────┤
│ 4. Content Quality              │ (길이, 구조, 인용)
└─────────────────────────────────┘

Lint 심각도:

  • 🔴 Major: Broken links, source_count 불일치, Project ↔ Zettel 양방향
  • 🟠 Medium: Orphan pages, 6개월 초과 stale data
  • 🟡 Info: 최소 길이 미만, 필수 섹션 누락, 출처 인용 누락

체크리스트 (자동 + 수동):

  • 매 변경 시: Frontmatter + 링크 검증
  • 주간: Orphan + broken links + metadata 검증
  • 월간: valid_as_of 갱신 + 새 규칙 반영

4️⃣ 현장 검증 및 개선 (Phase 1-5)

문서: phase-1-5-practical-validation

검증 결과:

  • ✅ Compliance: Ingest + Link 프로세스 100% 준수 가능
  • ✅ Feasibility: 예상 시간과 실제 시간 ±0% gap (규칙이 현실적)
  • ⚠️ Sufficiency: 규칙은 충분하나 Edge case 3개 추가됨

추가된 Edge Case 규칙:

  1. 중복 source: _v2 버전 관리 + URL 업데이트
  2. 낮은 관련성: status: “low-relevance” 플래그 + 로그 기록
  3. Concept conflict: ⚠️ Contradiction 섹션 + 월간 검증

Entity 추가 정책:

  • ✅ 3회 이상 언급된 도구/서비스
  • ✅ 여러 concepts의 허브 역할
  • ✅ 비즈니스 의사결정 영향

🚀 빠른 시작 (Quick Start)

신입 온보딩 (1일차)

1단계: 구조 이해 (10분)

이 문서 읽기 + 4개 축 개념 파악

2단계: 데이터 흐름 학습 (20분)

3단계: 관리 프로세스 학습 (20분)

4단계: 품질 기준 학습 (20분)

5단계: 첫 인제스트 (30분)

  • Mode B 시작 (URL 제공)
  • raw/articles/, wiki/sources/ 페이지 생성
  • log.md 기록

총 소요 시간: 100분 (1.5시간)

정기 운영 체크리스트

주간 (매 월요일 + 매 금요일)

☐ 월요일 10:00: Curate 실행 (/curate 스킬 또는 수동)
  - 우선순위 리스트 작성 (High/Medium/Low)
  - 다음주 목표 3-5개 설정

☐ 화~목: Ad-hoc Ingest (발견 시 마다)
  - 소스 평가 (관련성, 신뢰성, 품질, 최신성)
  - 모드 선택 (A/B/C/D)
  - raw/ + sources/ 페이지 생성
  - log.md 기록

☐ 금요일 17:00: Lint 실행
  - /lint 스킬 자동 검사
  - 수동 검토 (orphan, broken links, metadata)
  - 이슈 해결

월간 (매 말일)

☐ 월말 09:00: Update 실행
  - wiki/index.md 행 추가
  - Frontmatter `updated` 필드 갱신
  - 새로운 규칙/용어 반영
  - 월간 KPI 확인
    * Ingest 수량: 3-5개?
    * Lint Major 이슈: 0개?
    * Orphan 페이지: 0개?
    * Stale data (6개월 초과): 0개?

📊 구현 로드맵 (향후)

Phase 2 (현재): 문서화 완성

  • Phase 1-1~1-5: 마스터 플랜 기초 설계
  • Phase 2-1: 이 가이드 (통합 요약)
  • Phase 2-2: 자동화 규칙 (Hooks, Scripts)
  • Phase 2-3: 구현 로드맵 (4주 스프린트)

Phase 3: 검증 & 완성

  • Phase 3-1: Skills (ingest, query, lint) 호환성 검증
  • Phase 3-2: 최종 문서화 및 자동화 테스트

🔗 관련 자산

Core Concepts

개념페이지목표
4단계 파이프라인dap-wiki-data-pipelineRaw → Wiki 데이터 흐름
5가지 프로세스wiki-operations-management-processes주간/월간 운영 사이클
품질 기준wiki-quality-standards검증 규칙 + Lint 기준
현장 검증phase-1-5-practical-validation마스터 플랜 현실성 검증

Implementation

문서경로용도
세션 가이드매 세션 로드 (기본 규칙)
프로젝트 허브dap-wiki-ops-master-plan전체 진행 상황 + Progress
작업 로그Append-only 작업 기록
페이지 카탈로그wiki 전체 목록

⚡ 자주 묻는 질문

Q1: 나는 어떤 프로세스를 담당하나?

A:

  • Ingest: 모든 팀원 (분산형)
  • Curate: 팀 리드 또는 자동화 (주 1회)
  • Link: Ingest 담당자 (즉시)
  • Lint: 자동화 + 팀 리드 (주 1회)
  • Update: 팀 리드 (월 1회)

Q2: 처음 뭘 하나?

A:

  1. 이 가이드 읽기 (20분)
  2. dap-wiki-data-pipeline 읽기 (20분)
  3. Mode B로 첫 source 수집 (30분)
  4. wiki-operations-management-processes 정독하며 체크리스트 따라하기

Q3: 모든 규칙을 외워야 하나?

A: 아니요. 필요할 때마다 해당 개념 페이지를 열어보세요:

Q4: 실수했을 때는?

A:

  • Frontmatter 잘못됨: lint가 잡음 → 수정 가능
  • 링크 깨짐: lint가 감지 → 수정 필수
  • 모순 발견: Concept에 ⚠️ Contradiction 섹션 추가 → 월간 검증 시 해결
  • 규칙 불명확: Phase 1-5-practical-validation 참고 또는 edge case 추가

Q5: 새로운 도구/기술을 소개하고 싶은데?

A:

  1. Source로 먼저 수집
  2. Concepts에서 기존 개념들과 연결
  3. 3회 이상 언급되면 Entity 생성 (Entity 추가 정책 참고)

📋 다음 단계

Phase 2-2: 자동화 규칙 정의

  • Hooks (매 파일 수정 시 자동 검증)
  • Scripts (lint, index update 자동화)
  • Skills 확장 (ingest, query, lint 고도화)

Phase 2-3: 구현 로드맵

  • 4주 스프린트 (Sprint 1: 기초, Sprint 2: Ingest, Sprint 3: Lint, Sprint 4: 통합)
  • 주간 체크인 + 월간 검증

메모

  • 버전: v1.0 (2026-04-27, Phase 2-1)
  • 상태: 완성 후 feedback 대기 (Phase 2-2 진행 중)
  • 관리자: DAP Wiki Operations Team
  • 마지막 검토: dap-wiki-ops-master-plan Progress 참고

관련 개념

그래프 뷰