Claude Code를 위한 개인 OS
이 스킬은 '브레인(brain)'을 구축하는 데 도움을 줍니다. 브레인은 Claude Code가 당신이 맡긴 정보를 저장하고, 결정된 사항을 찾고, 다음 단계를 준비하는 마크다운 형식의 텍스트 파일 폴더로, 어떤 편집기에서든 읽을 수 있습니다. 처음에는 간단한 질문으로 안내하고, 이후에는 복사해서 사용할 수 있는 템플릿을 제공하여 단계별로 진행합니다.
읽기 원칙: 처음에는 단계를 순서대로 따르세요. references/의 파일에는 세부 사항과 템플릿이 포함되어 있습니다. 필요할 때 참조할 수 있습니다.
0. 용도와 결과
기억이 없으면 Claude와의 모든 대화는 처음부터 다시 시작됩니다. 브레인이 있으면 대화는 일회용이 되고 폴더가 기억이 됩니다. 중요한 내용은 파일에 기록되고, Claude는 응답하기 전에 파일을 다시 읽습니다.
설정 후 얻을 수 있는 것은 다음과 같습니다.
- 원시 자료(회의록, 메모, 복사한 이메일, 캡처)를 넣어두는 받은 편지함(
inbox/). - 네 가지 범주(결정(이유 포함), 작업(담당자 포함), 새로운 사실, 미해결 질문)로 처리.
- 저널, 결정 레지스트리, 타임라인(추가만 가능, 수정 불가).
- 주제별 카드(프로젝트당 하나의 파일)와 작은 스크립트로 다시 생성되는 요약 보드.
- 전문 에이전트(수집, 보드 검토, 일관성 확인, 문서 작성, 1:1 미팅 준비, 결정 조언) 및 단축 명령어(
/inbox,/journal...). - 외부 도구(위키, 이슈 트래커, 프레젠테이션)에 보고할 내용을 알려주는 변경 로그 파일(
CHANGELOG.md).
귀하의 동의 없이는 아무것도 기록되지 않습니다. Claude가 제안하고, 귀하가 승인하면 기록합니다.
1. 사전 요구 사항
- Claude Code가 컴퓨터에 설치되어 작동 중이어야 합니다(터미널에서
claude명령 사용 가능). - 예를 들어
~/brain과 같은 빈 폴더. 이 폴더는 이 프로젝트에서 Claude가 쓸 수 있는 유일한 영역입니다. - 보기 스크립트용 Python 3(선택 사항, 추가 설치 불필요).
- 마크다운을 열 수 있는 텍스트 편집기. Git 저장소를 권장하지만 필수는 아닙니다.
빈 폴더에서 터미널을 열고 claude를 실행하세요.
2. 초기 인터뷰
Claude는 다음 일곱 가지 질문을 하나씩 하며 각 질문에 대한 답변을 기다립니다. 짧은 답변으로 충분합니다. Claude가 각 답변으로 무엇을 하는지는 다음과 같습니다.
| 질문 | Claude가 하는 일 |
|---|---|
| 1. 귀하의 역할과 팀을 한 문장으로 설명해 주세요. | CLAUDE.md의 '내 소개' 섹션을 채워서 Claude가 귀하에게 적절한 수준으로 말을 건네도록 합니다. |
| 2. 현재 진행 중인 3~5개의 프로젝트는 무엇인가요? | 05_scope/sheets/에 프로젝트별 주제 카드를 만듭니다. |
| 3. 가장 자주 협업하는 사람들의 이름(이름, 역할)은 무엇인가요? | 03_team/directory.md를 채우고 확인해야 할 이름 목록을 준비합니다. |
| 4. 어떤 종류의 자료를 받나요? (회의록, 이메일, 메모, 캡처) | inbox/의 분류 규칙과 Claude가 읽을 수 있는 형식 목록을 설정합니다. |
| 5. 귀하가 생성한 결과물을 어디에 보고해야 하나요? (위키, 이슈 트래커, 프레젠테이션) | CHANGELOG.md를 조정합니다. 업데이트할 페이지당 한 줄씩, '추가' 또는 '교체'와 함께 표시합니다. |
| 6. 어떤 언어로 작성하며, 어떤 글쓰기 규칙을 원하시나요? | CLAUDE.md의 '스타일' 섹션을 채웁니다. |
| 7. 검토 주기는 어떻게 되나요? (매일, 매주, 1:1 미팅 전) | 먼저 설치할 명령어와 에이전트를 선택합니다(5단계). |
계속하기 전에 Claude는 이해한 내용을 10줄로 요약하고 귀하의 동의를 기다립니다.
3. 구조 만들기
Claude는 references/structure.md에 설명된 디렉토리 구조를 제안하고, 귀하의 동의 후에 생성합니다. 기본 폴더는 다음과 같습니다.
inbox/및archive/: 원시 자료의 저장소 및 처리 후 보관.00_journal/: 저널 및 타임라인(추가만 가능).01_steering/: 작업 보드가 포함된 관리.02_product/: 제품에 대한 지속적인 사실.03_team/: 인명록, 협업 노트.04_decisions/: 결정 레지스트리(추가만 가능).05_scope/: 주제 카드 및 생성된 보기.06_resources/: 용어집, 참조 문서.scripts/: 보기 스크립트..claude/: 에이전트 및 명령어.
황금률: 파일 하나, 주제 하나, 중립적인 이름. 어떤 파일도 사람 이름을 사용하지 않습니다. 사람에 관한 내용은 인명록에 들어갑니다.
그런 다음 references/templates/의 템플릿을 복사하고 대괄호 안의 필드를 2단계의 답변으로 바꿉니다.
4. CLAUDE.md 지침 파일 작성
CLAUDE.md는 Claude Code가 각 세션에서 자동으로 읽습니다. 여기에는 규칙이 포함되어 있습니다. references/templates/CLAUDE.md 템플릿을 시작점으로 사용하고, 최소한 다음 사항이 포함되어 있는지 확인하세요.
- 귀하의 신원과 Claude가 귀하에게 말을 건네는 방식.
- 새로운 정보가 도착했을 때 Claude가 수행하는 작업(수집 프로토콜,
references/ingestion-rules.md참조). - 신선도 규칙, 추가 전용 파일, '하나의 사실, 하나의 파일' 규칙.
- 9단계의 안전 규칙.
- 6번 질문에서 선택한 글쓰기 스타일.
- 전사 도구에서 자주 왜곡되는 고유 명사 목록(시간이 지남에 따라 업데이트).
이 파일을 간결하게 유지하세요(1~2페이지). 세부 사항은 references/의 파일에 있으며, Claude는 필요할 때 읽습니다.
5. 에이전트 및 명령어 추가
에이전트는 고유한 지침과 권한을 가진 전문 도우미입니다. 명령어는 Claude Code에 입력하는 바로 가기(예: /inbox)입니다. 둘 다 .claude/ 안의 간단한 마크다운 파일입니다.
작게 시작하세요. 먼저 다음을 설치합니다.
inbox-ingestion에이전트 및/inbox명령어(받은 편지함 처리용)./journal명령어(빠른 메모 기록용).
필요에 따라 다음을 추가하세요. board-review, consistency-check, deliverables-writer, meeting-prep, decision-advisor, 그리고 /review-board, /prep-1to1, /propagate 명령어. 각각의 역할은 references/agents.md에, 복사할 템플릿은 references/templates/.claude/에 있습니다.
각 추가 후, Claude에게 파일이 읽히는지 확인하도록 요청하세요. /agents를 입력하여 목록을 확인합니다.
6. 첫 번째 테스트: 메모 작성 및 처리
- 실제 메모(짧더라도)를
inbox/에 작성하거나 붙여넣습니다(예:inbox/2026-01-15_팀회의.txt). /inbox를 입력합니다.- Claude가 파일을 읽고, 의심스러운 부분을 식별하고, 기존 정보와 교차 참조하여 제안된 수정 사항의 번호가 매겨진 목록(파일, 이전, 이후, 출처 포함)을 반환합니다.
- '1, 2, 4 검증' 또는 '모두 검증'이라고 응답합니다. 명확한 응답이 없으면 아무것도 기록되지 않습니다.
- Claude가 기록하고, 원본을
archive/로 이동하고, 수행된 작업을CHANGELOG.md에 기록하고, 보기 스크립트를 다시 실행합니다.
전체 프로토콜은 references/inbox-processing.md에 있습니다. 원시 메모와 결과가 포함된 전체 예제는 references/example-acme/에 있습니다.
7. 루틴
시작하려면 네 가지 주기로 충분합니다.
- 매일(5분). 도착한 자료를
inbox/에 넣고,/inbox를 입력하고, 승인합니다. 하루가 끝나면/journal을 입력하여 자유 메모를 남깁니다. - 회의 후. 필사본이나 메모를 넣고
/inbox를 입력합니다. 결정과 그 이유를 먼저 확인하고, 그 다음으로 작업과 담당자를 확인합니다. - 매주.
/review-board를 입력한 다음consistency-check에이전트에게 날짜, 상태, 이름을 확인하도록 요청합니다. 보기 스크립트를 다시 실행합니다. - 1:1 미팅 전.
/prep-1to1 [이름]을 입력합니다.meeting-prep에이전트가 이전에 논의된 내용, 보류 중인 항목, 미해결 질문을 각 줄의 출처와 함께 수집합니다.
8. 발전시키기
- 주제 추가.
references/templates/scope-sheet.md를05_scope/sheets/로 복사하고, 필드를 채운 다음 보기 스크립트를 실행합니다. - 에이전트 추가.
references/templates/.claude/agents/에서 템플릿을 복사하고, 이름, 설명, 지침을 변경합니다. 실제 사례에서 테스트한 후 채택합니다. - 보기 추가. 카드를 읽고 표를 생성하는 작은 스크립트를 작성하거나 작성하도록 합니다. 스크립트는 카드를 읽기만 하고 절대 수정하지 않습니다.
references/scripts/build_views.py스크립트가 시작점 역할을 합니다. - 변경 사항이 여러 콘텐츠에 영향을 미치는 경우.
/propagate를 사용합니다(references/use-cases.md의 사용 사례 참조).
무엇을 추가하기 전에 스스로에게 네 가지 질문을 해보세요. 이것이 결정과 그 이유를 잃지 않도록 도와줍니까? 각 프로젝트의 다음 작업과 담당자를 알려줍니까? 한 주제에서 다른 주제로 전환하는 노력을 줄여줍니까? 팀에 유용한 기록을 남깁니까? 모든 질문에 '아니오'라면 추가하지 마세요.
9. 안전 규칙
- 제안, 승인, 기록. Claude가 먼저 수정할 내용을 제시합니다. 명시적인 승인 후에만 기록합니다.
- 절대 지어내지 않기. 텍스트에 없는 결정이나 작업은 생성되지 않습니다. 결정 이유가 없으면 '이유가 기록되지 않음'이라고 기록합니다.
- 의심스러운 경우 알리기. 구절이 모호하거나 이름이 전사 왜곡처럼 보이면 Claude가 이를 알리고 결정을 내리는 대신 질문합니다.
- 승인 없이 삭제 금지. 귀하가 요청하지 않는 한, 정해진 흐름(받은 편지함에서 보관함으로) 외에는 어떤 파일도 삭제하거나 이동하지 않습니다.
- 사실, 약속, 아이디어 구분. 완료된 것, 누군가에게 약속한 것, 고려 중인 것은 세 가지 다른 상태입니다. Claude의 제안이 약속으로 제시되지 않습니다.
- 출처 유지. 중요한 각 줄은 출처(파일, 날짜)를 참조합니다.
체크리스트
-
claude가 브레인 폴더에서 시작되고CLAUDE.md를 읽습니다. - 2단계의 일곱 가지 질문에 답변하고 요약이 승인되었습니다.
- 3단계의 폴더가 존재하며, 사람 이름을 사용하는 파일이 없습니다.
- 저널, 결정 레지스트리, 타임라인이
CLAUDE.md에서 '추가 전용'으로 선언되었습니다. - 신선도 규칙과 '하나의 사실, 하나의 파일' 규칙이
CLAUDE.md에 있습니다. -
inbox-ingestion에이전트와/inbox명령어가/agents및 명령어 목록에 나타납니다. - 첫 번째 테스트가 처음부터 끝까지 수행되었습니다. 제안, 승인, 기록, 보관,
CHANGELOG.md줄. -
python3 scripts/build_views.py가 오류 없이 실행되고 보기를 생성합니다. - 7단계의 네 가지 루틴이 귀하가 확인하는 곳에 기록되어 있습니다.
- 9단계의 안전 규칙이
CLAUDE.md에 복사되었습니다.
스킬 파일
| 파일 | 내용 |
|---|---|
references/structure.md | 권장 디렉토리 구조 및 각 폴더의 역할 |
references/ingestion-rules.md | 수집 규칙(전후 예시 포함) |
references/inbox-processing.md | 받은 편지함 파일 처리 프로토콜(전체 예제) |
references/agents.md | 6개 에이전트 카탈로그 |
references/use-cases.md | 7가지 사용 시나리오 |
references/templates/ | 복사할 템플릿(지침, 보드, 레지스트리, 저널, 카드, 에이전트, 명령어) |
references/scripts/build_views.py | 보기 생성 스크립트 |
references/example-acme/ | 완전하고 가상의 예제 브레인 |