문서들

설치는 되었지만 사용되지 않는 것 같나요? 플랫폼이 훅을 지원하는 경우, 메모리는 에이전트에 전달되며 별도의 설정이 필요하지 않습니다. 훅을 지원하지 않는 경우에는 설정 과정에서 메모리 정보가 플랫폼의 컨텍스트 파일에 저장되어, 에이전트가 해당 메모리를 가져올 수 있도록 합니다. 메모리가 연결된 것처럼 보이지만 에이전트가 접근하지 않는다면, 가장 먼저 확인해야 할 곳이 바로 그 파일입니다.

Claude Code에 무엇이 적히는가

Claude Code에서는 pip install(brethof-brain install-hooks)이 CLAUDE.md에 하나의 관리 블록을 유지하며, 매 세션 시작 시 다시 작성됩니다. 이것은 교육 내용의 복사본이 아니라 포인터로, 에이전트에게 메모리가 Brain라는 점, 접근 방법, 그리고 “이것을 기억해”라고 하면 한 컴퓨터의 Claude Code 자체 메모리 파일이 아닌 Brain로 저장된다는 점을 알려줍니다. 실제 교육 내용은 세션 시작 시 전달됩니다. 이 블록 외부의 어떤 것도 건드리지 않으므로 사용자의 규칙은 그대로 유지됩니다. 끄려면 BRETHOF_BRAIN_NO_CLAUDE_MD=1을 설정하세요. 플러그인 설치 시에는 이 블록을 직접 쓰지 않으므로, 플러그인 README의 블록을 ~/.claude/CLAUDE.md에 붙여넣거나 에이전트에게 요청하세요.

명령어 및 버전

Claude Code 플러그인에는 /recall (즉시 검색), /onboard (프로젝트 시작 시), /curate (세션 종료)라는 세 가지 명령어가 포함되어 있습니다. 수동으로 실행할 필요는 전혀 없으며, 새로운 기록들이 들어오면 메모리가 자동으로 정리해 줍니다.

변하는 것은 에이전트와 대화하는 방식입니다. 이제는 이런 식으로 말할 수 있습니다. “결제 재시도에 대해 우리는 무엇으로 결정했나요?” or 스테이징 박스는 오래된 인증서가 있는 그 것이라는 점을 기억하세요. — 쉬운 말로, 대화하는 도중에 말이죠. 당신의 에이전트가 적절한 도구를 선택하고, 당신은 그 이름을 직접 언급하지 않습니다.

당신의 에이전트가 도움을 줄 수 있는 것들

이 목록은 필요 없습니다. 특정한 것을 요청했을 때 무엇이 가능한지 알 수 있도록 여기에 있는 것뿐입니다.

• 물건 찾기 — 과거 세션의 정확한 문장들이 필요할 때는 직접 선별한 기억을 검색하거나, 원본 대화 기록을 확인하세요.
• 기억하기 — 사실을 프로젝트에 저장하거나, 모든 프로젝트에 적용되는 공유 레이어에 저장할 수 있습니다.
• 가르치기 — 규칙을 저장하거나, 그 프로젝트에서 중요한 사항을 설명하는 문장으로 프로젝트를 시작하세요.
• 항목 검사하기 — 프로젝트 목록을 조회하거나, 프로젝트가 알고 있는 정보를 나열하거나, 그 규칙들을 확인하거나, 하나의 레코드를 읽을 수 있습니다.
• 항목 삭제 — 단일 레코드를 삭제합니다. 특정 문구를 가리거나 전체 프로젝트를 삭제하는 작업은 계정 패널에서 이루어집니다.
• 장부를 확인하세요 — 프로젝트에 남아 있는 미결정된 작업들을 확인하고, 결정한 항목들은 해당 행을 삭제해 주세요.
• 플레이북을 보관하십시오. — 한 번만 절차를 저장하면 전체 계정에 적용됩니다. 어떤 프로젝트에서든 그 절차를 불러와 실행할 수 있으며, 현재 존재하는 절차들을 목록으로 확인하고 더 이상 사용되지 않는 절차들은 삭제할 수 있습니다.

에이전트가 고의적으로 할 수 없는 한 가지는: 전체 프로젝트를 삭제합니다. 이 작업은 원본 아카이브에 직접 영향을 미치므로, 사용자의 계정 패널에 남아 있으며 그곳에서 사람이 이름을 입력해야 합니다.

규칙이란 자신이 반복하는 것을 막는 수단입니다. 즉, 에이전트들이 절대 잊어서는 안 되는 관례, 제약 조건, 그리고 오랜 시간에 걸쳐 얻어진 교훈들이죠. 좋은 규칙들은 마치 법칙과 같습니다: “금요일에는 절대 사용하지 마라”, “이 프로젝트에서는 공백 대신 탭을 사용한다”, “고객의 이름은 Brethof이지, 결코 Brefoth가 아니다”. 간결하고 명확하며, 다음 달에도 여전히 유효합니다.

에이전트에게 규칙을 저장해 달라고 요청하면, 한 가지를 묻습니다. 이 규칙은 사용자가 하는 모든 일에 적용되는 것인가, 아니면 이 프로젝트에만 적용되는 것인가?

