방법 · 2026.11.12
스킬과 AGENTS.md를 한 저장소에 모으고 나머지 저장소는 포인터로 가리켜라 — 세션 하나에서 전체 시스템을 보며 작업할 수 있다
The Home Repo Pattern — Matt Pocock (AI Hero) · 원문 보기 ↗
얻는 것
- 스티어링 파일과 툴링이 한곳에 모여 저장소마다 복제되던 스킬 사본이 사라진다
- 세션 하나에서 여러 저장소를 가로지르는 변경을 계획하고 실행할 수 있다
- 팀이 같은 저장소를 공유하면 모두가 동일한 스킬과 규칙 위에서 에이전트를 돌린다
이럴 때
프로젝트가 여러 저장소에 걸쳐 있어 한 저장소에서 시작한 에이전트가 그 저장소만 보게 될 때, 그리고 모노레포를 쓸 수 없는 상황(공개·비공개 저장소가 섞여 있거나 팀이 모노레포를 받아들이지 않을 때) 대안으로 쓴다. 팀이 공유해서 모두가 그 안에서 에이전트를 실행하는 경우에도 쓴다.
이렇게
- 저장소들이 모여 있는 폴더에서 코딩 에이전트 세션을 새로 열고 설정 프롬프트를 붙여 넣는다.
- 1단계로 홈 디렉터리 아래 모든 git 저장소를 찾아 경로·리모트·공개 여부·마지막 커밋일을 기록하고, 어떤 저장소를 가리킬지·Home Repo 위치·개인용인지 팀 공유인지·세션 시작 시 로드되는 파일이 무엇인지 답한다.
- 2단계로 선택한 저장소들과 사용자 레벨 스킬 폴더의 스킬·AGENTS.md·CLAUDE.md·에이전트용 문서를 전부 나열해 shared/duplicate/repo-specific/installed 네 버킷 중 하나로 분류한다.
- 3단계로 각 항목의 현재 위치와 목적지를 담은 표와 Home Repo의 AGENTS.md 초안('Other Repos' 섹션에 저장소당 포인터 한 줄)을 받아 승인한다.
- 4단계로 Home Repo와 AGENTS.md를 만들고 공유 항목을 스킬 폴더째 복사한 뒤, 각 자식 저장소에서는 새 로컬 브랜치를 만들어 옮겨간 사본을 제거하고 Home Repo에 커밋한다(푸시는 내가 결정).
바로 해 볼 것
저장소들이 모인 폴더에서 에이전트 세션을 열고 본문의 설정 프롬프트를 붙여 넣어 보자. 에이전트가 저장소 목록과 스킬을 스스로 조사해 공유/중복/저장소 전용/설치됨으로 분류한 표를 내놓는데, 내 환경에 중복된 스킬과 지침 파일이 실제로 얼마나 쌓여 있었는지를 여기서 확인할 수 있다. 승인 전까지는 읽기만 하므로 파일이 바뀔 걱정 없이 현황 점검용으로 돌려볼 수 있다.
링크
배경 — 원문은 이런 이야기
여러 저장소로 쪼개진 프로젝트에서 에이전트를 돌리면 시작한 저장소 하나만 보이고, 스킬과 설정은 저장소마다 따로 복사되어 쌓인다. Matt Pocock은 이 상황의 대안으로 공용 스킬과 지침 파일을 담은 저장소 하나를 두고 거기서 모든 세션을 시작하는 방식을 제안한다. 모노레포를 쓸 수 없을 때, 특히 공개와 비공개 저장소가 섞인 환경을 염두에 둔 구성이다.