클로드 프로젝트 기억과 지시문 — 저장소가 둘이 되면 훅이 빠짐

프로젝트에 일을 맡기면 갈래마다 새 세션이 뜹니다. 그때마다 「우리 프로젝트는 이런 거고 규칙은 이렇다」를 다시 설명할 수는 없죠. 그래서 한 번만 적어 두면 새로 뜨는 갈래마다 따라가는 자리가 셋 마련돼 있습니다.

그런데 저장소를 몇 개 묶느냐가 규칙을 바꿉니다. 하나일 때는 그 저장소의 권한 규칙과 훅까지 갈래에 적용되는데, 둘 이상이 되는 순간 그 둘은 빠집니다. 하필 여러 저장소를 다루는 게 이 기능의 대표 쓰임새라 더 신경 쓸 대목입니다.

📌 30초 요약

• 맥락을 두는 자리가 셋입니다.
• 지시문은 일만 육천 자까지입니다.
• 고칠 때 「기억해 둬」도 함께 말하세요.
• 저장소 없이도 프로젝트가 됩니다.
• 둘이 되면 권한과 훅이 빠집니다.

1. 한 번만 정해 두는 세 자리

먼저 무엇이 어디에 들어가는지 갈라 두겠습니다. 셋 다 한 번 정해 두면 새로 뜨는 갈래마다 적용됩니다.

어디에	무엇이 담기나
프로젝트 기억	클로드가 스스로 적는 요구사항·결정·함정
프로젝트 지시문	내가 쓰는 안내문 — 일만 육천 자까지
저장소·파일·환경	복제할 저장소, 읽을 파일, 도는 환경
저장소의 지침 파일	그 저장소에 관한 규칙 — 별개로 유지

기억 쪽은 클로드가 일하면서 스스로 써 나갑니다. 모든 갈래가 시작할 때 색인 파일을 읽고, 필요하면 나머지 파일을 엽니다. 「이건 기억해 둬」나 「그건 잊어」라고 말하면 들어가고 빠지며, 설정에서 직접 읽고 고치고 지울 수도 있습니다.

헷갈리기 쉬운 지점이 있어 짚어 둡니다. 프로젝트 기억은 내 컴퓨터에 쌓이는 자동 기억과 별개이고, 저장소에 두는 지침 파일과도 별개입니다. 이름이 비슷해 한 덩어리로 보기 쉽지만 저장소에 관한 규칙은 그 저장소 지침 파일에, 프로젝트에 관한 메모는 프로젝트 기억에 나눠 두는 게 문서가 권하는 방식입니다.

2. 지시문에 무엇을 적나

지시문은 새 갈래가 출발하는 브리핑입니다. 문서가 권하는 항목은 다섯인데, 앞의 둘은 당연하고 뒤의 셋이 실제로 사고를 막습니다.

①무엇을 위한 프로젝트인지 ②어느 저장소에서, 어느 가지에서 시작하고 요청 이름은 어떻게 다는지 — 여기까지는 예상하실 겁니다. 그다음이 중요합니다. ③끝났다고 하기 전에 갈래가 스스로 무엇을 확인해야 하는지 ④필요한 것에 못 닿으면 어떻게 할지 ⑤내 승인을 먼저 받아야 하는 일입니다.

문서가 든 예문에 좋은 문장이 있습니다 — 「못 닿는 게 있으면 정확히 무엇이 없는지 첫 메시지에 말하고 멈춰라. 대체하거나 흉내내거나 추측하지 마라」. 갈래가 묻지 않고 넘겨짚는 문제를 앞서 다뤘는데, 그 상황을 애초에 막는 한 줄이 이것입니다. 검사 방법도 「끝내기 전에 이 명령을 돌리고 결과 요약을 마지막 메시지에 붙여라」처럼 구체적으로 적어 두는 편이 낫고요.

운영하면서 챙길 습관도 하나 있습니다. 갈래를 고쳐 줄 때 「이건 기억해 둬」라고 함께 말하는 것입니다. 그러면 그 교정이 프로젝트 기억에 들어가 나중 갈래들이 그걸 갖고 출발합니다. 안 그러면 같은 지적을 계속 반복하게 됩니다.

3. 저장소를 넣을지 말지

저장소를 프로젝트에 넣으면 이후 모든 갈래가 그걸 복제하고 지침 파일·스킬을 싣고 시작합니다 — 그 작업이 해당 저장소를 안 건드려도 말이죠. 반대로 안 넣어 두면 갈래가 필요할 때 스스로 가져올 수 있습니다.

다만 나중에 가져오는 쪽에는 대가가 있습니다. 복제가 작업 도중에 일어나므로 그 저장소의 지침 파일과 스킬은 갈래가 출발할 때 없었습니다. 게다가 다음 갈래는 다시 없는 상태로 시작하고요. 자주 건드리는 저장소라면 넣어 두는 편이 맞습니다.

