repo-docs — 저장소 이해용 문서 생성기

무엇을 해주나

• 파일 트리 나열이 아니라 실제 동작 하나(요청·작업·데이터 흐름·실패 경로) 를 끝까지 따라가는 워크스루를 먼저 작성합니다.
• README.md, walkthroughs/one-real-run.md, code-map.md, modules/, references/source-evidence.md, glossary.md, change-log.md 로 구성된 문서 패키지를 규칙에 따라 생성합니다(소규모 저장소는 Lite, 코드가 아직 없으면 Seed 모드).
• 모든 서술을 소스·테스트·설정·명령 검증 후 작성하도록 요구하고, 근거를 Claim | Evidence | Confidence | Caveat 표로 남깁니다.
• 코드가 바뀐 뒤에는 '동기화 게이트'로 none / answer-only / foreground patch / background sync 중 하나를 먼저 결정해 불필요한 문서 수정을 막습니다.
• 마지막에 동봉된 scripts/validate_repo_docs.py 로 구조·링크·근거·최신성 검증을 수행합니다.

이런 분께 추천

• 신규 입사자 온보딩 문서가 필요한 팀 리드·시니어 개발자
• 오래된 저장소를 인수인계받아 구조부터 파악해야 하는 개발자
• 대형 모노레포에서 특정 서브시스템만 범위로 잡아 설명 문서를 만들고 싶은 분
• 코드 변경 후 문서가 계속 낡아가는 문제를 겪는 프로젝트

활용 예시

1. "이 저장소 처음 봐. repo-docs 만들어줘" → 엔트리포인트/테스트/설정을 2회 순회 조사한 뒤 대표 동작 하나를 골라 워크스루와 코드맵을 생성.
2. "결제 API 리팩터링했어, 문서 동기화해줘" → 동기화 게이트 판정 후 해당 모듈 페이지만 최소 수정하고 change-log.md에 Synced through <sha> 기록.
3. "아직 코드는 없고 기획만 있어" → Seed 모드로 Confirmed / Planned / Unknown 라벨을 붙인 프로젝트 메모리 문서 생성.
4. "생성된 repo-docs 지워줘" → 문서 패키지와 루트 AGENTS.md 라우팅 블록까지 정리.

이 파일의 지시를 읽고 그대로 따라서 나를 도와줘:
https://raw.githubusercontent.com/YurunChen/repo-docs-skills/HEAD/skills/repo-docs/SKILL.md

내가 원하는 것: (여기에 하고 싶은 일을 쓰세요)

클로드스킬마트에서 찾은 스킬을 설치해줘.
GitHub 저장소 YurunChen/repo-docs-skills 의 skills/repo-docs 폴더를 내 ~/.claude/skills/yurunchen-repo-docs/ 에 그대로 복사해줘.
설치가 끝나면 이 스킬로 무엇을 할 수 있는지 한 줄로 알려줘.