llm-wiki/.claude/commands/tag.md

description, argument-hint

description	argument-hint
기존 wiki 문서의 메타데이터/태그 보정 (retro cleanup 전용)	<wiki 경로 또는 범위>

기존 wiki 문서의 메타데이터를 보정합니다. 신규 변환은 /ingest를 사용하세요.

대상: $ARGUMENTS (지정 안 하면 wiki/ 전체)

작업 절차

1. 대상 문서 수집

   • 인자가 경로면 해당 문서들
   • 인자가 없으면 wiki/ 전체 스캔

2. frontmatter 검사 및 보정

   • title 누락 → 본문 H1에서 추출
   • source_type 누락 또는 잘못된 값 → 본문/Sources 기반으로 재분류
   • status 누락 → draft로 기본 설정
   • confidence 누락 → unknown
   • tags 빈 배열 → 본문 키워드와 도메인(backend, db, infra 등)에서 추출
   • related_projects 빈 배열 → 본문/링크에서 프로젝트명 추출
   • last_reviewed 누락 → 오늘 날짜로

3. 태그 정규화

   • 동의어 통일 (예: db / database → db)
   • 너무 일반적인 태그(기타, 미분류 등) 제거
   • 도메인 태그 우선 (backend, db, infra, network, auth, ...)

4. 링크 일관성 검사

   • 상대경로 링크가 있으면 [[wikilink]]로 변환
   • 깨진 wikilink 보고

5. 로그 기록

   • wiki/log.md에 한 줄: YYYY-MM-DD HH:mm /tag — <대상> → 변경 요약

규칙

• 본문 내용은 건드리지 않는다. frontmatter와 링크 형식만 조정.
• 자동 분류가 애매하면 status: needs-confirmation으로 두고 사람 검토 요청.
• 대량 처리 시에는 dry-run 결과를 먼저 보여주고 사용자 확인 후 적용.