그 세 번째 옵션이 가장 중요한 것이며, 다른 두 옵션보다 더 자주 선택됩니다. 규칙이란 비용이 많이 드는 것입니다. 규칙은 모든 세션에서 계속해서 공간을 차지하며, 큐레이터에게 무엇이 중요한지를 알려줍니다. 일반적인 지식을 규칙으로 분류하는 것은 마치 기억들이 점점 쌓여서 아무것도 두드러지지 않게 되는 것과 같습니다.

규칙은 에이전트뿐 아니라 큐레이터도 가르칩니다.

명확한 규칙 몇 개가 있는 프로젝트는 규칙이 없는 프로젝트보다 확실히 더 잘 기억합니다. 규칙이 그 프로젝트의 큐레이터에게 무엇이 중요한지 알려주기 때문입니다. 규칙을 하나 저장하면, 몇 분 안에 그 프로젝트의 메모리는 이 프로젝트가 무엇인지 다시 학습합니다.

날카롭게 유지하기

규칙은 큰 소리로 말할 수 있을 만큼 짧아야 합니다. 그렇지 않다면 그것은 규칙의 형태를 띤 지식에 불과합니다. 중복된 규칙들은 하나로 통합하고, 더 이상 유용하지 않은 규칙들은 삭제해야 합니다. 다른 어떤 것도 당신의 규칙을 결정할 권한이 있어서는 안 되기 때문에, 아무것도 자동으로 정리해 주지 않습니다. 신뢰하는 규칙 12개가, 더 이상 읽지 않는 규칙 50개보다 낫습니다.

실제 프로젝트

유일하게 중요한 결정은 그것들을 어떻게 나눌 것인가 하는 것입니다. 각 코드베이스나 클라이언트, 프로젝트별로 하나씩 분리하는 것이 효과적인 방식입니다. 너무 적으면 관련 없는 작업들이 서로 섞이고, 너무 많으면 맥락이 흩어집니다. 프로젝트를 시작할 때 그 목적을 한 문장으로 명확히 정하는 것은 가장 가치 있는 시간 활용 방법입니다. 이를 통해 첫날부터 프로젝트를 관리하는 사람이 당신의 의도를 짐작할 필요 없이 바로 이해할 수 있습니다.

세 가지 다른 것들은 측정 방식이 각기 다르므로, 어느 것이 무엇인지 아는 것이 중요합니다. 녹음 중 저장 공간에 의해 제한됩니다. 학습 월간 할당량에 의해 제한됩니다. 회상하기 어떤 제한도 받지 않습니다. — 검색, 세션 브리핑, 그리고 프롬프트별 정보 회상 기능은 귀하의 메모리가 당사의 실시간 시스템에 있는 한 계속 작동합니다.

구독이 만료될 경우

Brain는 즉시 일시 중단됩니다 — 유예 기간은 없습니다. 메모리는 7일 후에 아카이브되며, 23일경에 경고가 발송되고 30일에 삭제됩니다. 유료로 활성화된 계정은 절대 건드리지 않습니다. 전체 일정과 그에 따른 이메일은 개인정보 보호 정책에 나와 있습니다.

한계가 남기는 공백, 그리고 우리가 왜 그것을 채우지 않는지

한계가 존재하기 때문에 새로운 기억들은 형성되지 않습니다. 그로 인해 해당 기간에 대한 기억에 공백이 생기는 것입니다. 우리는 나중에 돌아가서 다시 채우지 않습니다.. 그것은 의도적인 디자인 원칙이며, 당신은 그것을 알아야 합니다.

기억은 대화를 통해서만 만들어진다. 우연히도. 몇 주 전에 작성된 자료를 바탕으로 나중에 기록하는 것은 그 이후로 사실이었던 내용을 덮어쓰게 될 것이며, 우리의 기억도 더 이상 사실이 아닌 것들을 단호하게 주장하기 시작할 것입니다. 우리는 확신에 찬 거짓말을 만드는 것보다는 공백을 남겨두는 편을 선택합니다.

간단히 말해, 그 공백은 메모리로서는 영구적입니다. 해당 기간의 원본 대화 기록은 여전히 존재하고 검색도 가능하므로 기록이 사라진 것은 아니며, 정제된 층에만 공백이 생긴 것입니다. 제한이 길어질수록 메모리는 실제로 수행 중인 작업에서 점점 더 벗어나게 됩니다. 그리고 재개해도 스스로 복구되지 않습니다. 에이전트는 오래된 메모리를 만날 때마다 수정하고, 새로운 기록이 들어올 때마다 기존 기록과 대조하여 새로운 메모리와 모순되는 것들은 폐기합니다. 이 두 과정은 항상 앞으로만 진행되며, 결코 뒤로 돌아가지 않습니다.

아무도 조용히 차단되지 않습니다. 한도에 가까워지면 이메일이 오고, 한도가 적용되면 또 다른 이메일이 옵니다. 한도가 시작되면 에이전트 세션 안에 알림이 표시되고, 한도가 활성화된 동안에는 모든 프롬프트에 짧은 안내 문구가 나타납니다.