DAP 위키 구현 로드맵 (Phase 2-3)

Phase 2-3 Deliverable

마스터 플랜(Phase 1-1~1-5) + 자동화 규칙(Phase 2-2)을 실행하는 4주 스프린트 계획

목표: 2026-05-31까지 마스터 플랜 완성 (마지막 4주)

📅 전체 일정 (Gantt Overview)

2026-04-27 ─────────────────────────────── 2026-05-31 (34일)

Phase 1 완료  │────── Phase 2 구현 (4주) ──────│ Phase 3 검증 (1주)
  ↓          ↓                                    ↓
기초 설계    Sprint 1  Sprint 2  Sprint 3  Sprint 4  Validation
(이전)      (1주)    (1주)    (1주)    (1주)    (5일)

✅ 데이터 흐름
✅ 관리 프로세스      
✅ 품질 기준        ⏳ Hook 1-3 + Scripts   ⏳ Skill 확장  ⏳ 통합 테스트
✅ 현장 검증        구현                    + 성능 최적화   + Lint 통합
✅ 자동화 규칙

Sprint 1: Layer 1 Hooks 구현 (2026-04-28 ~ 2026-05-04)

목표: 즉시 반응 자동화 (3개 Hook)

Sprint 1-1: Hook 1 - Frontmatter 검증 (2-3일)

작업:

1. 스펙 작성 (2시간)
   - 검증 규칙 명시 (wiki-quality-standards 기준)
   - 에러 vs 경고 분류
   - 자동 수정 정책 (예: updated 필드, source_count)
   - 예상 false positive 식별

2. 스크립트 구현 (4시간)
   - Bash 또는 Python으로 작성
   - 모든 필드 검증 + 날짜 논리
   - source_count 자동 수정
   - Frontmatter YAML 파싱

3. 테스트 (3시간)
   - 정상 case 5개 (모두 통과)
   - 에러 case 5개 (모두 감지)
   - 자동 수정 case 3개 (정확성 검증)
   - Edge case (부분 frontmatter, 잘못된 YAML)

4. 배포 (1시간)
   - `.claude/hooks/post-edit-frontmatter.sh` 저장
   - CLAUDE.md에 Hook 문서화
   - log.md 기록

산출물:

.claude/hooks/post-edit-frontmatter.sh
Hook 테스트 보고서
문제 사항 기록 (향후 개선)

성공 기준:

✅ Frontmatter 검증 시간 < 2초
✅ False positive < 5%
✅ 자동 수정 정확도 100%

Sprint 1-2: Hook 2 - Wikilink 검증 (2-3일)

작업:

1. 스펙 작성 (2시간)
   - Broken link 감지 규칙
   - Project ↔ Zettel 방향 검증 규칙
   - 파일명 규칙 (underscores, kebab-case)
   - 예상 edge case (섹션 헤더 링크, 상대 경로)

2. 스크립트 구현 (5시간)
   - Wikilink 파싱 (정규식)
   - 파일 존재 여부 확인 (glob)
   - 링크 방향 검증 (파일 경로 분석)
   - 섹션 헤더 검증 (optional)

3. 테스트 (3시간)
   - 정상 링크 10개 (모두 통과)
   - Broken 링크 10개 (모두 감지)
   - 방향 위반 5개 (모두 감지)
   - Edge case (섹션, 상대 경로)

4. 배포 (1시간)
   - Hook 스크립트 저장
   - CLAUDE.md 업데이트
   - log.md 기록

산출물:

.claude/hooks/post-edit-wikilinks.sh
Wikilink 테스트 보고서

성공 기준:

✅ Broken link 감지 시간 < 3초
✅ False positive < 3%
✅ 모든 Project→Zettel 위반 감지

Sprint 1-3: Hook 3 - Log 자동 생성 (1-2일)

작업:

1. 스펙 작성 (1시간)
   - 파일 생성 시 log.md 자동 항목 생성 규칙
   - 페이지 타입 자동 감지 (경로 분석)
   - 기본 템플릿 정의

2. 스크립트 구현 (3시간)
   - Write 도구 후 파일 경로 확인
   - 파일 타입 식별 (sources/concepts/projects/insights/entities)
   - log.md 항목 자동 생성 + append

3. 테스트 (2시간)
   - 각 파일 타입별 테스트 (5가지)
   - 기존 log.md 손상 테스트
   - 중복 생성 방지 테스트

4. 배포 (30분)
   - Hook 저장 + CLAUDE.md 업데이트

산출물:

.claude/hooks/post-create-log.sh
Log 자동 생성 테스트 보고서

성공 기준:

