wiki

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

핵심 개념

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

워크플로우

1. 프리셋 선택

사용자에게 사용 환경을 질문한다:

"위키를 어떤 환경에서 사용할 계획인가요?"

• solo: 혼자 + 1레포. 가장 단순한 구조
• solo-multi: 혼자 + 여러 레포. 프론트/백엔드 등 레포가 나뉜 경우
• team-multi: 여러 레포 + 레포마다 다른 사람이 담당
• team-full: team-multi + 같은 레포에서 여러 명이 브랜치로 작업

사용자가 잘 모르겠다면 solo를 기본으로 추천한다. 나중에 /wiki-preset으로 변경 가능함을 안내.

2. 사전 확인

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

3. 위키 저장소 생성

1. 위키 폴더 위치 결정

   • CWD가 Git 저장소: 같은 레벨에 [프로젝트명]-wiki 생성
   • 그 외: 사용자가 선택한 경로에 생성
   • 동일 이름 폴더 존재 시 중단 안내

2. 프리셋 템플릿 적용

   • references/presets/{프리셋명}.yaml을 읽는다
   • 프리셋의 디렉토리 구조에 따라 폴더를 생성한다
   • 프리셋의 매니페스트 템플릿으로 wiki-manifest.yaml을 생성한다
   • 프리셋에 협업 가이드가 있으면 CONVENTIONS.md를 생성한다

3. references/contributing-template.md를 CONTRIBUTING.md로 생성

4. Git 초기화 + 첫 커밋

5. 상위 디렉토리가 Git 저장소이면 .gitignore에 위키 폴더명 등록 여부 확인

4. 심볼릭 링크 연결

CWD가 소스코드 프로젝트(Git 저장소이면서 위키가 아닌 환경)라면 연결한다.

1. 프로젝트 루트에 .wiki 심볼릭 링크 생성

   • 절대 경로 사용 (상대 경로는 CWD 변경 시 깨짐)
   • OS별 명령: references/symlink-guide.md 참고
   • .wiki가 이미 존재하면:
     • 정상 심볼릭 링크: 덮어쓸지 확인
     • 깨진 링크: 삭제 후 재생성
     • 실제 디렉토리/파일: 절대 삭제하지 않음. 수동 조치 안내

2. 심볼릭 링크 검증 (ls -la .wiki)

3. .gitignore에 .wiki 등록

CWD가 프로젝트가 아니면 위키 생성만 완료. 추후 /wiki-link로 프로젝트에 연결 가능함을 안내.

관련 스킬

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