위키독스 분석 보드 — 2026-06-19

Power BI 도구 사용법을 데이터 분석 프로세스(준비→정제→모델링→시각화) 흐름으로 가르치는 실무 입문서 — 도구 자체보단 '분석 사고 프레임워크'가 더 본질이다.

Power BI GUI 도구 튜토리얼이라서 형님 시스템과 직접 호환되는 기술 자산은 거의 없다. 진짜 가치는 도구 사용법이 아니라 책이 가르치는 '데이터 분석 사고 프레임워크' 쪽에 있다. adopt 후보 3개(목표-우선 분석 철학·Data Profiling 체계·원본 보존 원칙), improve 3개(정제 4단계 명세·사용자 관점 보고·식별자 형식 컨벤션), skip 2개(예제의 열·사용자 지정 함수). 핵심 가치는 '데이터 품질을 정량적으로 점검하는 체계'가 형님 시스템에 없다는 걸 정확히 지적해준 점 — 이 책 한 권보다 이 깨달음이 더 값지다.

1. ADOPT 데이터 분석 '목표-우선' 철학 (Why > How)
   ~/.hermes/skills/data-analysis/meta/ANALYSIS_GOAL_FIRST.md 신규 생성. '데이터를 보기 전에 질문 4개(해결문제·페인포인트·부족정보·이해안되는부분)를 먼저 쓰라'는 체크리스트를 Pre-Write Protocol 스타일로 문서화. data-report skill 호출 시 hook으로 연결 검토.
2. ADOPT 데이터 품질 점검(Data Profiling) 체계
   ~/.hermes/skills/data-analysis/scripts/data_profiler.py 신규 생성. CSV/DataFrame 입력 → {column: {valid_pct, error_pct, null_pct, distinct, unique, min, max, mean, std}} 딕셔너리 출력. wikidocs_crawler.py·running_daily FIT 파서·realestate 데이터 수집기 후처리에 적용.
3. IMPROVE 데이터 정제 4단계 분류 (Cleaning·Transforming·Conforming·Arranging)
   기존 HARNESS_DOMAIN_REGISTRY.md에 'Data Preparation Contract' 섹션 추가. 모든 데이터 수집 모듈(wikidocs_crawler·FIT parser·realestate collector)이 출력 시 데이터 정제 4단계 중 어디까지 수행했는지 메타데이터로 명시하게 한다.
4. IMPROVE 사용자 관점 보고서 설계 (의사결정자별 차별화)
   data-report skill 출력 단계에 `audience` 파라미터 추가 (기본값 'self'). 'self' 모드는 현재 상세·원시데이터 포함, 'executive' 모드는 KPI 3줄 요약, 'analyst' 모드는 통계 상세. SKILL.md에 페르소나별 시각화 선택 가이드 문서화.
5. ADOPT 데이터 집계 신중 원칙 (원본 보존)
   Pre-Write Protocol 체크리스트에 '원본 데이터 보존 확인' 항목 추가. 데이터 파이프라인에서 집계 수행 시 원본 row-level 데이터를 별도 아카이브하는 규칙을 `pipeline_observer.py`에 조건으로 추가.

AI 코딩 에이전트가 UI 일관성을 유지하도록 프로젝트 루트의 DESIGN.md 단일 파일로 브랜드 스펙(토큰+철학)을 주입하고, 10단계 파이프라인·자동 리뷰·교정 학습 루프로 완성하는 워크플로우 체계

UI 디자인 시스템 책이지만, 자동 교정 캡처(omd:remember)·결정론적 환경 스캔(CTX-PRIME)·루브릭 기반 리뷰·체크포인트 게이트·에이전트 설정 shim 동기화라는 5개 추상 패턴이 형님 시스템의 자동화 인프라 gap을 정확히 건드린다 — adopt 2개(llms.txt·교정 자동 캡처), improve 3개(CTX-PRIME·루브릭 리뷰·shim 동기화), skip 3개(DESIGN.md·카탈로그·체크포인트는 improve로 분류), 핵심 가치는 '에이전트 일관성 유지를 위한 자동화된 피드백 루프' 설계 노하우

1. ADOPT omd:remember — 교정 발화 자동 캡처 → 스펙 누적 루프
   UserPromptSubmit hook에 교정 패턴 감지 정규식을 추가 — '~절대 안 써', '~금지', '앞으로는 ~', '~하지 마', '~대신 ~로 해' 등 패턴을 탐지해 .hermes/corrections/capture.md에 타임스탬프+원문 자동 append. omd:learn의 'pending→스펙 승격' 검토 사이클은 HANDOFF.md monthly_summary 워크플로우와 통합
2. IMPROVE CTX-PRIME — 작업 전 50ms 결정론적 환경 스캔
   SessionStart hook에 pre_scan context injector 추가 — 작업 디렉토리의 CLAUDE.md·HARNESS_DOMAIN_REGISTRY.md·config.yaml·주요 Python 파일 import graph를 빠르게 스캔(50ms 목표)해 요약 컨텍스트를 세션 초기 시스템 메시지에 주입. agent_registry.py에서 현재 도메인 관련 agent 목록을 함께 로드
