Preamble

_DW_VER="1.0.0"
npx dot-wiki check --skill-version "$_DW_VER" 2>/dev/null || true

preamble 출력에 SKILL_UPDATE_AVAILABLE 또는 UPDATE_AVAILABLE이 있으면:

1. "dot-wiki {new} 버전이 나왔습니다 (현재 {old})" 한 줄 표시
2. 업데이트 방법: npx skills add dev-goraebap/dot-wiki --all -g
3. 현재 스킬 작업을 계속 진행

wiki

위키 저장소를 생성하고 프리셋에 맞는 초기 구조를 구성하는 코어 스킬이다.

핵심 개념

• 위키 저장소: 설계 문서, 아키텍처 원칙 등을 모아두는 독립된 Git 저장소
• 심볼릭 링크: 각 프로젝트 루트에 .wiki라는 고정된 이름으로 위키 저장소를 연결
• 매니페스트: .wiki/wiki-manifest.yaml — 문서 레지스트리와 컨텍스트 프로파일을 선언
• 프리셋: 사용 환경에 맞는 기본 구조를 결정 (solo / solo-multi / team-multi / team-full)
• 위키 저장소는 자체적으로 Git 버전 관리를 하므로, 소스코드 프로젝트의 .gitignore에 .wiki를 등록

워크플로우

1. 프리셋 선택

반드시 AskUserQuestion 도구를 사용하여 사용자에게 선택지를 제공한다. 텍스트로 나열하지 않는다.

AskUserQuestion 호출:

• question: "위키를 어떤 환경에서 사용할 계획인가요? 나중에 /wiki-preset으로 변경 가능합니다."
• options:
  • label: "solo (권장)", description: "혼자 + 1레포. 가장 단순한 구조"
  • label: "solo-multi", description: "혼자 + 여러 레포. 프론트/백엔드 등 레포가 나뉜 경우"
  • label: "team-multi", description: "여러 레포 + 레포마다 다른 사람이 담당"
  • label: "team-full", description: "team-multi + 같은 레포에서 여러 명이 브랜치로 작업"

2. 사전 확인

상황	처리
CWD가 이미 위키 저장소	안내 후 중단
CWD가 홈/시스템 디렉토리	프로젝트 경로 질문
CWD가 Git 저장소가 아님	위키 위치 선택지 제공
상위에 [프로젝트명]-wiki 존재	기존 사용 or 새로 생성 확인

3. 위키 저장소 생성

CLI로 생성:

dot-wiki init [path] --preset <name>

이 명령은:

1. 프리셋의 디렉토리 구조를 생성
2. wiki-manifest.yaml을 생성
3. .wiki 심볼릭 링크를 생성

추가 에이전트 작업:

1. 프리셋에 협업 가이드가 있으면 CONVENTIONS.md를 생성 (team-multi, team-full)
2. CONTRIBUTING.md 생성
3. Git 초기화 + 첫 커밋
4. 상위 디렉토리가 Git 저장소이면 .gitignore에 위키 폴더명 등록 여부 확인

4. 심볼릭 링크 검증

dot-wiki health로 환경을 검증한다.

5. .gitignore 등록

프로젝트의 .gitignore에 .wiki를 등록한다.

관련 스킬

• /wiki-link — 기존 위키에 새 레포 연결 (로컬 경로 또는 git remote URL)
• /wiki-preset — 프리셋 변경 (solo → solo-multi 등)