brain

English · 한국어

A personal knowledge base of everything I learn. Not a repo I fill by hand — three learning agent skills populate and keep it up to date automatically. It's a living store.

Learning runs as a cycle called PTR (Place → Teach → Review):

place-me  →  teach-me  →  review-me
 (assess)     (learn)      (review)
   └──────────  levels.md  ──────────┘

PTR is the name for this three-skill loop. Run it once per topic: assess where you stand, learn piece by piece, then review until it sticks. Repeat as the level rises.

The three skills

This repo is built to work with the learning skills from the kidow/skills repository.

• place-me — Before learning a topic, a short adaptive diagnostic gauges how much I already know. Reads any existing levels.md entry for the topic as a starting guess. One question at a time until the level is clear, then it writes a prose level summary to levels.md and hands off to teach-me calibrated to the result.
• teach-me — Explains one piece of knowledge at a time, always progressing from foundational to advanced. Reads levels.md first to calibrate depth. Advances only when I say "next", never re-teaches covered pieces, and flags imprecise vocabulary for correction. Complex concepts are grounded in analogies to my native language and culture. A visual aid is drawn when something is hard to grasp, and an audio aid plays pronunciation when learning a foreign language. When all pieces are covered, suggests 2–3 related topics. Each piece is committed to notes/topic_name.md; notes auto-organize into domain subfolders as they grow.
• review-me — Quizzes me on the saved notes one item at a time using spaced repetition (Again / Hard / Good / Easy). With no context given, it prioritizes the weakest topics from levels.md; offers to run place-me first if levels.md is missing. When the session ends, it updates the level in levels.md and deletes the ephemeral .review/ folder.

The three skills are tied together by a shared topic_name key: the notes/topic_name.md filename and the ## topic_name section in levels.md point to the same topic.

Repository layout

brain/
├── notes/            # learned knowledge (written by teach-me, read by review-me)
│   ├── topic_name.md #  - one file per topic, no date (git history tracks time)
│   └── <domain>/     #  - notes auto-organize into domain subfolders as they grow
├── sheets/           # quick-reference cheat sheets (HTML, served via GitHub Pages)
├── levels.md         # per-topic level memory (Blank/Glimpsed/Grounded/Fluent)
└── README.md

• notes/ — knowledge notes, content only, no frontmatter.
• levels.md — each topic's level as a four-stage label plus a prose summary.
  • Blank — no prior exposure to the concept
  • Glimpsed — seen it before but cannot reproduce or explain it reliably
  • Grounded — explains it independently and applies it in new contexts
  • Fluent — handles exceptions, nuance, and edge cases without hesitation
• .review/ — an ephemeral folder that exists only during a review session and is deleted when it ends (excluded from git).

Levels

Current level per topic — brain.dongwook.kim/levels

Notes

All knowledge notes served live at brain.dongwook.kim.

Languages — Japanese

• 히라가나
• 가타카나
• 일본어 문자의 특징
• 일본어 기본 한자
• 일본어 동사
• 일본어 조사

Languages — Chinese

• 중국어 문자
• 중국어 발음

Languages — Russian

• 러시아어 문자의 특징

Languages — Spanish

• 스페인어 문자
• 스페인어 명사와 성

Languages — German

• 독일어 문자
• 독일어 명사
• 독일어 동사

Languages — French

• 프랑스어 문자
• 프랑스어 명사 성
• 프랑스어 동사 현재형

Languages — Arabic

• 아랍어 문자

Languages — English

• 영어
• 영어 전치사
• 영어 관사
• 영어 부사
• 영어 조동사
• 영어 가정법
• 영어 수동태
• 영어 관계대명사
• 영어 관계부사
• 영어 접속사
• 영어 분사구문
• 영어 시제 심화
• 영어 5형식
• 영어 to부정사
• 영어 가산/불가산 명사
• 영어 비교급 최상급
• 영어 분사

Music

• 음악 이론 기초
• AI 음악 프롬프팅

Art

• 미술 작품 교양

Economics / Finance

• 회계학
• 세금 용어
• 경제학
• 투자 기초
• 부동산 기초

Daily Life

• 근로기준법
• 자동차 상식

Science

• 화학

Technology

• 컴퓨터 부품

Cheat Sheets

Quick-reference sheets served live at brain.dongwook.kim.

Japanese

• 히라가나 치트시트
• 가타카나 치트시트

Russian

• 러시아어 치트시트
• 러시아어 알파벳 이름
• 러시아어 모음 약화

Chinese

• 병음 표
• 중국어 성모표
• 중국어 성조규칙

German

• 독일어 치트시트
• 독일어 명사 치트시트

French

• 프랑스어 명사 치트시트

Spanish

• 스페인어 알파벳 이름
• 스페인어 발음 규칙
• 스페인어 악센트 강세
• 스페인어 특수부호 키보드

English

• 영어 전치사 치트시트
• 영어 관사 치트시트
• 영어 조동사 치트시트
• 영어 부사 치트시트
• 영어 가정법 치트시트
• 영어 수동태 치트시트
• 영어 관계대명사 치트시트
• 영어 관계부사 치트시트
• 영어 접속사 치트시트
• 영어 분사구문 치트시트
• 영어 시제 심화 치트시트
• 영어 가산/불가산 명사 치트시트

Technology

• 컴퓨터 부품

Installing the skills

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

Usage

Run the learning skills from inside this repository.

/place-me Japanese writing system   # assess level → record in levels.md
/teach-me Japanese writing system   # learn piece by piece → commit to notes/
/review-me                          # review weakest topics → update levels.md

Start your own brain

Copy the prompt below and paste it to your AI assistant (Claude Code recommended):

Set up a personal knowledge base using the PTR learning system (Place → Teach → Review).

1. Create a new git repository and open it in Claude Code.
2. Install the three learning skills:
   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. Create this file structure:
   - notes/      (empty folder — add a .gitkeep file so git tracks it)
   - levels.md   (empty file)
   - README.md   (copy from https://github.com/kidow/brain)

Once done, start with /place-me <topic> to assess your first topic.