agents 관련 질문입니다!

Question

안녕하세요. 강사님! 서브에이전트 기초: 코드 리뷰 서브 에이전트 강의 를 들으면서 /agents 명령어를 통해 코드리뷰와 관련된 서브에이전트 1개를 생성 했습니다. 그 결과 강사님의 강의 내용과 동일하게 .claude/agents/code-reviewer.md 가 생성되었고, 그 이후에 프롬포트를 작성할때 해당 에이전트를 사용해서 전체 코드 리뷰를 진행했습니다. 근데 그 이후에 .claude 디렉토리 하위에 사진과같이 agent-memory/code-reviewer 가 생성되고, 그 하위에 4가지의 md파일이 생성 되었는데요. (1) 해당 파일이 원래 생성되는게 정상인건가요? 현재 시점 기준에서요!! (2) 또한 해당 파일은 굳이 github에 안올려도 되겠죠? (.gitignore) 뭔가 docs를 한번 더 보다가 아래와 같은 내용이 있던데(새로 추가가된건진 잘 모르겠습니다,,) , (3) 저런 맥락이면 CLAUDE.md 에 약간 이런식으로 넣어놓은다음 그 다음에 다시 에이전트를 호출 하는 방식이 올바른 방향성일까요? ## Subagent 가이드 (를 만든 후) ### code-reviewer 에이전트 에이전트는 다음을 따르세요: 1. 작업 시작 전 `.claude/agent-memory/code-reviewer/` 확인 2. 새로운 패턴/이슈 발견 시 메모리 업데이트 3. 작업 완료 후 발견사항 저장 매 리뷰마다: - 해결된 이슈는 known_issues.md에서 제거 - 새로운 패턴은 code_patterns.md에 추가 - 아키텍처 변화는 project_overview.md 업데이트

짐코딩 · Answer

안녕하세요! 🙂 세 가지 질문 순서대로 답변드릴게요. 먼저 (1) 해당 파일이 자동 생성된 건 정상이에요 . 최근에 추가된 서브에이전트 영구 메모리 기능 때문입니다. .claude/agents/code-reviewer.md 의 frontmatter에 memory: project (또는 user/local) 필드가 설정되어 있으면 .claude/agent-memory/<에이전트 이름>/ 폴더가 자동으로 생성되고, MEMORY.md를 포함한 메모리 파일들이 쌓여요. MEMORY.md의 첫 200줄 또는 25KB (둘 중 먼저 도달하는 쪽)가 에이전트 호출 시 시스템 프롬프트에 자동 주입되는 구조예요. 강의 촬영 시점에 따라 영상에서는 안 보였을 수 있어요. (2) git 관리 여부는 활용 방식에 따라 갈려요. memory 스코프가 project 라는 건 "팀과 공유하면서 지식을 누적시키겠다"는 의도라 git에 커밋하는 게 원래 설계입니다. 반대로 혼자 쓰시거나 공유하기 싫으시면 frontmatter를 memory: local 로 바꾸시면 돼요. 이 경우 저장 위치 자체가 .claude/agent-memory-local/<에이전트 이름>/ 로 분리됩니다(별도 폴더라 .gitignore도 따로 처리 가능해요). 공식 docs에도 local 은 "버전 제어에 체크인되지 않아야 할 때" 사용하라고 명시되어 있어요. 어느 쪽이든 정답이 정해진 건 아니고 본인 워크플로우에 맞게 선택하시면 돼요. (3) CLAUDE.md에 지침을 적어두는 방식도 작동은 합니다. 다만 공식 docs에서 권장하는 방향은 서브에이전트 markdown 파일( code-reviewer.md ) 자체에 메모리 사용 지침을 넣는 것 이에요. 캡처해주신 docs 마지막 줄에도 "Subagent의 markdown 파일에 직접 포함"이라고 적혀 있고요. 예시로 이런 식이에요. --- name: code-reviewer description: Reviews code for quality and best practices memory: project --- You are a code reviewer. As you review code, update your agent memory with patterns, conventions, and recurring issues you discover. 리뷰를 시작하기 전 메모리에서 이전에 본 패턴을 먼저 확인하고, 리뷰가 끝나면 새로 발견한 패턴/이슈를 메모리에 기록합니다. 이렇게 에이전트 파일에 직접 넣으면 해당 에이전트가 호출될 때만 이 지침이 작동해요. CLAUDE.md에 넣으면 메인 세션의 모든 작업에 영향을 주기 때문에 컨텍스트가 불필요하게 무거워질 수 있어요. 다만 두 방식 모두 동작은 하니, 본인 워크플로우에 맞게 선택하시면 됩니다. 감사합니다 🙂