wiki-discover

프로젝트에서 만들어진 문서 중 위키에 등록할 만한 것을 찾아서 등록을 제안하는 스킬이다.

사전 요구

이 스킬은 /wiki 스킬로 구성된 위키 환경이 필요합니다.

#	검증	실패 시
1	CWD가 Git 레포	"Git 레포에서만 동작합니다" 안내 후 중단
2	CWD에 .wiki 심볼릭 링크가 존재	"/wiki 스킬로 위키 환경을 먼저 구성해주세요. npx skills add dev-goraebap/agent-wiki-hub --all -g로 전체 설치할 수 있습니다" 안내 후 중단
3	.wiki/wiki-manifest.yaml이 존재	"매니페스트가 없습니다. /wiki 스킬로 위키를 다시 생성해주세요" 안내 후 중단

워크플로우

1. 변경된 파일 감지

프로젝트에서 최근 만들어지거나 수정된 문서 파일을 찾는다.

# 미커밋/미스테이지 변경분
git status --short

# 최근 커밋의 변경 파일
git diff HEAD~1 --name-only 2>/dev/null

감지된 파일 중 문서 파일만 필터링한다:

• 포함: *.md, *.mmd, *.yaml, *.yml (확장자 기반)
• 제외: 아래 경로/파일은 무조건 건너뛴다

제외 목록

에이전트 설정 파일 및 도구 디렉토리. 이것들은 위키의 영역이 아니다.

.claude/        .cursorrules          .github/copilot-*
.agents/        .windsurfrules        GEMINI.md
.vscode/        .idea/                node_modules/
.wiki/          package.json          package-lock.json
.gitignore      *.lock                skills/

.wiki/ 하위 파일은 이미 위키 안에 있으므로 건너뛴다. skills/ 하위는 스킬 정의 파일이므로 건너뛴다.

2. 위키 등록 가치 판단

각 파일에 대해:

1. 매니페스트 확인 — 이미 wiki-manifest.yaml의 documents에 등록된 파일이면 건너뛴다
2. 타입 추론 — 파일명과 경로에서 타입을 추론한다
   • wiki 스킬의 references/well-known-types.md를 참고하여 매칭 시도
   • 예: ARCHITECTURE.md → architecture, tasks/ 하위 → task, decisions/ 하위 → decision
   • 매칭 안 되면 파일 내용을 읽고 추론. 그래도 불확실하면 사용자에게 질문
3. SDLC 범주 추론 — well-known-types.md의 SDLC 칼럼을 참고. 커스텀 타입이면 "미분류"

3. scope 결정

• CWD의 Git 루트 폴더명을 scope로 제안 (case-insensitive)
• well-known-types.md의 scope 특성을 참고
  • "공유" 타입 (prd, erd, decision 등) → scope 없음(공유 문서) 제안
  • "프로젝트별" 타입 (task, architecture 등) → 현재 프로젝트명 scope 제안
• 사용자에게 확인: "scope를 {프로젝트명}으로 설정할까요, 아니면 공유 문서로 등록할까요?"

4. 등록 후보 제안

감지된 문서 후보를 정리하여 사용자에게 보여준다:

## 위키 등록 후보

| # | 파일 | 추론 타입 | SDLC | scope | 등록? |
|---|------|----------|------|-------|------|
| 1 | ARCHITECTURE.md | architecture | 설계 | my-app | ? |
| 2 | docs/api-contract.md | api-spec | 설계 | my-app | ? |
| 3 | PRD.md | prd | 계획 | 공유 | ? |

등록할 문서를 선택해주세요.

사용자가 선택하면 해당 문서만 처리한다. 전부 건너뛰어도 된다.

5. 등록 실행

사용자가 승인한 문서에 대해:

1. .wiki/ 하위에 파일을 복사한다
   • 복사 경로는 well-known-types.md의 권장 경로를 참고
   • 예: architecture 타입 → .wiki/design/{scope}-architecture.md
   • 복사 후 원본은 프로젝트에 유지한다 (삭제하지 않음)
2. 매니페스트 수정 전에 Read로 원본 내용을 기억해둔다 (백업)
3. wiki-manifest.yaml의 documents 배열 끝에 엔트리를 추가한다

   - path: {위키 루트 기준 상대 경로}
     type: {결정된 타입}
     scope: {프로젝트명 또는 생략}
     source-skill: wiki-discover
     created: {오늘 날짜}
     tags: [{관련 태그}]
   

4. 매니페스트 수정 후 YAML 파싱 검증. 실패 시 기억해둔 원본으로 Write하여 복원한다
5. 등록 결과를 사용자에게 안내한다

참고

• 이 스킬은 명시적 호출에만 동작한다 (/wiki-discover 또는 자연어 트리거)
• 자동 감지(hook, 커밋 시점 등)는 v2에서 검토
• 에이전트 설정 파일(.claude/, .cursorrules 등)은 위키의 영역이 아니다. 개발 설계 문서만 대상으로 한다