feat: 공식 문서 근거자료, 브랜치 기능 문서 작성

This commit is contained in:
DongHyeonka
2026-07-29 18:05:17 +09:00
parent cfd84875bf
commit 58515ab0f3
251 changed files with 31470 additions and 109 deletions
+41
View File
@@ -0,0 +1,41 @@
---
description: 기존 wiki 문서의 메타데이터/태그 보정 (retro cleanup 전용)
argument-hint: <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 결과를 먼저 보여주고 사용자 확인 후 적용.