두 가지 더 알아 두시면 좋습니다. 저장소가 아예 없어도 프로젝트는 성립합니다 — 갈래가 조사하고 문서를 쓰고 자기 모래상자에서 코드를 돌려 결과를 보관함에 넘길 수 있으니까요. 그리고 프로젝트에 저장소가 생긴 뒤에는 클로드가 이미 쓰는 소유자의 저장소만 추가할 수 있습니다. 다른 소유자 것은 제가 직접 넣어야 하고요. 저장소가 여럿인 큰 프로젝트라면 거의 모든 작업이 건드리는 한두 개만 넣고 나머지는 지시문에 이름만 적어 두라는 게 문서의 권고입니다.

4. 둘이 되면 달라지는 것

여기가 이 글에서 가장 조심할 대목입니다. 권한 규칙과 훅은 저장소가 하나일 때만 따라간다고 짚은 적이 있는데, 그 이유와 범위가 문서에 자세히 나옵니다.

저장소에 있는 것	저장소가 여럿일 때
지침 파일	전부 적재됩니다
스킬·에이전트·명령	전부 적재됩니다
확장 묶음	전부 적재 — 다투면 프로젝트 설정이 우선
권한 규칙·훅·환경 변수	적용되지 않습니다

⚠️ 왜 넷째 줄만 빠지나

지침 파일과 스킬은 모든 저장소에서 읽어 오는데 권한 규칙·훅·환경 변수만 「갈래가 출발한 자리」의 설정 파일에서만 옵니다. 저장소가 하나면 갈래가 그 안에서 출발하니 적용되지만, 여럿이면 복제본들 위쪽에서 출발하므로 어느 저장소의 설정도 읽히지 않습니다. 저장소를 하나 더 붙이는 순간 안전장치가 조용히 사라지는 셈이죠. 다만 확장 묶음이 딸려 오는 훅은 여전히 돕니다 — 확장 묶음 자체는 모든 저장소에서 적재되니까요. 저장소가 여럿이라면 표준 규칙은 지시문에, 환경 변수는 클라우드 환경 쪽에 넣어 두세요.

덧붙이면 저장소가 하나일 때도 환경 변수 전부가 넘어가는 건 아닙니다. 폴더 신뢰 같은 안전장치와 마찬가지로, 클라우드 세션이 애초에 받지 않는 항목은 그대로 빠집니다. 「하나면 다 된다」가 아니라 「하나면 대부분 되고, 여럿이면 거의 안 된다」로 기억해 두시는 편이 안전합니다.

자주 묻는 질문 (FAQ)

Q. 지침 파일과 프로젝트 기억은 뭐가 다른가요

쓰는 주체와 범위가 다릅니다. 지침 파일은 그 저장소에 관한 규칙이고, 프로젝트 기억은 클로드가 일하며 스스로 적는 프로젝트 메모입니다. 내 컴퓨터에 쌓이는 자동 기억과도 별개입니다.

Q. 같은 지적을 갈래마다 반복하게 됩니다

고쳐 줄 때 「이건 기억해 둬」를 함께 말하세요. 그 교정이 프로젝트 기억에 들어가 나중 갈래들이 갖고 출발합니다. 늘 지켜야 할 규칙이라면 지시문 쪽이 더 맞습니다.

Q. 저장소를 여러 개 넣었더니 훅이 안 돕니다

정상 동작입니다. 권한 규칙·훅·환경 변수는 갈래가 출발한 자리의 설정에서만 오는데, 저장소가 여럿이면 복제본들 위에서 출발하기 때문입니다. 확장 묶음이 제공하는 훅은 예외로 계속 돕니다.

Q. 다른 조직의 저장소를 추가하려는데 안 됩니다

프로젝트에 저장소가 생긴 뒤에는 클로드가 이미 쓰는 소유자의 것만 추가할 수 있습니다. 다른 소유자 저장소는 제가 설정에서 직접 넣어야 합니다.

정리하면

• 맥락 자리는 셋입니다.
• 지시문엔 멈추는 법을 적으세요.
• 교정은 기억으로 넘기세요.
• 나중에 붙이면 늦게 실립니다.
• 둘부터는 훅이 빠집니다.

※ 공개된 프로젝트 문서의 「서 있는 맥락」 절을 읽고 정리했습니다. 화면 이름과 설정 항목은 우리말로 풀어 적었으니 실제 표기는 원문에서 확인하세요.

※ 이 기능은 베타 단계로 소개돼 있어 글자 수 한도와 적용 범위가 바뀔 수 있습니다. 원문과 대조해 확인하세요.