✅ Log 항목 생성 시간 < 1초
✅ 페이지 타입 감지 정확도 100%
✅ 기존 로그 손상 0건

Sprint 1 완료 체크리스트

☐ 3개 Hook 모두 구현 완료
☐ 각 Hook별 테스트 통과
☐ CLAUDE.md에 Hook 문서화
☐ log.md에 Phase 구현 기록
☐ 성공 기준 모두 달성

Sprint 1 산출물:

3개 Hook 스크립트 (.claude/hooks/)
3개 테스트 보고서
CLAUDE.md 업데이트

Sprint 2: Layer 2 Scripts 구현 (2026-05-05 ~ 2026-05-11)

목표: 배치 자동화 (3개 Script)

Sprint 2-1: Script 1 - Wiki Lint 자동화 (3-4일)

작업:

1. 스펙 작성 (3시간)
   - Major 이슈 자동 수정 목록
   - Medium/Info 이슈 보고 형식
   - Lint 리포트 템플릿

2. 스크립트 구현 (6시간)
   - wiki/ 폴더 전체 스캔
   - Frontmatter 검증 (이미 Hook 있음, 통합)
   - Link 검증 (Broken, Project↔Zettel, 섹션)
   - Metadata 검증 (6개월 초과 데이터)
   - 보고서 생성

3. 테스트 (3시간)
   - 대량 파일 스캔 성능 테스트 (1000+ pages)
   - 각 이슈 타입별 감지 테스트
   - Lint 리포트 형식 검증

4. 배포 (1시간)
   - `.claude/scripts/wiki-lint.py` 저장
   - Cron 스케줄 설정 (금요일 17:00)
   - 첫 실행 + 리포트 검토

산출물:

.claude/scripts/wiki-lint.py
첫 Lint 리포트
성능 벤치마크

성공 기준:

✅ Lint 실행 시간 < 30초 (100+ pages)
✅ Major 이슈 감지율 100%
✅ False positive < 2%

Sprint 2-2: Script 2 - Index 자동 갱신 (2-3일)

작업:

1. 스펙 작성 (2시간)
   - wiki/index.md 테이블 구조
   - 행 추출 규칙 (frontmatter 기반)
   - 정렬 순서 (updated DESC, 타입별)
   - 카운트 계산 로직

2. 스크립트 구현 (4시간)
   - wiki/ 폴더 파일 목록 추출
   - Frontmatter 파싱 (모든 필드)
   - 테이블 행 생성 (마크다운)
   - index.md 특정 섹션 업데이트

3. 테스트 (2시간)
   - 새 파일 추가 후 index 업데이트 확인
   - 기존 파일 수정 후 updated 날짜 갱신 확인
   - 테이블 형식 손상 테스트

4. 배포 (1시간)
   - Script 저장
   - 월말 Cron 설정
   - 첫 실행 + 결과 검증

산출물:

.claude/scripts/update-index.py
첫 Index 업데이트 결과
카운트 검증 (실제 vs 계산)

성공 기준:

✅ Index 생성 시간 < 10초
✅ 행 추출 정확도 100%
✅ 테이블 형식 100% 정확

Sprint 2-3: Script 3 - Frontmatter 배치 갱신 (2일)

작업:

1. 스펙 작성 (1시간)
   - 배치 갱신 규칙 (dry-run 권장)
   - Rollback 전략
   - Backup 관리

2. 스크립트 구현 (3시간)
   - 모든 frontmatter 스캔
   - 누락된 필드 감지 + 추가
   - 폐지된 필드 제거
   - Dry-run 모드 + 실행 모드

3. 테스트 (2시간)
   - Dry-run으로 변경사항 미리보기
   - 실행 후 결과 검증
   - Rollback 테스트

4. 배포 (1시간)
   - Script 저장
   - 문서화 (dry-run 먼저 권장)

산출물:

.claude/scripts/batch-update-frontmatter.py
Dry-run 리포트
Frontmatter 업데이트 로그

성공 기준:

✅ Dry-run 정확도 100%
✅ 실행 후 모든 파일 valid
✅ Rollback 성공

Sprint 2 완료 체크리스트

☐ 3개 Script 모두 구현 + 테스트
☐ Cron 스케줄 설정 (Lint, Index)
☐ 첫 실행 결과 검증
☐ CLAUDE.md + log.md 업데이트
☐ 성능 기준 달성

Sprint 3: Layer 3 Skills 확장 (2026-05-12 ~ 2026-05-18)

목표: LLM 기반 자동화 확장

Sprint 3-1: /ingest 확장 (3-4일)

작업:

1. Mode B 강화 (2일)
   - Frontmatter 자동 생성 (source_type, tags 기반)
   - sources/ 페이지 자동 생성 규칙 (Key Insight, 요약)
   - raw/ + sources/ 연쇄 생성
   - 오류 처리 (invalid URL 등)

2. Mode C 시작 (기술 검증, 1일)
   - WebSearch 통합 가능성 확인
   - 후보 3-5개 제시 UI 설계
   - 사용자 선택 후 Mode B 처리

3. 테스트 (1일)
   - Mode B 10개 URL 자동 처리
   - 정확도 검증 (title, author 자동 추출)
   - Mode C 후보 제시 품질 검증

산출물:

/ingest 스킬 강화 버전
Frontmatter 자동 생성 템플릿
Mode C 프로토타입 + 기술 보고서

Sprint 3-2: /lint 스킬 강화 (2-3일)

작업:

1. Major 이슈 자동 수정 (2일)
   - Frontmatter 자동 수정
   - source_count 자동 수정
   - Lint 스킬에 "자동 수정" 옵션 추가

2. Manual Review 가이드 (1일)
   - Orphan 페이지 keep/link/delete 조언
   - Contradiction 해결 제안
   - Low-relevance sources 검토 가이드

산출물:

/lint 스킬 자동 수정 모드
Manual Review 가이드

Sprint 3-3: /query→/insight 통합 (2-3일)

작업:

1. Query 결과 → Insight 저장 (1일)
   - 사용자 질문 수집
   - 답변 생성 후 저장 옵션 제시
   - insights/ 페이지 자동 생성

2. Contradiction 감지 (1-2일)
   - Query 답변이 기존 claim과 충돌 감지
   - Concept에 ⚠️ Contradiction 섹션 추가 제안

산출물:

/query→/insight 파이프라인
Contradiction 감지 로직

Sprint 3 완료 체크리스트

☐ /ingest Mode B 자동화 완료 (테스트 통과)
☐ /ingest Mode C 프로토타입 (기술 검증)
☐ /lint 자동 수정 모드 (테스트 통과)
☐ /query→/insight 통합 (기본)
☐ 성능 + 정확도 검증

Sprint 4: 통합 & 최적화 (2026-05-19 ~ 2026-05-25)

목표: 모든 Layer 통합 + 성능 최적화

Sprint 4-1: 전체 통합 테스트 (3일)

작업:

1. 통합 시나리오 테스트 (2일)
   - Scenario 1: 새 source 수집 → 자동 링킹 → Lint 검증
   - Scenario 2: Concept 수정 → Frontmatter 검증 → Index 갱신
   - Scenario 3: 모순 감지 → ⚠️ 섹션 추가 → Lint 플래그

2. 성능 최적화 (1일)
   - Hook 성능 튜닝 (< 2초 목표)
   - Script 병렬 실행 가능성 검토
   - 메모리 사용량 프로파일링

산출물:

통합 테스트 보고서
성능 벤치마크

Sprint 4-2: 문서화 & 학습 자료 (2일)

작업:

1. 자동화 가이드 작성 (1일)
   - 각 Hook/Script/Skill 사용법
   - Troubleshooting 가이드
   - FAQ

2. 학습 자료 (1일)
   - 신입 자동화 온보딩 (1시간 영상 또는 문서)
   - 자동화 아키텍처 다이어그램
   - 트러블슈팅 체크리스트

산출물:

자동화 운영 가이드
신입 온보딩 자료

Sprint 4 완료 체크리스트

☐ 전체 통합 시나리오 테스트 통과
☐ 성능 기준 달성 (Hook < 2초, Script < 30초)
☐ 문서화 + 학습 자료 완성
☐ log.md 최종 기록

Phase 3: 검증 & 완성 (2026-05-26 ~ 2026-05-31)

목표: 마스터 플랜 최종 검증 + 완성

Phase 3-1: Lint + Skills 호환성 검증 (2-3일)

작업:

1. /lint 스킬과 자동화 규칙 비교 (1일)
   - Lint 보고서 vs 자동화 규칙 일관성 확인
   - 놓친 검증 규칙 식별

2. Skill 성능 검증 (1일)
   - /ingest, /query, /lint 성능 + 정확도
   - 대량 처리 테스트 (50+ pages)

3. Edge case 처리 (1일)
   - 예상 외 상황 재현 + 수정

산출물:

호환성 검증 리포트
성능 벤치마크

Phase 3-2: 최종 문서화 (2-3일)

작업:

1. CLAUDE.md 최종 정렬 (1일)
   - 모든 규칙 + 자동화 반영
   - 명령어 목록 + 링크 업데이트

