brain

English · 한국어

배운 것을 쌓아 두는 개인 지식 베이스(knowledge base)입니다. 노트를 직접 손으로 채우는 저장소가 아니라, 학습용 에이전트 스킬 세 개가 자동으로 채우고 갱신하는 살아 있는 저장소입니다.

학습은 PTR (Place → Teach → Review)이라 부르는 사이클로 진행됩니다.

place-me  →  teach-me  →  review-me
 (진단)       (학습)        (복습)
   └──────────  levels.md  ──────────┘

PTR은 세 스킬로 이루어진 학습 루프의 이름입니다. 주제마다 한 번씩 돌립니다. 현재 수준을 진단하고, 조각조각 배우고, 익숙해질 때까지 복습합니다. 수준이 올라가면 다시 반복합니다.

세 가지 스킬

이 저장소는 kidow/skills 레포지토리의 학습 스킬들과 함께 사용하도록 만들어졌습니다.

• place-me — 학습을 시작하기 전, 해당 주제를 얼마나 알고 있는지 짧은 적응형 진단으로 가늠합니다. levels.md에 기존 요약이 있으면 시작 추정치로 활용합니다. 한 번에 한 질문씩, 수준이 확인될 때까지 묻고, 결과를 서술형 수준 요약으로 levels.md에 기록한 뒤 teach-me에 넘깁니다.
• teach-me — 한 번에 지식 하나씩, 기초부터 심화 순으로 설명합니다. levels.md를 먼저 읽어 깊이를 조정합니다. “다음”이라고 할 때만 진행하고, 이미 배운 내용은 다시 가르치지 않으며, 모호한 용어는 즉시 교정합니다. 복잡한 개념은 모국어·문화에 빗대 설명하고, 이해가 어려우면 시각 자료를 제공합니다. 외국어 학습 시 발음이 필요하면 음성 자료도 재생합니다. 주제가 완전히 다루어지면 관련 주제 2–3개를 제안합니다. 설명한 지식은 notes/topic_name.md에 커밋하며, 노트가 쌓이면 도메인별 하위 폴더로 자동 정리합니다.
• review-me — 저장된 노트를 한 항목씩 퀴즈로 복습합니다. 간격 반복(Again / Hard / Good / Easy) 방식이며, 컨텍스트가 없으면 levels.md에서 수준이 낮은 주제부터 우선 복습합니다. levels.md가 없으면 place-me 실행을 먼저 제안합니다. 복습이 끝나면 그 결과를 토대로 levels.md의 수준을 갱신하고 .review/ 폴더를 삭제합니다.

세 스킬은 topic_name이라는 공통 키로 연결됩니다. notes/topic_name.md의 파일 이름과 levels.md의 ## topic_name 섹션이 같은 주제를 가리킵니다.

저장소 구조

brain/
├── notes/            # 배운 지식 (teach-me가 작성, review-me가 읽음)
│   ├── topic_name.md #  - 주제당 1파일, 날짜 없음(git 히스토리가 시점 추적)
│   └── <domain>/     #  - 주제가 쌓이면 도메인별 하위 폴더로 자동 정리
├── levels.md         # 주제별 수준 메모리 (Blank/Glimpsed/Grounded/Fluent)
└── README.md

• notes/ — 지식 노트입니다. frontmatter 없이 내용만 담습니다.
• levels.md — 주제별 수준을 네 단계 라벨 + 서술형 요약으로 기록합니다.
  • Blank — 개념 자체를 접한 적 없음
  • Glimpsed — 본 적은 있지만 스스로 재현·설명 불가
  • Grounded — 자기 말로 설명하고 새 맥락에 적용 가능
  • Fluent — 예외·뉘앙스·엣지케이스까지 막힘없이 처리
• .review/ — 복습 세션 중에만 존재하는 휘발성 폴더입니다. 세션이 끝나면 삭제됩니다(git 추적 제외).

스킬 설치

npx skills@latest add kidow/skills/place-me
npx skills@latest add kidow/skills/teach-me
npx skills@latest add kidow/skills/review-me

사용 예

이 저장소 안에서 학습 스킬을 실행하시면 됩니다.

/place-me 일본어 문자의 특징     # 수준 진단 → levels.md 기록
/teach-me 일본어 문자의 특징     # 한 조각씩 학습 → notes/ 커밋
/review-me                       # 약한 주제부터 복습 → levels.md 갱신

나만의 brain 만들기

아래 프롬프트를 복사해 AI 어시스턴트(Claude Code 권장)에게 붙여넣으세요:

PTR 학습 시스템(Place → Teach → Review)으로 개인 지식 베이스를 세팅해줘.

1. 새 git 저장소를 만들고 Claude Code로 열어줘.
2. 학습 스킬 세 개를 설치해줘:
   npx skills@latest add kidow/skills/place-me
   npx skills@latest add kidow/skills/teach-me
   npx skills@latest add kidow/skills/review-me
3. 다음 파일 구조를 만들어줘:
   - notes/      (빈 폴더 — git이 추적하도록 .gitkeep 파일 추가)
   - levels.md   (빈 파일)
   - README.md   (https://github.com/kidow/brain 에서 복사)

완료되면 /place-me <주제> 로 첫 번째 주제 수준 진단을 시작해줘.