SoDam-WikiMate: Instructions file for Codex

Wikimate 작업 규칙 (크로스툴 — Claude Code · Codex · Gemini 공용)

문체

• 한국어, "~예요" 체. 비유 먼저(비개발자 사용자).

자동 동작 (자연어 트리거 — 강제 호출 불필요)

사용자가 "정리해줘", "이거 노트로", "inbox 정리", "이 링크 저장" 등 자료 정리 의도를 자연어로 표현하면, 도구를 따로 지정하지 않아도 아래 워크플로우를 수행한다:

1. 접근 자동 감지 → 2. 수집 대상 파악(인젝션 방어) → 3. wikimate_collect를 dry_run=true로 보고 →
2. 사람 승인 → 5. 실제 생성 → 6. 결과 보고.

Claude Code는 스킬 wikimate-organize가 자동 발동한다. Codex·Gemini는 이 규칙으로 동일하게 동작한다. wikimate_collect의 text에는 항상 원문 전체를 그대로 전달한다(요약 금지). summary는 한 줄 요약용 별도 필드이며 text의 대체가 아니다 — 원문을 요약해 text에 넣으면 원본(링크/파일)이 사라졌을 때 정보가 영구 손실된다. 웹 자료 추출 시 HTTP 200만으로 성공을 단정하지 말 것(차단·부분 렌더링 페이지도 200을 반환할 수 있다) — 실제 본문 내용이 맞는지 확인한 뒤에만 원문으로 취급한다. wikimate_collect가 dry-run에 저신뢰(text 너무 짧음)·대용량 알림을 표시하니 확인할 것. 찾기/물어보기("내 볼트/위키에서 ~ 찾아줘·요약해줘")는 읽기 전용 흐름: 색인(노션)·원본(옵시디언)에서 찾되 답하기 전에 원본 존재를 확인하고, 끊긴 색인(원본 삭제)은 근거에서 제외 + 정직 보고(거짓 인용 금지). 여러 노트를 엮는 질문은 관련 노트를 다 모아 후보를 먼저 보여주고, 각 원본 확인 후 노트별 출처와 함께 종합(노트 내용 vs 일반지식 구분). Claude Code는 wikimate-query 스킬. 건강검진/점검("내 볼트 점검·건강검진해줘", "고아·깨진 링크·중복 노트 찾아줘")은 읽기 전용 흐름: wikimate_lint로 중복(source_hash)·깨진 [[링크]]·고아 노트·frontmatter 누락을 스캔하고, 노션 도구가 있으면 끊긴 색인을 대조해 보고한다. 수정은 사람이 고른 항목만 wikimate_fix로 한다(중복은 99_Archive로 이동=하드 삭제 안 함, 링크 치환은 백업 후, 항상 dry_run→승인→실행). Claude Code는 wikimate-lint 스킬. 연결·목차("이 노트들 연결해줘", "관련 노트 찾아줘", "목차/MOC 만들어줘")는 wikimate_link: action=suggest로 후보(제목·요약·태그)를 읽기전용 조회 → 관련도 판단(유사도 엔진 없음, 호출자가 판단) → action=add_links로 dry_run=true 계획 보고 → 사람 승인 → dry_run=false 실행. 노트당 관련 링크는 최대 5개(과잉 연결 방지, 코드로 강제)이며 존재 검증된 노트로만 연결한다(깨진 링크 생성 금지). 왜 연결했는지(reason)를 판단했다면 add_links의 reason에 함께 넘긴다 — frontmatter가 아니라 노트 본문 "## 왜 연결했는지" 섹션에 병행 기록된다(related: 파서가 한 줄 배열만 읽어 frontmatter 구조를 못 바꾸므로 본문에 병행, 2026-08-31 확정). 관계 종류를 확신할 수 있으면 kind(related/reference 중 하나)도 같이 넘긴다 — 같은 섹션·같은 불릿 줄에 괄호로 병기됨(2026-09-01 확정, 애매하면 생략 가능·필수 아님). 주제별 목차가 필요하면 action=build_moc(상한 없음, 기존 MOC의 "## 관련 노트" 섹션만 갱신하고 사용자가 직접 쓴 다른 섹션은 보존). 노션 색인 행을 실제로 만들었다면 그 결과(page ID/URL)를 action=set_notion_id로 노트에 되써서 옵시디언↔노션 양방향 연결을 완성한다(행을 안 만들었으면 이 단계도 생략). Claude Code는 wikimate-link 스킬. 분류·상태·프로젝트("이 노트 어디에 둬야 해", "분류해줘", "태그 붙여줘", "이 노트 완료로 표시해줘", "초안 상태로 바꿔줘", "이 프로젝트 소속으로 지정해줘")는 wikimate_classify: action=suggest로 현재 폴더·본문 일부·볼트 내 기존 태그 어휘·현재 status/project를 읽기전용 조회 → action=apply로 dry_run=true 계획 보고 → 사람 승인 → dry_run=false 실행. 대상 폴더는 00_Inbox/10_Projects/20_Resources/30_Notes/40_Drafts뿐(90_Templates·99_Archive는 이 도구 대상 아님). 폴더 이동은 충돌 시 덮어쓰지 않고 접미를 붙인다. status(inbox/draft/done)는 사용자가 명시적으로 요청했을 때만 바꾼다(자동 전환 기준 없음, 애매하면 유지). Claude Code는 wikimate-classify 스킬. 요약·원자 노트("한 줄로 요약해줘", "핵심만 뽑아서 원자 노트로")는 wikimate_summarize: action=suggest로 본문(body)·현재 summary를 읽기전용 조회 → 200자 이내 한 줄 요약 작성(호출자가 작성, 원문에 없는 내용 지어내기 금지) → action=apply로 dry_run=true 계획 보고 → 사람 승인 → dry_run=false 실행. 대상 노트의 본문(body)은 이 도구가 절대 삭제·축약하지 않는다 — summary·원자노트(선택, 30_Notes에 별도 생성)는 추가일 뿐 원문 대체가 아니다. Claude Code는 wikimate-summarize 스킬.