2. 마스터 플랜 최종 검수 (1일)
   - Phase 1-1 ~ 2-3 모든 문서 일관성 확인
   - 누락된 섹션 + 모순 검토

3. 마스터 플랜 완성 선언 (1일)
   - Progress 섹션 최종 입력
   - Retrospective 작성
   - Closed 상태 설정

산출물:

최종 CLAUDE.md
마스터 플랜 Retrospective

체크리스트 (전체)

Phase 2-3 준비 완료

☐ Sprint 계획 명확함
☐ 각 Sprint 목표와 성공 기준 정의됨
☐ 예상 시간 추정됨
☐ 팀 역할 분담 명확함 (현재: 나 1명 = 의사결정 필요)

Sprint 1-4 실행

☐ Sprint 1: Hooks (4주차 1주일)
☐ Sprint 2: Scripts (5주차 1주일)
☐ Sprint 3: Skills (6주차 1주일)
☐ Sprint 4: 통합 (7주차 1주일)

Phase 3 완성

☐ Phase 3-1: 검증
☐ Phase 3-2: 문서화
☐ 마스터 플랜 Closed (deadline 2026-05-31)

리스크 & 완화 전략

리스크	영향	완화 전략
Script 성능 저하	Lint 실행 시간 > 1분	Sprint 2에서 병렬화 검토
Hook 예상 외 에러	자동화 실패 시 사용자 영향	모든 Hook에 dry-run + 로깅
Skill 통합 복잡도	Sprint 3 지연	Mode C는 선택사항으로 후순위화
버그 발견	수정에 시간 소요	각 Sprint 테스트 비율 30%

성공 기준

기능 완성도

✅ Hooks 3개: 100% 구현
✅ Scripts 3개: 100% 구현
✅ Skills: ingest/lint 강화, query→insight 기본 구현
✅ Cron 스케줄: 금요일 Lint, 월말 Index 설정

품질 지표

✅ Hook 성능: < 2초 (동기)
✅ Script 성능: < 30초 (Lint 100+ pages)
✅ 감지율: Major 이슈 100%, False positive < 2%
✅ Lint Pass Rate: Major 이슈 0개

문서화

✅ CLAUDE.md 최종화
✅ 마스터 플랜 완성 선언
✅ Retrospective 작성

다음 단계

2026-06-01 이후:

정기 운영 시작 (주간/월간 프로세스)
팀 온보딩 (신입 1.5시간 가이드)
Phase 3 후속 (추가 기능, 성능 최적화)

JYP Garden

탐색기

DAP 위키 구현 로드맵 (Phase 2-3)

DAP 위키 구현 로드맵 (Phase 2-3)

📅 전체 일정 (Gantt Overview)

Sprint 1: Layer 1 Hooks 구현 (2026-04-28 ~ 2026-05-04)

Sprint 1-1: Hook 1 - Frontmatter 검증 (2-3일)

Sprint 1-2: Hook 2 - Wikilink 검증 (2-3일)

Sprint 1-3: Hook 3 - Log 자동 생성 (1-2일)

Sprint 1 완료 체크리스트

Sprint 2: Layer 2 Scripts 구현 (2026-05-05 ~ 2026-05-11)

Sprint 2-1: Script 1 - Wiki Lint 자동화 (3-4일)

Sprint 2-2: Script 2 - Index 자동 갱신 (2-3일)

Sprint 2-3: Script 3 - Frontmatter 배치 갱신 (2일)

Sprint 2 완료 체크리스트

Sprint 3: Layer 3 Skills 확장 (2026-05-12 ~ 2026-05-18)

Sprint 3-1: /ingest 확장 (3-4일)

Sprint 3-2: /lint 스킬 강화 (2-3일)

Sprint 3-3: /query→/insight 통합 (2-3일)

Sprint 3 완료 체크리스트

Sprint 4: 통합 & 최적화 (2026-05-19 ~ 2026-05-25)

Sprint 4-1: 전체 통합 테스트 (3일)

Sprint 4-2: 문서화 & 학습 자료 (2일)

Sprint 4 완료 체크리스트

Phase 3: 검증 & 완성 (2026-05-26 ~ 2026-05-31)

Phase 3-1: Lint + Skills 호환성 검증 (2-3일)

Phase 3-2: 최종 문서화 (2-3일)

체크리스트 (전체)

Phase 2-3 준비 완료

Sprint 1-4 실행

Phase 3 완성

리스크 & 완화 전략

성공 기준

기능 완성도

품질 지표

문서화

다음 단계

관련 개념

그래프 뷰

목차