3. IMPROVE 3단계 심각도 리뷰 루브릭 (BLOCK/WARN/FYI) + 2라운드 하드캡
   debug-critic SKILL.md에 (1) 심각도 체계: BLOCK(병합불가)/WARN(수정권장)/FYI(참고), (2) 모든 지적에 파일:라인 참조 강제, (3) '좋아 보여요' 금지 — 모든 PASS에 근거 명시, (4) 수정 2라운드 하드캡(2라운드 내 BLOCK 미해결 시 설계 재검토) 규칙 추가. PostToolUse hook에서 critic 출력 파싱 후 BLOCK 존재 시 자동 abort
4. ADOPT llms.txt — LLM이 내 서비스를 정확히 인용하게 하는 문서화 컨벤션
   blog-naver 파이프라인에 llms.txt 생성 단계 추가 — 각 블로그 글 발행 시 핵심 정의문·FAQ·경쟁 콘텐츠 비교를 자동 추출해 sia-ian.dev/llms.ko.txt에 누적. 독립 도메인 루트에 llms.txt 배포 자동화. blog-writer-naver SKILL에 'LLM-friendly 요약 블록' 템플릿 추가 — 각 글의 첫 문단을 LLM 인용 최적화된 정의문으로 작성하는 규칙
5. IMPROVE 체크포인트 게이트 — 파이프라인 중간 사용자 승인 지점
   blog-naver·thesis-analysis·realestate-analyzer 3개 주요 파이프라인에 stage 전환점 2~3개 체크포인트 추가. 각 체크포인트에서 '승인/수정/건너뛰기' 선택지를 CLI 프롬프트로 제공. 체크포인트 통과 여부를 session_checkpoint.py에 기록하고, 미승인 시 다음 stage 진행을 pipeline_observer.py에서 차단하도록 연결

Claude Code의 확장 메커니즘(CLAUDE.md·Skills·Subagents·Hooks·MCP·Plugins)을 '하네스 엔지니어링' 관점으로 체계화한 한국어 운영 매뉴얼 — 공식 문서를 실전 프로젝트(my-blog)에 결합해 보여주는 것이 차별점

adopt 후보 2개(커스텀 MCP 서버·PreCompact hook), improve 3개(hook timeout·CLAUDE.md paths·Skill 동적 주입), skip 3개(Subagent memory·prompt hook·아키텍처 이전) — 핵심 가치는 '형님이 이미 하는 것을 체계적으로 설명하는 한국어 교재'로서의 블로그 콘텐츠 소스와, 아직 안 써본 Claude Code 네이티브 기능 2~3개(FastMCP·PreCompact hook·hook timeout 규율)의 발견

1. ADOPT 커스텀 MCP 서버 제작 (FastMCP)
   FastMCP로 형님 시스템 전용 MCP 서버 1개 파일 작성: ~/.claude/mcp-servers/harness-tools/server.py — agent_registry.py 래핑 도구(search_agent_by_keyword)·옵시디언 vault 쿼리 도구(find_notes_by_tag)·HANDOFF.md 상태 조회 도구. fastmcp install로 Claude Code에 프로젝트 스코프 등록. docstring에 한국어 설명 포함해 Claude Code가 자동 호출할 수 있게
2. IMPROVE Hook timeout·statusMessage 설계 규율
   기존 PostToolUse hook(obsidian_keywords 자동 발동)에 timeout 15초 + statusMessage '옵시디언 키워드 백링크 생성 중…' 추가. 다른 hook도 작업 성격에 따라 timeout 차등 부여하고 statusMessage 기입. 형님 시스템의 .claude/settings.json에 timeout·statusMessage 필드 점검 및 보강
3. ADOPT PreCompact hook으로 컨텍스트 압축 전 상태 덤프
   ~/.claude/settings.json의 PreCompact 이벤트에 precompact-dump.mjs hook 추가 — 현재 작업 디렉토리·마지막 5개 도구 사용 내역·열린 파일 목록을 HANDOFF.md에 '자동 덤프' 섹션으로 append. 10초 timeout. HANDOFF.md 50블록 제한에 걸리지 않도록 별도 섹션으로 분리
4. IMPROVE CLAUDE.md @path 가져오기와 .claude/rules/ 디렉토리 분할
   HARNESS_DOMAIN_REGISTRY.md의 도메인-모듈 매핑을 .claude/rules/ 디렉토리로 변환하는 스크립트 작성 — 예: 부동산 도메인 규칙은 paths: ['realestate_analyzer/**', 'realestate-data-collector/**']로 자동 로드. SPoE 원칙을 Claude Code 네이티브 paths 매커니즘과 정렬
5. IMPROVE Skill 동적 컨텍스트 주입(!``)과 인자 전달($ARGUMENTS)
   형님의 주요 Skill(blog-writer-naver·realestate-analyzer·running-daily 등)에서 동적 컨텍스트 주입이 유용한 지점 식별. 예: running-daily Skill에 '!ls ~/running/*.fit | tail -1'로 최신 FIT 파일 자동 감지. $ARGUMENTS 패턴으로 Skill 호출 시 인자 전달 인터페이스 통일. 미사용 중인 Skill 3~5개에 우선 적용 후 확장