Skip to content

A self-organizing Obsidian vault that gives AI coding agents persistent memory.

44.1 KB
Raw Blame

๐ŸŒ English | ๆ—ฅๆœฌ่ชž | ไธญๆ–‡ | ํ•œ๊ตญ์–ด

[!NOTE] ์ด ๋ฒˆ์—ญ์€ AI์˜ ๋„์›€์„ ๋ฐ›์•„ ์ž‘์„ฑ๋˜์—ˆ์Šต๋‹ˆ๋‹ค. ๋ถ€์ž์—ฐ์Šค๋Ÿฌ์šด ํ‘œํ˜„์ด๋‚˜ ์˜ค์—ญ์„ ๋ฐœ๊ฒฌํ•˜์‹œ๋ฉด Issue ๋˜๋Š” Pull Request๋กœ ์•Œ๋ ค์ฃผ์„ธ์š”. ์ปค๋ฎค๋‹ˆํ‹ฐ์˜ ์ˆ˜์ •๊ณผ ๊ธฐ์—ฌ๋ฅผ ํ™˜์˜ํ•ฉ๋‹ˆ๋‹ค.

Obsidian Mind

Obsidian Mind

Claude Code Codex CLI Gemini CLI Obsidian Obsidian CLI Obsidian Skills QMD Node License

Claude Code๊ฐ€ ๋ชจ๋“  ๊ฒƒ์„ ๊ธฐ์–ตํ•˜๊ฒŒ ํ•ด์ฃผ๋Š” Obsidian ๋ณผํŠธ. ์„ธ์…˜์„ ์‹œ์ž‘ํ•˜๊ณ  ํ•˜๋ฃจ์— ๋Œ€ํ•ด ์ด์•ผ๊ธฐํ•˜๋ฉด, Claude๊ฐ€ ๋‚˜๋จธ์ง€๋ฅผ ์ฒ˜๋ฆฌํ•ฉ๋‹ˆ๋‹ค โ€” ๋…ธํŠธ, ๋งํฌ, ์ธ๋ฑ์Šค, ์„ฑ๊ณผ ์ถ”์ ๊นŒ์ง€. ๋ชจ๋“  ๋Œ€ํ™”๊ฐ€ ์ด์ „ ๋Œ€ํ™” ์œ„์— ์Œ“์ž…๋‹ˆ๋‹ค.


๐Ÿ”ด ๋ฌธ์ œ

Claude Code๋Š” ๊ฐ•๋ ฅํ•˜์ง€๋งŒ ๊ธฐ์–ตํ•˜์ง€ ๋ชปํ•ฉ๋‹ˆ๋‹ค. ๋งค ์„ธ์…˜์ด ์ œ๋กœ์—์„œ ์‹œ์ž‘๋ฉ๋‹ˆ๋‹ค โ€” ๋‹น์‹ ์˜ ๋ชฉํ‘œ, ํŒ€, ํŒจํ„ด, ์„ฑ๊ณผ์— ๋Œ€ํ•œ ์ปจํ…์ŠคํŠธ๊ฐ€ ์—†์Šต๋‹ˆ๋‹ค. ๊ฐ™์€ ๋‚ด์šฉ์„ ๋ฐ˜๋ณตํ•ด์„œ ์„ค๋ช…ํ•ด์•ผ ํ•ฉ๋‹ˆ๋‹ค. ์„ธ ๋ฒˆ์˜ ๋Œ€ํ™” ์ „์— ๋‚ด๋ฆฐ ๊ฒฐ์ •์ด ์‚ฌ๋ผ์ง‘๋‹ˆ๋‹ค. ์ง€์‹์ด ์ถ•์ ๋˜์ง€ ์•Š์Šต๋‹ˆ๋‹ค.

๐ŸŸข ํ•ด๊ฒฐ์ฑ…

์—์ด์ „ํŠธ์—๊ฒŒ ๋‡Œ๋ฅผ ์ฃผ์„ธ์š”.

You: "start session"
์—์ด์ „ํŠธ: *reads North Star, checks active projects, scans recent memories*
์—์ด์ „ํŠธ: "You're working on Project Alpha, blocked on the BE contract.
         Last session you decided to split the coordinator. Your 1:1
         with your manager is tomorrow โ€” review brief is ready."

shardmind install ๋˜๋Š” git clone์œผ๋กœ ์„ค์น˜ โ€” ์–ด๋А ์ชฝ์ด๋“  ๋™์ผํ•œ ๋ณผํŠธ์ž…๋‹ˆ๋‹ค.


โšก ์‹ค์ œ ๋™์ž‘ ์˜ˆ์‹œ

Obsidian Mind ๋ฐ๋ชจ โ€” standup ๋ฐ dump ๋ช…๋ น์–ด

์•„์นจ ํ‚ฅ์˜คํ”„:

/om-standup
# โ†’ loads North Star, active projects, open tasks, recent git changes
# โ†’ "You have 2 active projects. The auth refactor is blocked on API contract.
#    Your 1:1 with Sarah is at 2pm โ€” last time she flagged observability."

ํšŒ์˜ ํ›„ ๋ธŒ๋ ˆ์ธ ๋คํ”„:

/om-dump Just had a 1:1 with Sarah. She's happy with the auth work but wants
us to add error monitoring before release. Also, Tom mentioned the cache
migration is deferred to Q2 โ€” we decided to focus on the API contract first.
Decision: defer Redis migration. Win: Sarah praised the auth architecture.
โ†’ Updated org/people/Sarah Chen.md with meeting context
โ†’ Created work/1-1/Sarah 2026-03-26.md with key takeaways
โ†’ Created Decision Record: "Defer Redis migration to Q2"
โ†’ Added to perf/Brag Doc.md: "Auth architecture praised by manager"
โ†’ Updated work/active/Auth Refactor.md with error monitoring task

์ธ์‹œ๋˜ํŠธ ๋Œ€์‘:

/om-incident-capture https://slack.com/archives/C0INCIDENT/p123456
# โ†’ slack-archaeologist reads every message, thread, and profile
# โ†’ people-profiler creates notes for new people involved
# โ†’ Full timeline, root cause analysis, brag doc entry

ํ•˜๋ฃจ ๋งˆ๋ฌด๋ฆฌ:

You: "wrap up"
# โ†’ verifies all notes have links
# โ†’ updates indexes
# โ†’ brag-spotter finds uncaptured wins
# โ†’ suggests improvements

๐Ÿš€ ๋น ๋ฅธ ์‹œ์ž‘

๐Ÿ“ฆ ShardMind๋กœ ์„ค์น˜ (๊ถŒ์žฅ)

npm install -g shardmind
mkdir my-vault && cd my-vault
shardmind install github:breferrari/obsidian-mind

shardmind install์€ ํ˜„์žฌ ๋””๋ ‰ํ† ๋ฆฌ์— ๊ธฐ๋กํ•˜๋ฏ€๋กœ, ๋จผ์ € ์ƒˆ ํด๋”๋ฅผ ๋งŒ๋“ค๊ณ  ๊ทธ ์•ˆ์œผ๋กœ ์ด๋™ํ•˜์„ธ์š”. ๋งˆ๋ฒ•์‚ฌ๊ฐ€ ์ด๋ฆ„, ์กฐ์ง, ๋ณผํŠธ ๋ชฉ์ , ํฌํ•จํ•  ์—์ด์ „ํŠธ, QMD ํ™œ์„ฑํ™” ์—ฌ๋ถ€๋ฅผ ์ˆ˜์ง‘ํ•ฉ๋‹ˆ๋‹ค. ์ด์–ด์„œ ShardMind๊ฐ€ git์„ ์ดˆ๊ธฐํ™”ํ•˜๊ณ , ํ•„์š” ์‹œ QMD๋ฅผ ๋ถ€ํŠธ์ŠคํŠธ๋žฉํ•˜๋ฉฐ, ๋‹ต๋ณ€์— ๋”ฐ๋ผ brain/North Star.md๋ฅผ ๊ฐœ์ธํ™”ํ•ฉ๋‹ˆ๋‹ค. ๊ทธ๋Ÿฐ ๋‹ค์Œ:

  1. ์„ค์น˜๋œ ํด๋”๋ฅผ Obsidian ๋ณผํŠธ๋กœ ์—ฝ๋‹ˆ๋‹ค
  2. ์„ค์ • โ†’ ์ผ๋ฐ˜์—์„œ Obsidian CLI๋ฅผ ํ™œ์„ฑํ™”ํ•ฉ๋‹ˆ๋‹ค (Obsidian 1.12+ ํ•„์š”)
  3. ๋ณผํŠธ ๋””๋ ‰ํ† ๋ฆฌ์—์„œ ์—์ด์ „ํŠธ๋ฅผ ์‹คํ–‰ํ•ฉ๋‹ˆ๋‹ค: claude, codex, ๋˜๋Š” gemini. Codex๋Š” ํด๋”๊ฐ€ ์‹ ๋ขฐ๋˜๊ณ  ๊ฐ ํ›…์ด ์Šน์ธ๋˜๊ธฐ ์ „๊นŒ์ง€ ๋ณผํŠธ์˜ ํ›…์„ ์‹คํ–‰ํ•˜์ง€ ์•Š์Šต๋‹ˆ๋‹ค: ๋‹ค๋ฅธ ์—์ด์ „ํŠธ์™€ ์‚ฌ์šฉํ•˜๊ธฐ ์ฐธ๊ณ .
  4. ์—…๋ฌด์— ๋Œ€ํ•ด ์ด์•ผ๊ธฐ๋ฅผ ์‹œ์ž‘ํ•˜์„ธ์š”

ShardMind๋Š” Obsidian ๋ณผํŠธ ํ…œํ”Œ๋ฆฟ์˜ ํŒจํ‚ค์ง€ ๋งค๋‹ˆ์ €์ž…๋‹ˆ๋‹ค. ์„ค์น˜ ์‹œ .shardmind/ ์‚ฌ์ด๋“œ์นด๊ฐ€ ์ถ”๊ฐ€๋˜์–ด ๋งˆ๋ฒ•์‚ฌ, ์„ ํƒ์  ๋ชจ๋“ˆ (์‚ฌ์šฉํ•˜์ง€ ์•Š๋Š” ๊ฒƒ์€ ๊ฑด๋„ˆ๋›ฐ๊ธฐ), 3-way ๋จธ์ง€ ์—…๊ทธ๋ ˆ์ด๋“œ๋ฅผ ์ œ๊ณตํ•ฉ๋‹ˆ๋‹ค. ๋ชจ๋“  ๊ฐ’์ด ๊ธฐ๋ณธ๊ฐ’์ผ ๋•Œ ์„ค์น˜ ๊ฒฐ๊ณผ๋Š” git clone๊ณผ ๋ฐ”์ดํŠธ ๋‹จ์œ„๋กœ ๋™์ผํ•ฉ๋‹ˆ๋‹ค โ€” ํด๋ก  ๊ฒฝํ—˜์ด ๊ทธ๋Œ€๋กœ ๋ณด์กด๋ฉ๋‹ˆ๋‹ค. ์„ค์น˜๋œ ๋ณผํŠธ์—์„œ .shardmind/์™€ shard-values.yaml์„ ์‚ญ์ œํ•ด๋„ ๊ณ„์† ์ž‘๋™ํ•ฉ๋‹ˆ๋‹ค: ShardMind๋Š” ์ถ”๊ฐ€ ๊ธฐ๋Šฅ์ด๋ฉฐ, ํ•„์ˆ˜ ์š”์†Œ๊ฐ€ ์•„๋‹™๋‹ˆ๋‹ค.

๋˜๋Š” ์ง์ ‘ ํด๋ก 

git clone https://github.com/breferrari/obsidian-mind.git

๋˜๋Š” GitHub ํ…œํ”Œ๋ฆฟ์œผ๋กœ ์‚ฌ์šฉํ•˜์„ธ์š”. ๋งˆ๋ฒ•์‚ฌ๋ฅผ ๊ฑด๋„ˆ๋›ฐ๊ณ  ๊ธฐ๋ณธ ํ…œํ”Œ๋ฆฟ์„ ๋ฐ›์Šต๋‹ˆ๋‹ค. ๊ทธ๋Ÿฐ ๋‹ค์Œ ์œ„์˜ 4๋‹จ๊ณ„๋ฅผ ์ง„ํ–‰ํ•˜๊ณ , ์ถ”๊ฐ€๋กœ **brain/North Star.md**์— ๋ชฉํ‘œ๋ฅผ ์ž‘์„ฑํ•˜์„ธ์š” (ShardMind ๋งˆ๋ฒ•์‚ฌ๋ฅผ ์‚ฌ์šฉํ•˜๋ฉด ์ž๋™์œผ๋กœ ์ฒ˜๋ฆฌ๋ฉ๋‹ˆ๋‹ค).

๐Ÿ” ๊ถŒ์žฅ: QMD ์‹œ๋งจํ‹ฑ ๊ฒ€์ƒ‰

๋ณผํŠธ ์ „์ฒด์˜ ์‹œ๋งจํ‹ฑ ๊ฒ€์ƒ‰์„ ์œ„ํ•ด (๋…ธํŠธ ์ œ๋ชฉ์ด "Redis Migration ADR"์ด์–ด๋„ "์บ์‹ฑ์— ๋Œ€ํ•ด ๋ญ˜ ๊ฒฐ์ •ํ–ˆ์ง€?"๋ฅผ ์ฐพ์„ ์ˆ˜ ์žˆ์Šต๋‹ˆ๋‹ค):

npm install -g @tobilu/qmd
node --experimental-strip-types .scripts/qmd-bootstrap.ts

๋ถ€ํŠธ์ŠคํŠธ๋žฉ์€ ๋ฉฑ๋“ฑ์„ฑ์ด ์žˆ์–ด ์žฌ์‹คํ–‰ํ•ด๋„ ์•ˆ์ „ํ•ฉ๋‹ˆ๋‹ค. vault-manifest.json ์˜ qmd_index ์™€ qmd_context ํ•„๋“œ๋ฅผ ์ฝ์–ด ๋ช…๋ช…๋œ ์ธ๋ฑ์Šค๋ฅผ ๋“ฑ๋กํ•˜๊ณ  ์ž„๋ฒ ๋”ฉ์„ ์ƒ์„ฑํ•ฉ๋‹ˆ๋‹ค (์ธ๋ฑ์Šค ์ด๋ฆ„์€ qmd_index ๊ฐ€ ์„ค์ •๋˜์–ด ์žˆ์œผ๋ฉด ๊ทธ ๊ฐ’, ์„ค์ •๋˜์–ด ์žˆ์ง€ ์•Š์œผ๋ฉด ๋ณผํŠธ ํด๋” ์ด๋ฆ„์„ ์Šฌ๋Ÿฌ๊ทธํ™”ํ•œ ๊ฐ’). SessionStart ํ›…, .mcp.json ๋ž˜ํผ, CLI ๋ช…๋ น์€ ๋ชจ๋‘ ๋™์ผํ•œ ๋งค๋‹ˆํŽ˜์ŠคํŠธ ํ•„๋“œ๋ฅผ ์ฐธ์กฐํ•˜๋ฏ€๋กœ, ๊ฐ™์€ ๋จธ์‹ ์˜ ๋‹ค๋ฅธ ๋ณผํŠธ์™€ QMD ๋ฐ์ดํ„ฐ๊ฐ€ ์„ž์ด์ง€ ์•Š์Šต๋‹ˆ๋‹ค. CLI ๋ช…๋ น์—๋Š” ํ•ญ์ƒ --index <์ด๋ฆ„> ์„ ์ „๋‹ฌํ•˜์„ธ์š”:

qmd --index obsidian-mind query "์บ์‹ฑ์— ๋Œ€ํ•ด ๋ญ˜ ๊ฒฐ์ •ํ–ˆ์ง€?"
qmd --index obsidian-mind update   # ์ผ๊ด„ ํŽธ์ง‘ ํ›„
qmd --index obsidian-mind embed    # ๋งŽ์€ ์‹ ๊ทœ ๋…ธํŠธ ํ›„

MCP๋ฅผ ํ†ตํ•œ ๋„ค์ดํ‹ฐ๋ธŒ ์—์ด์ „ํŠธ ๋„๊ตฌ. .mcp.json์— Model Context Protocol ์„œ๋ฒ„๋กœ ๋“ฑ๋ก๋˜์–ด ์žˆ์Šต๋‹ˆ๋‹ค โ€” QMD๊ฐ€ ์„ค์น˜๋˜์–ด ์žˆ์œผ๋ฉด mcp__qmd__query, mcp__qmd__get, mcp__qmd__multi_get๊ฐ€ Read์™€ Edit ์˜†์— ์—์ด์ „ํŠธ์˜ ๋„๊ตฌ ๋ฉ”๋‰ด์— ๋‚˜ํƒ€๋‚ฉ๋‹ˆ๋‹ค. ์„œ๋ธŒ์—์ด์ „ํŠธ, ์Šฌ๋ž˜์‹œ ๋ช…๋ น, ๋ฉ”์ธ ๋Œ€ํ™” ๋ชจ๋‘ ๋™์ผํ•œ ํƒ€์ž… ์ง€์ • ๊ณ„์•ฝ์„ ํ˜ธ์ถœํ•ฉ๋‹ˆ๋‹ค. ๋‚˜์ค‘์— ๋‹ค๋ฅธ MCP ํ˜ธํ™˜ ๋„๊ตฌ(๋ฐ์ดํ„ฐ๋ฒ ์ด์Šค, ํ‹ฐ์ผ“ํŒ… ์‹œ์Šคํ…œ, ์บ˜๋ฆฐ๋”)๋ฅผ ์ถ”๊ฐ€ํ•˜๋ฉด ๊ฐ™์€ ๋ฐฉ์‹์œผ๋กœ ํ”Œ๋Ÿฌ๊ทธ์ธ๋ฉ๋‹ˆ๋‹ค.

๋‚ด๋ถ€ ๋™์ž‘ ๋ฐฉ์‹

QMD๋Š” ์„ธ ๊ฐœ์˜ ์ž‘์€ ๋ชจ๋ธ์„ ๋กœ์ปฌ์—์„œ ์‹คํ–‰ํ•˜๋ฏ€๋กœ, ์„ค์ •ํ•  API ํ‚ค๋„ ์—†๊ณ  ์ฟผ๋ฆฌ๋‹น ๋น„์šฉ๋„ ์—†์œผ๋ฉฐ ์˜คํ”„๋ผ์ธ์—์„œ๋„ ๋™์ž‘ํ•ฉ๋‹ˆ๋‹ค:

๋ชจ๋ธ ํฌ๊ธฐ ์—ญํ• 
embeddinggemma-300M ~328MB ๋…ธํŠธ์™€ ์ฟผ๋ฆฌ๋ฅผ ๋ฒกํ„ฐ๋กœ ๋ณ€ํ™˜
qmd-query-expansion-1.7B ~1.28GB ์ฟผ๋ฆฌ๋ฅผ ๋” ๋‚˜์€ ๊ฒ€์ƒ‰์–ด๋กœ ์žฌ์ž‘์„ฑ
Qwen3-Reranker-0.6B ~640MB ํ›„๋ณด๋ฅผ ์‹ค์ œ ๊ด€๋ จ์„ฑ์œผ๋กœ ์žฌ์ •๋ ฌ

์ฒซ ์‚ฌ์šฉ ์‹œ ๋‹ค์šด๋กœ๋“œ๋˜์–ด ์บ์‹œ๋ฉ๋‹ˆ๋‹ค. GPU๋ฅผ ์ฐพ์œผ๋ฉด ์˜คํ”„๋กœ๋“œํ•˜๋ฉฐ(์™ธ์žฅ GPU๋Š” CUDA, Apple Silicon์€ Metal), ์—†์œผ๋ฉด CPU๋กœ ํด๋ฐฑํ•ฉ๋‹ˆ๋‹ค. qmd doctor๋กœ ํ˜„์žฌ ์ƒํƒœ๋ฅผ ํ™•์ธํ•  ์ˆ˜ ์žˆ์Šต๋‹ˆ๋‹ค.

์„ธ ๊ฐ€์ง€ CLI ๋ช…๋ น์€ ์ €๋ ดํ•œ ์ˆœ์„œ๋Œ€๋กœ ์ด ์Šคํƒ์— ๋Œ€์‘ํ•ฉ๋‹ˆ๋‹ค: qmd search๋Š” ๋ชจ๋ธ์„ ์ „ํ˜€ ์“ฐ์ง€ ์•Š๋Š” BM25 ํ‚ค์›Œ๋“œ ๊ฒ€์ƒ‰, qmd vsearch๋Š” ๋ฒกํ„ฐ ์ „์šฉ, qmd query๋Š” ์™„์ „ํ•œ ํ•˜์ด๋ธŒ๋ฆฌ๋“œ์ž…๋‹ˆ๋‹ค. ํฐ ๋‹ค์šด๋กœ๋“œ๋ฅผ ํ”ผํ•˜๊ณ  ์‹ถ๋‹ค๋ฉด search๋งŒ์œผ๋กœ๋„ ์ถฉ๋ถ„ํžˆ ์œ ์šฉํ•ฉ๋‹ˆ๋‹ค.

MCP ์„œ๋ฒ„์— ์ฃผ๋Š” ์˜๋ฏธ

om ์„œ๋ฒ„๋Š” ์–ดํœ˜ ์ฟผ๋ฆฌ์™€ ๋ฒกํ„ฐ ์ฟผ๋ฆฌ๋ฅผ ํ•จ๊ป˜ ๋ณด๋‚ด๋ฏ€๋กœ, ํ‚ค์›Œ๋“œ๊ฐ€ ๊ฒน์น˜์ง€ ์•Š์•„๋„ ์งˆ๋ฌธ์— ๋‹ตํ•˜๋Š” ๋…ธํŠธ๋ฅผ ์ฐพ์•„๋ƒ…๋‹ˆ๋‹ค. ์‹ค๋ฌด์ ์œผ๋กœ ์•Œ์•„๋‘˜ ์ :

  • ๋น„์‹ผ ์ชฝ์€ ์“ฐ๊ธฐ๊ฐ€ ์•„๋‹ˆ๋ผ ์ฝ๊ธฐ์ž…๋‹ˆ๋‹ค. ์ฟผ๋ฆฌ๋Š” ๊ฒ€์ƒ‰ ์ „์— ๋กœ์ปฌ์—์„œ ์ž„๋ฒ ๋”ฉ๋˜๋ฏ€๋กœ ์ฟผ๋ฆฌ๊ฐ€ ์žˆ๋Š” recall์€ ์ˆ˜ ์ดˆ๊ฐ€ ๊ฑธ๋ฆฌ๊ณ , ์ฟผ๋ฆฌ ์—†๋Š” recall์€ ๊ฑฐ์˜ ์ฆ‰์‹œ์ž…๋‹ˆ๋‹ค. ๋…ธํŠธ์— ๋Œ€ํ•œ search๋Š” ๋น ๋ฅด๋ฉฐ, ๋น„์šฉ์ด ๋“œ๋Š” ๊ฒƒ์€ ๋ฒกํ„ฐ ๋‹จ๊ณ„์ž…๋‹ˆ๋‹ค.
  • ๋ฉ”๋ชจ๋ฆฌ ์“ฐ๊ธฐ๋Š” ๋ชจ๋ธ์„ ๊ธฐ๋‹ค๋ฆฌ์ง€ ์•Š์Šต๋‹ˆ๋‹ค. ์ธ๋ฑ์Šค ๊ฐฑ์‹ ์€ ๋™๊ธฐ์ ์ด๋ผ ์ƒˆ ๋ฉ”๋ชจ๋ฆฌ๋Š” ์ฆ‰์‹œ ๊ฒ€์ƒ‰ ๊ฐ€๋Šฅํ•ด์ง€๊ณ , ๋ฒกํ„ฐ ์ƒ์„ฑ์€ ๋ฐฑ๊ทธ๋ผ์šด๋“œ์—์„œ ์ง„ํ–‰๋ฉ๋‹ˆ๋‹ค. ๋ฒกํ„ฐ๋Š” ์ˆœ์œ„์—๋งŒ ์˜ํ–ฅ์„ ์ค„ ๋ฟ ๋ฐœ๊ฒฌ ์—ฌ๋ถ€์—๋Š” ์˜ํ–ฅ์ด ์—†๊ธฐ ๋•Œ๋ฌธ์ž…๋‹ˆ๋‹ค.
  • ์ธ๋ฑ์Šค๊ฐ€ ์—†์–ด๋„ ๋™์ž‘ํ•ฉ๋‹ˆ๋‹ค. QMD๊ฐ€ ์—†์œผ๋ฉด ์„œ๋ฒ„๋Š” ์–ดํœ˜ ๋งค์นญ์œผ๋กœ ํด๋ฐฑํ•ฉ๋‹ˆ๋‹ค. ์ˆœ์œ„๋Š” ๋‚˜๋น ์ง€์ง€๋งŒ ์‚ฌ๋ผ์ง€๋Š” ๊ฒƒ์€ ์—†์Šต๋‹ˆ๋‹ค.

๐Ÿ“‹ ์š”๊ตฌ ์‚ฌํ•ญ

  • Obsidian 1.12+ (CLI ์ง€์›)
  • Claude Code
  • Node 22+ LTS (ํ›… ์Šคํฌ๋ฆฝํŠธ์šฉ โ€” Claude Code / Codex / Gemini CLI์™€ ํ•จ๊ป˜ ์ด๋ฏธ ์„ค์น˜๋˜์–ด ์žˆ์„ ๊ฐ€๋Šฅ์„ฑ์ด ํฝ๋‹ˆ๋‹ค)
  • Git (๋ฒ„์ „ ํžˆ์Šคํ† ๋ฆฌ์šฉ)
  • QMD (์„ ํƒ ์‚ฌํ•ญ, ์‹œ๋งจํ‹ฑ ๊ฒ€์ƒ‰์šฉ)

Node ํ”Œ๋ž˜๊ทธ์— ๊ด€ํ•œ ์ฐธ๊ณ . ํ›… ์Šคํฌ๋ฆฝํŠธ๋Š” Node์˜ --experimental-strip-types ํ”Œ๋ž˜๊ทธ๋กœ TypeScript๋ฅผ ์ง์ ‘ ์‹คํ–‰ํ•ฉ๋‹ˆ๋‹ค. ์ด ํ”Œ๋ž˜๊ทธ๋Š” Node 22.6+ (2024๋…„ 8์›”)๋ถ€ํ„ฐ ์•ˆ์ •ํ™”๋˜์—ˆ๊ณ , Node 23.6+ ์—์„œ๋Š” ๊ธฐ๋ณธ ๋™์ž‘์ด ๋˜์—ˆ์Šต๋‹ˆ๋‹ค. ์‹คํ—˜์ (experimental)์œผ๋กœ ํ‘œ์‹œ๋˜์–ด ์žˆ์ง€๋งŒ 22 LTS์™€ 24 LTS ์ „๋ฐ˜์—์„œ ๋™์ž‘์ด ๋ณ€๊ฒฝ๋œ ์ ์€ ์—†์Šต๋‹ˆ๋‹ค. ํ–ฅํ›„ Node ๋ฆด๋ฆฌ์Šค์—์„œ ํ”Œ๋ž˜๊ทธ๊ฐ€ ํ์ง€๋˜๊ฑฐ๋‚˜ ์ด๋ฆ„์ด ๋ณ€๊ฒฝ๋˜๋ฉด .claude/settings.json, .codex/hooks.json, .gemini/settings.json์˜ ํ›… ๋ช…๋ น์–ด๋ฅผ ํ•œ ์ค„๋งŒ ์ˆ˜์ •ํ•˜๋ฉด ๋ฉ๋‹ˆ๋‹ค.


โš™๏ธ ์ž‘๋™ ์›๋ฆฌ

์ ˆ์ฐจ์  ์ฝ”๋“œ๋Š” ํ™˜๊ฒฝ์„ ์†Œ์œ ํ•˜๊ณ , ์—์ด์ „ํŠธ๋Š” ์ฝ˜ํ…์ธ ๋ฅผ ์†Œ์œ ํ•ฉ๋‹ˆ๋‹ค. .claude/scripts/์˜ ํ›…์ด ๋ถ„๋ฅ˜, ๊ฒ€์ฆ, ์ธ๋ฑ์‹ฑ, ๋ผ์ดํ”„์‚ฌ์ดํด ์ฃผ์ž…์„ ์ฒ˜๋ฆฌํ•ฉ๋‹ˆ๋‹ค โ€” ๊ฒฐ์ •๋ก ์ ์ด๊ณ , ํ…Œ์ŠคํŠธ ๊ฐ€๋Šฅํ•˜๋ฉฐ, ๋ชจ๋“  ์—์ด์ „ํŠธ์—์„œ ๋™์ผํ•˜๊ฒŒ ์‹คํ–‰๋ฉ๋‹ˆ๋‹ค. ๋…ธํŠธ๋ฅผ ์ž‘์„ฑํ•˜๊ณ , ๋ถ„๋ฅ˜ํ•˜๊ณ , ๋งํฌํ•˜๊ณ , ๋ธŒ๋ฆฌํ”„๋ฅผ ์ž‘์„ฑํ•˜๋Š” ๊ฒƒ โ€” ์ด๋Š” ํŒ๋‹จ์ด๋ฉฐ ์—์ด์ „ํŠธ์˜ ๋ชซ์œผ๋กœ ๋‚จ๊ฒจ์ง‘๋‹ˆ๋‹ค. ์–‘์ชฝ์€ ์ž‘์€ ํ•ธ๋“œ์˜คํ”„์—์„œ ๋งŒ๋‚ฉ๋‹ˆ๋‹ค(ํ›…์ด ์ปจํ…์ŠคํŠธ๋ฅผ ์ฃผ์ž…ํ•˜๊ณ  ์—์ด์ „ํŠธ๊ฐ€ ๋ณผํŠธ๋ฅผ ์ฝ์Œ) โ€” ์„œ๋กœ์˜ ์ผ์„ ํ•  ํ•„์š”๊ฐ€ ์—†์Šต๋‹ˆ๋‹ค.

ํด๋”๋Š” ์šฉ๋„๋ณ„๋กœ ๊ทธ๋ฃนํ™”ํ•˜๊ณ , ๋งํฌ๋Š” ์˜๋ฏธ๋ณ„๋กœ ๊ทธ๋ฃนํ™”ํ•ฉ๋‹ˆ๋‹ค. ๋…ธํŠธ๋Š” ํ•˜๋‚˜์˜ ํด๋”(๋ณธ๊ฑฐ์ง€)์— ์žˆ์ง€๋งŒ ์—ฌ๋Ÿฌ ๋…ธํŠธ(์ปจํ…์ŠคํŠธ)์— ๋งํฌ๋ฉ๋‹ˆ๋‹ค. ์—์ด์ „ํŠธ๋Š” ์ด ๊ทธ๋ž˜ํ”„๋ฅผ ์œ ์ง€ ๊ด€๋ฆฌํ•ฉ๋‹ˆ๋‹ค โ€” ์ž‘์—… ๋…ธํŠธ๋ฅผ ์‚ฌ๋žŒ, ์˜์‚ฌ๊ฒฐ์ •, ์—ญ๋Ÿ‰์— ์ž๋™์œผ๋กœ ์—ฐ๊ฒฐํ•ฉ๋‹ˆ๋‹ค. ๋ฆฌ๋ทฐ ์‹œ์ฆŒ์ด ์˜ค๋ฉด ๊ฐ ์—ญ๋Ÿ‰ ๋…ธํŠธ์˜ ๋ฐฑ๋งํฌ๊ฐ€ ์ด๋ฏธ ์ฆ๊ฑฐ ์ž๋ฃŒ๊ฐ€ ๋ฉ๋‹ˆ๋‹ค. ๋งํฌ๊ฐ€ ์—†๋Š” ๋…ธํŠธ๋Š” ๋ฒ„๊ทธ์ž…๋‹ˆ๋‹ค.

๋ณผํŠธ ์šฐ์„  ๋ฉ”๋ชจ๋ฆฌ๋Š” ์„ธ์…˜๊ณผ ๊ธฐ๊ธฐ ๊ฐ„์— ์ปจํ…์ŠคํŠธ๋ฅผ ์œ ์ง€ํ•ฉ๋‹ˆ๋‹ค. ๋ชจ๋“  ์ง€์† ์ง€์‹์€ brain/ ํ† ํ”ฝ ๋…ธํŠธ์— ์žˆ์Šต๋‹ˆ๋‹ค(git ์ถ”์ , Obsidian ๋ธŒ๋ผ์šฐ์ € ๊ฐ€๋Šฅ, ๋งํฌ๋จ). Claude Code์˜ MEMORY.md(~/.claude/)๋Š” ๋ณผํŠธ ์œ„์น˜๋ฅผ ๊ฐ€๋ฆฌํ‚ค๋Š” ์ž๋™ ๋กœ๋“œ ์ธ๋ฑ์Šค์ผ ๋ฟ โ€” ์ €์žฅ์†Œ ์ž์ฒด๊ฐ€ ์•„๋‹™๋‹ˆ๋‹ค. ์ฆ‰, ๋ฉ”๋ชจ๋ฆฌ๊ฐ€ ๊ธฐ๊ธฐ ๋ณ€๊ฒฝ์—๋„ ์œ ์ง€๋˜๋ฉฐ ๊ทธ๋ž˜ํ”„์˜ ์ผ๋ถ€๊ฐ€ ๋ฉ๋‹ˆ๋‹ค.

์„ธ์…˜์€ ์„ค๊ณ„๋œ ์ƒ๋ช…์ฃผ๊ธฐ๋ฅผ ๋”ฐ๋ฆ…๋‹ˆ๋‹ค. SessionStart ํ›…์ด North Star ๋ชฉํ‘œ, ํ™œ์„ฑ ํ”„๋กœ์ ํŠธ, ์ตœ๊ทผ ๋ณ€๊ฒฝ์‚ฌํ•ญ, ๋ฏธ์™„๋ฃŒ ์ž‘์—…, ์ „์ฒด ๋ณผํŠธ ํŒŒ์ผ ๋ชฉ๋ก, ๋ณผํŠธ ์œ„์ƒ ํ”Œ๋ž˜๊ทธ๋ฅผ ์ž๋™ ์ฃผ์ž…ํ•ฉ๋‹ˆ๋‹ค โ€” Claude๋Š” ๋นˆ ์ƒํƒœ๊ฐ€ ์•„๋‹ˆ๋ผ ์ปจํ…์ŠคํŠธ๊ฐ€ ์žˆ๋Š” ์ƒํƒœ๋กœ ๋ชจ๋“  ์„ธ์…˜์„ ์‹œ์ž‘ํ•ฉ๋‹ˆ๋‹ค. ๋งˆ๋ฌด๋ฆฌํ•  ๋•Œ "wrap up"์ด๋ผ๊ณ  ๋งํ•˜๋ฉด Claude๊ฐ€ /om-wrap-up์„ ์‹คํ–‰ํ•ฉ๋‹ˆ๋‹ค โ€” ๋…ธํŠธ ๊ฒ€์ฆ, ์ธ๋ฑ์Šค ์—…๋ฐ์ดํŠธ, ๋ˆ„๋ฝ๋œ ์„ฑ๊ณผ ๋ฐœ๊ฒฌ. CLAUDE.md๊ฐ€ ๊ทธ ์‚ฌ์ด์˜ ๋ชจ๋“  ๊ฒƒ์„ ๊ด€๋ฆฌํ•ฉ๋‹ˆ๋‹ค: ํŒŒ์ผ ๋ฐฐ์น˜ ์œ„์น˜, ๋งํฌ ๋ฐฉ๋ฒ•, ๋…ธํŠธ๋ฅผ ๋ถ„ํ• ํ•ด์•ผ ํ•  ๋•Œ, ์˜์‚ฌ๊ฒฐ์ •๊ณผ ์ธ์‹œ๋˜ํŠธ ์ฒ˜๋ฆฌ ๋ฐฉ๋ฒ•.

๐Ÿ”— ํ›…

๋‹ค์„ฏ ๊ฐœ์˜ ์ƒ๋ช…์ฃผ๊ธฐ ํ›…์ด ๋ผ์šฐํŒ…์„ ์ž๋™์œผ๋กœ ์ฒ˜๋ฆฌํ•ฉ๋‹ˆ๋‹ค:

ํ›… ์‹œ์  ๋™์ž‘
๐Ÿš€ SessionStart ์‹œ์ž‘/์žฌ๊ฐœ ์‹œ QMD ์žฌ์ธ๋ฑ์‹ฑ๏ผ‹์…€ํ”„ํž, North Star ํฌ์ปค์Šคยทํ™œ์„ฑ ์ž‘์—…ยท์ตœ๊ทผ ๋ณ€๊ฒฝ์‚ฌํ•ญยท์ž‘์—…ยทํŒŒ์ผ ๋ชฉ๋กยท๋ณผํŠธ ์œ„์ƒ ํ”Œ๋ž˜๊ทธ ์ฃผ์ž… โ€” ์ „์ฒด๋Š” Claude Code์˜ ํ›… ์ถœ๋ ฅ ์ƒํ•œ์— ๋งž๋Š” ๋ฐ”์ดํŠธ ์˜ˆ์‚ฐ์œผ๋กœ ์ œํ•œ๋˜๊ณ , ๋งˆ์ง€๋ง‰ ์ค„์€ ์ฃผ์ž… ํฌ๊ธฐ ๋ฏธํ„ฐ
๐Ÿ’ฌ UserPromptSubmit ๋งค ๋ฉ”์‹œ์ง€๋งˆ๋‹ค ์ฝ˜ํ…์ธ  ๋ถ„๋ฅ˜(์˜์‚ฌ๊ฒฐ์ •, ์ธ์‹œ๋˜ํŠธ, ์„ฑ๊ณผ, 1:1, ์•„ํ‚คํ…์ฒ˜, ์ธ๋ฌผ, ํ”„๋กœ์ ํŠธ ์—…๋ฐ์ดํŠธ) ๋ฐ ๋ผ์šฐํŒ… ํžŒํŠธ ์ฃผ์ž…. ์ด์ „ ํ„ด์˜ Stop ๋ณด๊ณ ์„œ๋„ ์—์ด์ „ํŠธ์—๊ฒŒ ์ „๋‹ฌ
โœ๏ธ PostToolUse .md ์ž‘์„ฑ ํ›„ ํ”„๋ก ํŠธ๋งคํ„ฐ๏ผ‹์œ„ํ‚ค๋งํฌ ๊ฒ€์ฆ, ์ž˜๋ชป ๋ฐฐ์น˜๋œ ๋ฉ”๋ชจ๋ฆฌ ํŒŒ์ผ ์ฐจ๋‹จ, ๋น„๋Œ€ ๋…ธํŠธ(์ค„์ด์ง€ ๋ง๊ณ  ๋ถ„ํ• )์™€ ์ž‘์„ฑ ์‹œ์  ํ† ํ”ฝ ํด๋Ÿฌ์Šคํ„ฐ ํ”Œ๋ž˜๊ทธ
๐Ÿ’พ PreCompact ์ปจํ…์ŠคํŠธ ์••์ถ• ์ „ ์„ธ์…˜ ํŠธ๋žœ์Šคํฌ๋ฆฝํŠธ๋ฅผ thinking/session-logs/์— ๋ฐฑ์—…
๐Ÿ Stop ๊ฐ ์‘๋‹ต ์ข…๋ฃŒ ์‹œ ์ฒดํฌ๋ฆฌ์ŠคํŠธ๏ผ‹๊ตฌ์ฒด์ ์ธ ๋“œ๋ฆฌํ”„ํŠธ ๋ฐœ๊ฒฌ (SessionStart์™€ ๋™์ผํ•œ ์œ„์ƒ ์Šค์บ”). ์„ธ์…˜๋‹น ํ•œ ๋ฒˆ, ๋‚ด์šฉ์ด ๋ฐ”๋€” ๋•Œ๋งŒ ๋‹ค์‹œ ํ‘œ์‹œ. ์‚ฌ์šฉ์ž์—๊ฒŒ๋Š” ์„น์…˜๋ณ„ ํ•œ ์ค„ ์š”์•ฝ์ด, ์—์ด์ „ํŠธ์—๊ฒŒ๋Š” ๋‹ค์Œ ๋ฉ”์‹œ์ง€์™€ ํ•จ๊ป˜ ์ „์ฒด ๋ณด๊ณ ์„œ๊ฐ€ ์ „๋‹ฌ๋˜๋ฉฐ ์กฐ์น˜ ์—ฌ๋ถ€๋Š” ์—์ด์ „ํŠธ๊ฐ€ ํŒ๋‹จ. ์กฐ์น˜๋Š” om-tidy๋กœ

[!TIP] ๊ทธ๋ƒฅ ์ด์•ผ๊ธฐํ•˜์„ธ์š”. ํ›…์ด ๋ผ์šฐํŒ…์„ ์ฒ˜๋ฆฌํ•ฉ๋‹ˆ๋‹ค.

๐Ÿงฉ Claude Code mod

Claude Code 2.1.287 ์ด์ƒ์—์„œ๋Š” ๋ณผํŠธ๊ฐ€ mod๋„ ํ•จ๊ป˜ ์ œ๊ณตํ•ฉ๋‹ˆ๋‹ค. .claude/skills/obsidian-mind/์— ์žˆ๋Š”, Claude Code ์•ˆ์—์„œ ์‹คํ–‰๋˜๋Š” ํ”Œ๋Ÿฌ๊ทธ์ธ์ž…๋‹ˆ๋‹ค. ๋ณผํŠธ ์ž์ฒด์˜ ํ›… ์Šคํฌ๋ฆฝํŠธ๋ฅผ ์‹คํ–‰ํ•˜๊ณ , ๊ทธ ์ถœ๋ ฅ์ด ์„ธ์…˜์— ์ „๋‹ฌ๋˜๋Š” ๊ฒฝ๋กœ๋งŒ ๋ฐ”๊ฟ‰๋‹ˆ๋‹ค.

  • ์„ธ์…˜ ์ปจํ…์ŠคํŠธ๊ฐ€ CLAUDE.md์ฒ˜๋Ÿผ instruction ํŒŒ์ผ๋กœ ์ „๋‹ฌ๋ฉ๋‹ˆ๋‹ค. ์ปดํŒฉ์…˜๊ณผ /clear ํ›„์—๋„ ์ „์ฒด๊ฐ€ ๋‹ค์‹œ ์ฝํžˆ๊ณ (ํ›… ์ถœ๋ ฅ์€ ํฌ์ธํ„ฐ๋กœ ์ค„์–ด๋“ญ๋‹ˆ๋‹ค), ๋ฒ”์šฉ ์„œ๋ธŒ์—์ด์ „ํŠธ์—๋„ ์ „๋‹ฌ๋˜๋ฉฐ(ํ›… ์ถœ๋ ฅ์€ ์ „๋‹ฌ๋˜์ง€ ์•Š์Šต๋‹ˆ๋‹ค), Claude Code ํ›… ์ถœ๋ ฅ์˜ 10,000์ž ์ œํ•œ์— ์ž˜๋ฆฌ์ง€ ์•Š์Šต๋‹ˆ๋‹ค. ์˜ˆ์‚ฐ์€ vault-manifest.json์˜ eager_layer_instruction_budget_bytes์ด๋ฉฐ, ์—ด๋ฆฐ ์ž‘์—…์ฒ˜๋Ÿผ ์ค„์–ด๋“ค์ง€ ์•Š๋Š” ์„น์…˜์€ ์ด๋ฅผ ๋„˜์„ ์ˆ˜ ์žˆ์Šต๋‹ˆ๋‹ค. /memory์—๋Š” .claude/session-context.md๋กœ ํ‘œ์‹œ๋ฉ๋‹ˆ๋‹ค.
  • Stop ๋ณด๊ณ ์„œ๊ฐ€ ๋‹ต๋ณ€ ์•„๋ž˜์˜ ํ•œ ์ค„์ด ๋ฉ๋‹ˆ๋‹ค. ๋ฐœ๊ฒฌ ์‚ฌํ•ญ์ด ๋ฐ”๋€Œ๋ฉด Claude์˜ ๋‹ต๋ณ€ ์•„๋ž˜์— mod ์ด๋ฆ„์œผ๋กœ ์‹œ์ž‘ํ•˜๋Š” ์ค„ obsidian-mind: vault check: โ€ฆ๊ฐ€ ํ‘œ์‹œ๋ฉ๋‹ˆ๋‹ค. Claude Code๋Š” Stop์—์„œ ์‘๋‹ตํ•œ ํ”Œ๋Ÿฌ๊ทธ์ธ์˜ ์ด๋ฆ„์„ +๋กœ ์ด์–ด ๋ถ™์ด๋ฏ€๋กœ, ๋‹ค๋ฅธ ํ”Œ๋Ÿฌ๊ทธ์ธ๋„ ์‘๋‹ตํ•˜๋ฉด obsidian-mind+<ํ”Œ๋Ÿฌ๊ทธ์ธ>: vault check: โ€ฆ์ฒ˜๋Ÿผ ํ‘œ์‹œ๋ฉ๋‹ˆ๋‹ค. Claude๋Š” ์ „์ฒด ๋ณด๊ณ ์„œ๋ฅผ ๋‹ค์Œ ๋ฉ”์‹œ์ง€์™€ ํ•จ๊ป˜ ๋ณด์ด์ง€ ์•Š๊ฒŒ ๋ฐ›์Šต๋‹ˆ๋‹ค. ๊ธด๊ธ‰์œผ๋กœ ํ‘œ์‹œ๋œ ๋ฐœ๊ฒฌ ์‚ฌํ•ญ์€ ๋Œ€์‹  ์ฆ‰์‹œ Claude์—๊ฒŒ ์ „๋‹ฌ๋ฉ๋‹ˆ๋‹ค(๋ณด๋‚ด๋Š” ๋ฉ”์‹œ์ง€ ํ•˜๋‚˜๋‹น ํ•œ ๋ฒˆ๊นŒ์ง€์ด๋ฉฐ, ๋‘ ๋ฒˆ์งธ๋Š” ๋ณด๊ณ ์„œ ์•ˆ์—์„œ ๊ธฐ๋‹ค๋ฆฝ๋‹ˆ๋‹ค). ํ…œํ”Œ๋ฆฟ ์ž์ฒด์˜ ๋ณด๊ณ ์„œ์—๋Š” ๊ทธ๋Ÿฐ ํ•ญ๋ชฉ์ด ์—†์Šต๋‹ˆ๋‹ค.

mod๋Š” ์ฒ˜๋ฆฌํ•˜๋Š” ์ด๋ฒคํŠธ๋งˆ๋‹ค ํ•ด๋‹น ํ›…์— ๋Œ€๊ธฐํ•˜๋ผ๊ณ  ์•Œ๋ฆฝ๋‹ˆ๋‹ค. mod๊ฐ€ ๋กœ๋“œ๋˜์ง€ ์•Š๋Š” ๊ณณ์—์„œ๋Š” ํ›…์ด ์ด์ „๊ณผ ๋˜‘๊ฐ™์ด ๋™์ž‘ํ•ฉ๋‹ˆ๋‹ค. Codex์™€ Gemini, ์ด์ „ ๋ฒ„์ „์˜ Claude Code, ๋ณผํŠธ ํ•˜์œ„ ํด๋”์—์„œ ์‹œ์ž‘ํ•œ ์„ธ์…˜(๋ณผํŠธ ๋ฃจํŠธ์—์„œ ์‹คํ–‰ํ•˜๊ฑฐ๋‚˜, ๊ทธ๊ณณ์œผ๋กœ /cdํ•œ ๋’ค /clear), ์‹ ๋ขฐํ•˜์ง€ ์•Š์€ ํด๋”์ž…๋‹ˆ๋‹ค. mod๋Š” ๋ณผํŠธ์— ๋Œ€ํ•œ Claude Code์˜ ์‹ ๋ขฐ ํ™•์ธ์„ ์ˆ˜๋ฝํ•œ ๋’ค์—๋งŒ ๋กœ๋“œ๋ฉ๋‹ˆ๋‹ค.

mod๋Š” ์ƒŒ๋“œ๋ฐ•์Šค ์—†์ด ์‚ฌ์šฉ์ž์˜ ๊ถŒํ•œ์œผ๋กœ ์‹คํ–‰๋˜๋Š” ์ฝ”๋“œ์ด๋ฏ€๋กœ, ํด๋”๋ฅผ ์‹ ๋ขฐํ•˜๊ธฐ ์ „์— ๋‚ด์šฉ์„ ํ™•์ธํ•˜์„ธ์š”. claude plugin validate .claude/skills/obsidian-mind๊ฐ€ ํ›…ํ•˜๋Š” ๋ชจ๋“  ์ด๋ฒคํŠธ์™€ ์ˆ˜ํ–‰ํ•˜๋Š” ๋ชจ๋“  ํ˜ธ์ถœ์„ ๋‚˜์—ดํ•ฉ๋‹ˆ๋‹ค(๋ณผํŠธ ์ž์ฒด์˜ ์Šคํฌ๋ฆฝํŠธ๋ฅผ ์‹คํ–‰ํ•˜๊ณ , ์ปจํ…์ŠคํŠธ ํŒŒ์ผ์„ ์“ฐ๊ณ , ๊ฐ ์„ธ์…˜์— ์–ด๋–ค ๋ณด๊ณ ์„œ๋ฅผ ๋ณด์—ฌ ์คฌ๋Š”์ง€ ์ž์ฒด ์ €์žฅ์†Œ์— ๊ธฐ๋กํ•˜๊ณ , ๊ธด๊ธ‰ํ•œ ๋ฐœ๊ฒฌ ์‚ฌํ•ญ์ด ์žˆ์œผ๋ฉด ํ”„๋กฌํ”„ํŠธ๋ฅผ ๋ณด๋‚ด๋Š” ๊ฒƒ์ด ์ „๋ถ€์ž…๋‹ˆ๋‹ค). ๋„๋ ค๋ฉด .claude/settings.local.json์— "enabledPlugins": { "obsidian-mind@skills-dir": false }๋ฅผ ์ถ”๊ฐ€ํ•˜์„ธ์š”.

์ด ๋ฒ„์ „์˜ mod์—์„œ ์ถœ๋ ฅ ์ค‘ ํ™•์ธํ•  ๋‘ ์ค„์€ ๋‹ค์Œ๊ณผ ๊ฐ™์Šต๋‹ˆ๋‹ค:

  โฏ ./register.ts hooks: classic.SessionStart, prompt.context, classic.Stop, turn.complete, prompt.submit, turn.start
  โฏ ./register.ts calls: $.fs.write, $.process.run (via runScript), $.prompt.submit, $.session.root, $.state.get, $.state.set, $.store.get (via setShown, shownFor), $.store.set (via setShown), $.ui.invalidate

โšก ํ† ํฐ ํšจ์œจ์„ฑ

obsidian-mind๋Š” ์ „์ฒด ๋ณผํŠธ๋ฅผ ์ปจํ…์ŠคํŠธ์— ๋กœ๋“œํ•˜์ง€ ์•Š์Šต๋‹ˆ๋‹ค. ๊ณ„์ธตํ˜• ๋กœ๋”ฉ์œผ๋กœ ํ† ํฐ ๋น„์šฉ์„ ์ตœ์†Œํ™”ํ•ฉ๋‹ˆ๋‹ค:

๊ณ„์ธต ๋‚ด์šฉ ์‹œ์  ๋น„์šฉ
ํ•ญ์ƒ CLAUDE.md + SessionStart ์ปจํ…์ŠคํŠธ (North Star ๋ฐœ์ทŒ, git ์š”์•ฝ, ์ž‘์—…, ๋ณผํŠธ ํŒŒ์ผ ๋ชฉ๋ก) ์„ธ์…˜ ์‹œ์ž‘ ์‹œ ๋งค๋‹ˆํŽ˜์ŠคํŠธ ์˜ˆ์‚ฐ์ด ์ƒํ•œ (์˜ˆ์‚ฐ ์ž์ฒด๋„ Claude Code์˜ 10,000์ž ํ›… ์ถœ๋ ฅ ์ƒํ•œ ์•ˆ์œผ๋กœ ์ œํ•œ๋จ). ์‹ค์ œ ํฌ๊ธฐ๋Š” ๋งค ์„ธ์…˜ ๋งˆ์ง€๋ง‰ ์ค„์˜ ๋ฏธํ„ฐ๊ฐ€ ๋ณด๊ณ 
์˜จ๋””๋งจ๋“œ QMD ์‹œ๋งจํ‹ฑ ๊ฒ€์ƒ‰ ๊ฒฐ๊ณผ ์—์ด์ „ํŠธ๊ฐ€ ํŠน์ • ์ปจํ…์ŠคํŠธ ํ•„์š” ์‹œ ๋Œ€์ƒ๋งŒ
ํŠธ๋ฆฌ๊ฑฐ ๋ถ„๋ฅ˜ ๋ผ์šฐํŒ… ํžŒํŠธ ๋งค ๋ฉ”์‹œ์ง€ ~100 ํ† ํฐ
ํŠธ๋ฆฌ๊ฑฐ PostToolUse ๊ฒ€์ฆ .md ์ž‘์„ฑ ํ›„ ~200 ํ† ํฐ
๋“œ๋ฌผ๊ฒŒ ์ „์ฒด ํŒŒ์ผ ์ฝ๊ธฐ ๋ช…์‹œ์ ์œผ๋กœ ํ•„์š”ํ•œ ๊ฒฝ์šฐ๋งŒ ๊ฐ€๋ณ€

SessionStart๋Š” ๊ฐ€๋ฒผ์šด ์ปจํ…์ŠคํŠธ๋ฅผ ๋กœ๋“œํ•ฉ๋‹ˆ๋‹ค โ€” ์ฃผ์š” ํŒŒ์ผ์˜ ์งง์€ ๋ฐœ์ทŒ, ํŒŒ์ผ๋ช…, git ์š”์•ฝ๋งŒ ๋กœ๋“œํ•˜๋ฉฐ ์ „์ฒด ๋…ธํŠธ ๋‚ด์šฉ์€ ์ฝ์ง€ ์•Š์Šต๋‹ˆ๋‹ค. ์—์ด์ „ํŠธ๋Š” QMD๋ฅผ ํ†ตํ•ด ์˜๋ฏธ ๊ธฐ๋ฐ˜ ๊ฒ€์ƒ‰ ํ›„ ํŒŒ์ผ์„ ์ฝ์œผ๋ฏ€๋กœ ๊ด€๋ จ ์ •๋ณด๋งŒ ๊ฐ€์ ธ์˜ต๋‹ˆ๋‹ค. ๋ถ„๋ฅ˜ ํ›…์€ ๋ฉ”์‹œ์ง€๋‹น ๊ฐ€๋ฒผ์šด Node ํ˜ธ์ถœ 1ํšŒ์ž…๋‹ˆ๋‹ค. ๊ฒ€์ฆ ํ›…์€ ๋งˆํฌ๋‹ค์šด ์“ฐ๊ธฐ ์‹œ์—๋งŒ ์‹คํ–‰๋˜๋ฉฐ ์ œ์™ธ๋œ ๊ฒฝ๋กœ๋Š” ๊ฑด๋„ˆ๋œ๋‹ˆ๋‹ค. ๋ณผํŠธ๊ฐ€ ์ปค์ ธ๋„ ์ฃผ์ž… ๊ณ„์ธต์„ ์ •์งํ•˜๊ฒŒ ์œ ์ง€ํ•˜๋Š” ๋‹ค์„ฏ ๊ฐ€์ง€ ๋ฉ”์ปค๋‹ˆ์ฆ˜: ์†Œ์Šค ์ธ์‹ ์ฃผ์ž… (resume/compact ์‹œ ํœ˜๋ฐœ์„ฑ ์„น์…˜๋งŒ ์žฌ์ฃผ์ž… โ€” ์ •์ ์ธ ๋Œ€๋ถ€๋ถ„์€ ์ด๋ฏธ ๋Œ€ํ™”์— ์žˆ์Œ), ๋ชจ๋“  ์ฃผ์ž…์˜ ๋งˆ์ง€๋ง‰ ์ค„์— ๋ถ™๋Š” ์ฃผ์ž… ํฌ๊ธฐ ๋ฏธํ„ฐ, ๋ฏธํ„ฐ๊ฐ€ ์ธก์ •ํ•œ ๊ฐ’์„ ์‹ค์ œ๋กœ ๊ฐ•์ œํ•˜๋Š” ์ฃผ์ž… ์˜ˆ์‚ฐ (์ƒํ•œ์„ ๋„˜์œผ๋ฉด ์žƒ์–ด๋„ ๋˜๋Š” ์„น์…˜๋ถ€ํ„ฐ ํฌ์ธํ„ฐ๋กœ ์ถ•์†Œ๋˜๊ณ , ์ถ•์†Œ๋œ ์„น์…˜ ์ด๋ฆ„์€ ๋ฏธํ„ฐ์— ๋ฐ˜๋“œ์‹œ ํ‘œ์‹œ๋จ โ€” ์กฐ์šฉํ•œ ์†์‹ค์ด ๋น„๋Œ€ํ™”๋ณด๋‹ค ๋‚˜์˜๊ธฐ ๋•Œ๋ฌธ), ์“ฐ๊ธฐ๋‹น ํ›… ํ”„๋กœ์„ธ์Šค 1ํšŒ (QMD ๋ฆฌํ”„๋ ˆ์‹œ๊ฐ€ ๊ฒ€์ฆ ํ›…์— ๋™์Šน), ๋ชฉ๋ก ์ ‘๊ธฐ (๋…ธํŠธ ์ˆ˜ ์ž„๊ณ„๊ฐ’์„ ๋„˜๋Š” ํด๋”๋Š” ํ•œ ์ค„ ์นด์šดํŠธ๋กœ ์ ‘ํžˆ๋ฏ€๋กœ, ์•„๋ฌด๋„ ์„ค์ •ํ•˜์ง€ ์•Š์€ ํด๋”๋ฅผ ํ†ตํ•ด ๋ณผํŠธ๊ฐ€ ์ƒํ•œ์„ ๋„˜์–ด ์ž๋ž„ ์ˆ˜ ์—†์Œ). ์˜ˆ์‚ฐ๊ณผ ์ž„๊ณ„๊ฐ’ ๋ชจ๋‘ vault-manifest.json ์—์„œ ์กฐ์ •ํ•  ์ˆ˜ ์žˆ์œผ๋ฉฐ, ์˜ˆ์‚ฐ์€ ์„ค์ •๊ฐ’๊ณผ ๊ด€๊ณ„์—†์ด Claude Code์˜ 10,000์ž ํ›… ์ถœ๋ ฅ ์ƒํ•œ ์•ˆ์œผ๋กœ ์ œํ•œ๋ฉ๋‹ˆ๋‹ค. ์ƒํ•œ์„ ๋„˜์œผ๋ฉด ์„ธ์…˜์—๋Š” 2,000์ž ๋ฏธ๋ฆฌ๋ณด๊ธฐ๋งŒ ์ „๋‹ฌ๋˜๊ธฐ ๋•Œ๋ฌธ์ž…๋‹ˆ๋‹ค.

๐ŸŒ ๋‹ค๋ฅธ ์—์ด์ „ํŠธ์™€ ์‚ฌ์šฉํ•˜๊ธฐ

obsidian-mind๋Š” Claude Code, Codex CLI, Gemini CLI์—์„œ ์ž‘๋™ํ•ฉ๋‹ˆ๋‹ค. CLAUDE.md์˜ ๋ณผํŠธ ๊ทœ์•ฝ, .claude/scripts/์˜ ํ›… ์Šคํฌ๋ฆฝํŠธ, .claude/commands/์˜ ์ปค๋งจ๋“œ๋Š” ๋ชจ๋‘ ์—์ด์ „ํŠธ ๋น„์˜์กด์ ์ž…๋‹ˆ๋‹ค โ€” ์ˆœ์ˆ˜ Markdown, TypeScript, ์…ธ์ด๋ฉฐ SDK ์˜์กด์„ฑ์ด ์—†์Šต๋‹ˆ๋‹ค.

Claude Code โ€” ์™„์ „ ์ง€์›. ํ›…, ์ปค๋งจ๋“œ, ์„œ๋ธŒ์—์ด์ „ํŠธ, ๋ฉ”๋ชจ๋ฆฌ ์‹œ์Šคํ…œ์ด ๋ชจ๋‘ ๊ธฐ๋ณธ์œผ๋กœ ์ž‘๋™ํ•ฉ๋‹ˆ๋‹ค.

Codex CLI โ€” AGENTS.md๋ฅผ ๋„ค์ดํ‹ฐ๋ธŒ๋กœ ์ฝ์Šต๋‹ˆ๋‹ค. .codex/hooks.json์˜ ํ›… ์„ค์ •์ด Claude Code์™€ ๋™์ผํ•œ ํ›… ์Šคํฌ๋ฆฝํŠธ๋ฅผ ์—ฐ๊ฒฐํ•ฉ๋‹ˆ๋‹ค โ€” ์„ธ์…˜ ์ปจํ…์ŠคํŠธ, ๋ฉ”์‹œ์ง€ ๋ถ„๋ฅ˜, ์“ฐ๊ธฐ ๊ฒ€์ฆ์ด ์ž๋™์œผ๋กœ ์ž‘๋™ํ•ฉ๋‹ˆ๋‹ค.

Codex๊ฐ€ ํ”„๋กœ์ ํŠธ์˜ ํ›…์„ ์‹คํ–‰ํ•˜๋ ค๋ฉด ๋‘ ๊ฐ€์ง€ ์‹ ๋ขฐ๊ฐ€ ํ•„์š”ํ•ฉ๋‹ˆ๋‹ค(Codex CLI 0.160.0์œผ๋กœ ํ™•์ธ, 2026-10-13 ๊ธฐ์ค€, #345).

  • ๋ณผํŠธ ํด๋”๊ฐ€ ์‹ ๋ขฐ๋˜์–ด ์žˆ์–ด์•ผ ํ•ฉ๋‹ˆ๋‹ค. Codex๋Š” ์ด๋ฅผ ~/.codex/config.toml์˜ [projects.'<path>']์— ๊ธฐ๋กํ•ฉ๋‹ˆ๋‹ค. Windows์—์„œ๋Š” ํ‚ค๊ฐ€ \\?\ ์ ‘๋‘์‚ฌ๊ฐ€ ๋ถ™์€ ๊ฒฝ๋กœ์ž…๋‹ˆ๋‹ค(์˜ˆ: [projects.'\\?\C:\path\to\vault']).
  • ๊ฐ ํ›…์ด ์Šน์ธ๋˜์–ด ์žˆ์–ด์•ผ ํ•ฉ๋‹ˆ๋‹ค. Codex๋Š” ๊ฐ ์Šน์ธ์„ [hooks.state] ์•„๋ž˜ trusted_hash๋กœ ์ €์žฅํ•ฉ๋‹ˆ๋‹ค. ๋Œ€ํ™”ํ˜• codex ์„ธ์…˜์—์„œ ์Šน์ธํ•˜๋ฉด ์ด๊ฒƒ์ด ๊ธฐ๋ก๋  ๊ฒƒ์œผ๋กœ ์˜ˆ์ƒ๋ฉ๋‹ˆ๋‹ค(์ถ”์ •: #345์˜ ํ™•์ธ์—์„œ๋Š” ํ•œ ๋ฒˆ์˜ ๋น„๋Œ€ํ™”ํ˜• ์‹คํ–‰์šฉ ํ”Œ๋ž˜๊ทธ --dangerously-bypass-hook-trust๋กœ ๋Œ€์‹ ํ–ˆ์Šต๋‹ˆ๋‹ค).

๋‘˜ ๋‹ค ๊ฐ–์ถฐ์ง€๊ธฐ ์ „์—๋Š” Codex๊ฐ€ ์–ด๋–ค ํ›…๋„ ์‹คํ–‰ํ•˜์ง€ ์•Š์œผ๋ฉฐ, ์„ธ์…˜์— ๋ณผํŠธ ์ปจํ…์ŠคํŠธ๊ฐ€ ์ „๋‹ฌ๋˜์ง€ ์•Š์Šต๋‹ˆ๋‹ค.

Gemini CLI โ€” GEMINI.md๋ฅผ ๋„ค์ดํ‹ฐ๋ธŒ๋กœ ์ฝ์Šต๋‹ˆ๋‹ค. .gemini/settings.json์˜ ํ›… ์„ค์ •์ด Gemini์˜ ์ด๋ฒคํŠธ ์ด๋ฆ„์„ ๊ณต์œ  ํ›… ์Šคํฌ๋ฆฝํŠธ์— ๋งคํ•‘ํ•ฉ๋‹ˆ๋‹ค.

๊ธฐํƒ€ ์—์ด์ „ํŠธ (Cursor, Windsurf, GitHub Copilot, JetBrains AI) โ€” AGENTS.md๋กœ ๋ณผํŠธ ๊ทœ์•ฝ์„ ์ฝ์Šต๋‹ˆ๋‹ค. ํ›… ์ง€์›์€ ์—์ด์ „ํŠธ๋งˆ๋‹ค ๋‹ค๋ฆ…๋‹ˆ๋‹ค.

[!NOTE] ํ›…, ์ปค๋งจ๋“œ, ์„œ๋ธŒ์—์ด์ „ํŠธ ํ”„๋กฌํ”„ํŠธ, ๋ณผํŠธ ๋ฉ”๋ชจ๋ฆฌ(brain/)๋Š” ๋ชจ๋‘ ์—์ด์ „ํŠธ ๋น„์˜์กด์ ์ž…๋‹ˆ๋‹ค. ~/.claude/ ์ž๋™ ๋ฉ”๋ชจ๋ฆฌ ๋กœ๋”๋งŒ Claude Code ์ „์šฉ์ž…๋‹ˆ๋‹ค. ์ž์„ธํ•œ ๋‚ด์šฉ์€ AGENTS.md๋ฅผ ์ฐธ์กฐํ•˜์„ธ์š”.


๐Ÿง  ์–ด๋–ค ์ €์žฅ์†Œ์—์„œ๋“  ๋ณผํŠธ์— ์ ‘๊ทผํ•˜๊ธฐ

๋ณผํŠธ๋Š” ๋ณดํ†ต ๊ทธ ์•ˆ์—์„œ ์ž‘์—…ํ•  ๋•Œ๋งŒ ๋„์›€์ด ๋ฉ๋‹ˆ๋‹ค. om MCP ์„œ๋ฒ„๊ฐ€ ์ด๋ฅผ ๋ฐ”๊ฟ‰๋‹ˆ๋‹ค. ๋‹ค๋ฅธ ์–ด๋–ค ์ €์žฅ์†Œ์˜ ์ฝ”๋”ฉ ์„ธ์…˜์ด๋“  ๋…ธํŠธ๋ฅผ ๊ฒ€์ƒ‰ํ•˜๊ณ , ์ฝ๊ณ , ๊ทธ๋ž˜ํ”„๋ฅผ ๋”ฐ๋ผ๊ฐ€๊ณ , ๋ฐฐ์šด ๊ฒƒ์„ ๋ณผํŠธ์— ๋‹ค์‹œ ๊ธฐ๋กํ•  ์ˆ˜ ์žˆ์Šต๋‹ˆ๋‹ค.

{
  "mcpServers": {
    "om": {
      "command": "node",
      "args": ["/path/to/your-vault/.claude/scripts/om-mcp.mjs"]
    }
  }
}

์ด๊ฒƒ์€ ์‚ฌ์šฉํ•˜๋Š” ํ”„๋กœ์ ํŠธ์˜ .mcp.json์— ๋“ค์–ด๊ฐ‘๋‹ˆ๋‹ค. ๊ทธ๋Ÿฐ ๋‹ค์Œ ํ•ด๋‹น ํ”„๋กœ์ ํŠธ ์ž์ฒด์˜ CLAUDE.md์— ๋ณผํŠธ๋ฅผ ๊ฐ€๋ฆฌํ‚ค๋Š” ์งง์€ ์„น์…˜์„ ์ถ”๊ฐ€ํ•˜์„ธ์š”.

[!IMPORTANT] ๋‘ ๋‹จ๊ณ„ ๋ชจ๋‘ ํ•„์ˆ˜์ด๋ฉฐ, ๋‘ ๋ฒˆ์งธ๋Š” ํ˜•์‹์ ์ธ ์ ˆ์ฐจ๊ฐ€ ์•„๋‹™๋‹ˆ๋‹ค. ์ธก์ • ๊ฒฐ๊ณผ: ์„œ๋ฒ„๊ฐ€ ์—ฐ๊ฒฐ๋˜์–ด ์žˆ์–ด๋„ ์ €์žฅ์†Œ ์ธก ์ง€์นจ์ด ์—†์œผ๋ฉด ์„ธ์…˜์€ ๋ณผํŠธ๋ฅผ ํ•œ ๋ฒˆ๋„ ํ˜ธ์ถœํ•˜์ง€ ์•Š์•˜๊ณ , ๋ณผํŠธ๊ฐ€ ๋ช…์‹œ์ ์œผ๋กœ ๊ฑฐ๋ถ€ํ–ˆ๋‹ค๊ณ  ๊ธฐ๋กํ•œ ์„ค๊ณ„๋ฅผ ๊ทธ๋Œ€๋กœ ๊ตฌํ˜„ํ–ˆ์Šต๋‹ˆ๋‹ค. ์ง€์นจ์ด ์žˆ์„ ๋•Œ๋Š” ๊ตฌํ˜„์„ ๊ฑฐ๋ถ€ํ•˜๊ณ  ํ•ด๋‹น ๋…ธํŠธ๋ฅผ ์ธ์šฉํ–ˆ์Šต๋‹ˆ๋‹ค.

MCP instructions ํ•„๋“œ์˜ ๊ธˆ์ง€ ์‚ฌํ•ญ์€ ํ˜ธ์ถœํ•˜๋Š” ์„ธ์…˜์œผ๋กœ ํ™•์‹คํžˆ ์ „ํŒŒ๋ฉ๋‹ˆ๋‹ค. ๋ฐ˜๋ฉด "๋ณผํŠธ๋ฅผ ์ฐธ์กฐํ•˜๋ผ"๋Š” ๊ธ์ •ํ˜• ์ง€์‹œ๋Š” ๊ถŒ๊ณ ์ ์ด๋ฉฐ, ๋” ๊ฐ€๊นŒ์šด ์ •๋ณด์›์ด ์žˆ์œผ๋ฉด ๊ฑด๋„ˆ๋œ๋‹ˆ๋‹ค. ์„œ๋ฒ„๋Š” ์„ธ์…˜์„ ๋ฉˆ์ถœ ์ˆ˜๋Š” ์žˆ์ง€๋งŒ, ์„ธ์…˜์ด ์ฐพ์•„๋ณด๊ฒŒ ๋งŒ๋“œ๋Š” ๊ฒƒ์€ ๊ทธ ํ”„๋กœ์ ํŠธ ์ž์ฒด์˜ ๊ทœ์•ฝ๋ฟ์ž…๋‹ˆ๋‹ค.

์„ธ์…˜์ด ์–ป๋Š” ๊ฒƒ: search(์‹œ๋งจํ‹ฑ + ํ‚ค์›Œ๋“œ), expand(๋…ธํŠธ์˜ ๋งํฌ์™€ ๋ฐฑ๋งํฌ), recall(ํ•ด๋‹น ์ €์žฅ์†Œ๋กœ ์Šค์ฝ”ํ”„๋œ ์ง€์†์  ๊ตํ›ˆ), remember(๊ตํ›ˆ ๊ธฐ๋ก), record_work(์ž‘์—… ๋‚ด์šฉ ๊ธฐ๋ก), reason(์—ฌ๋Ÿฌ ๋…ธํŠธ์— ๊ฑธ์นœ ํŒ๋‹จ), health(๋ฐฐ์„ ์ด ์ •์ƒ์ธ์ง€). ์—ฌ๊ธฐ์— ๋…ธํŠธ๋ฅผ ์ฝ์„ ์ˆ˜ ์žˆ๋Š” ๋ฆฌ์†Œ์Šค๋กœ ์ œ๊ณตํ•ฉ๋‹ˆ๋‹ค.

์ƒ๊ฐํ•˜๋Š” ๊ฒƒ์€ reason ํ•˜๋‚˜์ž…๋‹ˆ๋‹ค. ๋‚˜๋จธ์ง€๊ฐ€ ๊ฒ€์ƒ‰์ด๋ผ๋ฉด, ์ด๊ฒƒ์€ ๋‘ ๋ฒˆ์งธ Claude ์„ธ์…˜์œผ๋กœ ๋ณผํŠธ๋ฅผ ์ฝ๊ณ  ๋…ธํŠธ๋ฅผ ๊ฐ€๋กœ์ง€๋ฅด๋Š” ํŒ๋‹จ์ด ํ•„์š”ํ•œ ์งˆ๋ฌธ์— ๋‹ตํ•ฉ๋‹ˆ๋‹ค โ€” ์ง€๊ธˆ ํ•˜๋ ค๋Š” ์ผ์ด ์ด ์—ฌ์„ฏ ๊ฐœ์˜ ๋…ธํŠธ๊ฐ€ ๊ฒฐ์ •ํ•œ ๋ฐ”์™€ ์ผ์น˜ํ•˜๋Š”๊ฐ€? ์Šค์Šค๋กœ ๋จผ์ € ๊ฒ€์ƒ‰์„ ์ˆ˜ํ–‰ํ•˜๋ฏ€๋กœ ๋จผ์ € ๊ฒ€์ƒ‰ํ•  ํ•„์š”๊ฐ€ ์—†์Šต๋‹ˆ๋‹ค. ๋‹น์‹  ๋ณธ์ธ์˜ CLI ๊ธฐ๋ณธ ๋ชจ๋ธ๋กœ ๋™์ž‘ํ•˜๋ฏ€๋กœ, ๋ณผํŠธ๋Š” ์ง€๊ธˆ ์ž‘์—… ์ค‘์ธ ์ˆ˜์ค€๊ณผ ๊ฐ™์€ ์ˆ˜์ค€์œผ๋กœ ๋‹ตํ•ฉ๋‹ˆ๋‹ค. ๊ทธ๋ฆฌ๊ณ  ์–ด๋–ค ์ƒํ•œ๋„ ์—†์Šต๋‹ˆ๋‹ค โ€” ๋‹น์‹ ์˜ ๊ธฐ๊ธฐ์—์„œ, ๋‹น์‹ ์˜ ์ธ์ฆ์œผ๋กœ ๋Œ์•„๊ฐ€๋Š” Claude์ด๊ธฐ ๋•Œ๋ฌธ์ž…๋‹ˆ๋‹ค. ํ˜ธ์ถœ๋งˆ๋‹ค ๋น„์šฉยทํ„ด ์ˆ˜ยท๋ชจ๋ธยท์‹ค์ œ ์†Œ์š” ์‹œ๊ฐ„์ด ๊ธฐ๋ก๋ฉ๋‹ˆ๋‹ค. ๋‹ต๋ณ€์—๋Š” confidence: inferred๊ฐ€ ๋ถ™๊ณ  ๊ทธ ์ž์ฒด๋กœ ๋ฉ”๋ชจ๋ฆฌ์— ๊ธฐ๋ก๋˜์ง€ ์•Š์Šต๋‹ˆ๋‹ค โ€” ๋‚จ๊ธธ ๊ฐ€์น˜๊ฐ€ ์žˆ๋Š”์ง€๋Š” ๋‹น์‹ ์˜ ์„ธ์…˜์ด ์ •ํ•ฉ๋‹ˆ๋‹ค.

์ €์žฅ์†Œ๋Š” ํด๋” ์ด๋ฆ„์œผ๋กœ ์‹๋ณ„๋ฉ๋‹ˆ๋‹ค. ๋Œ€๊ฐœ๋Š” ๋งž์ง€๋งŒ ๊ฐ€๋” ํ‹€๋ฆฝ๋‹ˆ๋‹ค: api๋ผ๋Š” ์ด๋ฆ„์˜ ์ €์žฅ์†Œ๊ฐ€ ๋‘˜์ด๋ฉด ํ•˜๋‚˜์˜ ์ •์ฒด์„ฑ์„ ๊ณต์œ ํ•ด ์„œ๋กœ์˜ ๋ฉ”๋ชจ๋ฆฌ๋ฅผ ๋ฐ›๊ฒŒ ๋ฉ๋‹ˆ๋‹ค. ์ €์žฅ์†Œ ๋ฃจํŠธ์— .om-project ํŒŒ์ผ์„ ๋‘๊ณ  ๋‹ค๋ฅธ ์ด๋ฆ„์„ ์ ์œผ๋ฉด ๋ถ„๋ฆฌ๋ฉ๋‹ˆ๋‹ค. health๊ฐ€ ์–ด๋А ์ €์žฅ์†Œ๋กœ ์ธ์‹ํ•˜๋Š”์ง€, ๊ทธ ์ด๋ฆ„์ด ์–ด๋””์„œ ์™”๋Š”์ง€ ์•Œ๋ ค์ค๋‹ˆ๋‹ค.

์ธ์‹๋ก ์  ๊ณ„์•ฝ์ด ์žˆ๋Š” ์ €์žฅ์†Œ ๊ฐ„ ๋ฉ”๋ชจ๋ฆฌ. ํ•œ ์ €์žฅ์†Œ์—์„œ ๋ฐฐ์šด ๊ตํ›ˆ์€ ์Šค์ฝ”ํ”„๊ฐ€ ์ง€์ •๋œ ์ €์žฅ์†Œ์—๋งŒ ๋„๋‹ฌํ•ฉ๋‹ˆ๋‹ค. ๋„๋‹ฌ ๋ฒ”์œ„๋Š” ์ฝ์„ ๋•Œ ์ถ”์ธก๋˜๋Š” ๊ฒƒ์ด ์•„๋‹ˆ๋ผ ์“ธ ๋•Œ ์„ ์–ธ๋˜๋ฏ€๋กœ, ํ˜•์ œ ํ”„๋กœ์ ํŠธ๊ฐ€ ๋‹ค๋ฅธ ํ”„๋กœ์ ํŠธ์˜ ์ œ์•ฝ์„ ๋ฌผ๋ ค๋ฐ›์ง€ ์•Š์Šต๋‹ˆ๋‹ค. ๊ธฐ๋ก๋˜๋Š” ๋ชจ๋“  ๊ฒƒ์—๋Š” confidence: verified | inferred | unverified, ๋ณ€๋™์„ฑ ์žˆ๋Š” ์‚ฌ์‹ค์˜ ๋‚ ์งœ, ๊ทธ๋ฆฌ๊ณ  ์„œ๋ฒ„ ์ธก์—์„œ ๋„์ถœ๋œ ์ถœ์ฒ˜๊ฐ€ ํ•จ๊ป˜ ๋‹ด๊น๋‹ˆ๋‹ค โ€” ์„ธ์…˜์ด ์ž์‹ ์ด ์•„๋‹Œ ํ”„๋กœ์ ํŠธ๋ฅผ ์‚ฌ์นญํ•  ์ˆ˜ ์—†์Šต๋‹ˆ๋‹ค. ์ˆ˜์ •์€ ๋ฎ์–ด์“ฐ๊ธฐ๊ฐ€ ์•„๋‹ˆ๋ผ ๋Œ€์ฒด๋กœ ๊ธฐ๋ก๋˜๋ฏ€๋กœ, ์ €์žฅ์†Œ๋Š” ๋ชจ์ˆœ์„ ์Œ“์•„๊ฐ€๋Š” ๋Œ€์‹  ์ปค์งˆ์ˆ˜๋ก ๋” ์‹ ๋ขฐํ•  ์ˆ˜ ์žˆ๊ฒŒ ๋ฉ๋‹ˆ๋‹ค.

๋ฌด์—‡์„ ์ œ๊ณตํ•˜๋Š”๊ฐ€. ๋‹น์‹ ์˜ ๋ณผํŠธ, ๋‹น์‹ ์˜ ๋…ธํŠธ, ๋‹น์‹ ์˜ ์„ธ์…˜์ž…๋‹ˆ๋‹ค. ๊ธฐ๋ณธ๊ฐ’์€ ๋ณผํŠธ๊ฐ€ ์ด๋ฏธ ์ž์‹ ์˜ ์ฝ˜ํ…์ธ ๋กœ ์„ ์–ธํ•œ ๊ฒƒ(user_content_roots)์„, ์ž‘์„ฑํ•œ ๊ทธ๋Œ€๋กœ์˜ ๋‹จ์œ„๋กœ ์‚ฌ์šฉํ•ฉ๋‹ˆ๋‹ค(work/ ์ „์ฒด๊ฐ€ ์•„๋‹ˆ๋ผ work/active/). vault-manifest.json์˜ mcp_exposed_roots๋ฅผ ์„ค์ •ํ•˜๋Š” ๊ฒƒ์€ ์ด ๋ณผํŠธ๊ฐ€ ๋‹น์‹ ์ด ๊ณต์œ ํ•  ๊ถŒํ•œ์ด ์—†๋Š” ์ž๋ฃŒ โ€” ๊ณ ์šฉ์ฃผ์˜ ๊ธฐ๋ฐ€ ์ •๋ณด๋‚˜ ๊ณ ๊ฐ์˜ ๋ฐ์ดํ„ฐ โ€” ๋ฅผ ๋‹ด๊ณ  ์žˆ์„ ๋•Œ๋ฟ์ž…๋‹ˆ๋‹ค. private ํƒœ๊ทธ๊ฐ€ ๋ถ™์€ ๋…ธํŠธ๋Š” ์ œ๊ณต๋˜์ง€ ์•Š์œผ๋ฉฐ, ๋ฉ”๋ชจ๋ฆฌ๋Š” ์ž์ฒด ์Šค์ฝ”ํ”„๋ฅผ ๊ฐ–๊ธฐ ๋•Œ๋ฌธ์— ์ผ๋ฐ˜ ๋…ธํŠธ๋กœ ์ œ๊ณต๋˜์ง€ ์•Š์Šต๋‹ˆ๋‹ค. ๋‘˜ ์‚ฌ์ด๋ฅผ ๊ฐ€๋กœ์ง€๋ฅด๋Š” ๊ฒฝ์šฐ๊ฐ€ ํ•˜๋‚˜ ์žˆ์Šต๋‹ˆ๋‹ค. ์บก์ฒ˜์˜ promoted: ๋งˆ์ปค๊ฐ€ ์•ต์ปค๋ฅผ ๋‹ด๊ณ  ์žˆ์œผ๋ฉด recall์ด brain/์˜ ํ•ด๋‹น ๋ธ”๋ก์„ ์ œ๊ณตํ•˜๋ฏ€๋กœ, ๋‹ค๋ฅธ ์ €์žฅ์†Œ๋Š” ์ฒ˜์Œ ์ž‘์„ฑ๋œ ์บก์ฒ˜๊ฐ€ ์•„๋‹ˆ๋ผ ์ˆ˜์ •๋œ ํŒ์„ ๋ฐ›์Šต๋‹ˆ๋‹ค. ์ด ์—ญ์‹œ ๊ฐ™์€ ์ •์ฑ…์˜ ์ œ์•ฝ์„ ๋ฐ›์œผ๋ฏ€๋กœ private์ด๊ฑฐ๋‚˜ ๋น„๊ณต๊ฐœ์ธ ๋…ธํŠธ๋Š” ์—ฌ๊ธฐ์„œ๋„ ๊ฑฐ๋ถ€๋ฉ๋‹ˆ๋‹ค. ๋ชจ๋“  ์ฝ๊ธฐ๋Š” ํ˜ธ์ถœํ•œ ์ €์žฅ์†Œ์™€ ํ•จ๊ป˜ ๊ธฐ๋ก๋ฉ๋‹ˆ๋‹ค.

[!NOTE] ๋ณผํŠธ ์ž๋ฃŒ๊ฐ€ ๊ณต๊ฐœ PR์— ๋“ค์–ด๊ฐ€์ง€ ์•Š๊ฒŒ ํ•˜๋Š” ๊ฒƒ์€ ๊ณต๊ฐœ ๋ชฉ๋ก์ด ์•„๋‹ˆ๋ผ ๊ณ„์•ฝ์˜ ์ผ์ž…๋‹ˆ๋‹ค. ์„ธ์…˜์€ ์–ด์ฐจํ”ผ ๋ณผํŠธ๋ฅผ ์ง์ ‘ ์ฝ์„ ์ˆ˜ ์žˆ์Šต๋‹ˆ๋‹ค. ํ˜ธ์ถœํ•˜๋Š” ์„ธ์…˜์— ์ฃผ์ž…๋˜๋Š” ๊ธˆ์ง€ ์‚ฌํ•ญ์ด ์‹ค์ธก์œผ๋กœ ํšจ๊ณผ๊ฐ€ ์žˆ๋Š” ๋ถ€๋ถ„์ž…๋‹ˆ๋‹ค.


๐Ÿ“… ์ผ์ผ ์›Œํฌํ”Œ๋กœ์šฐ

์•„์นจ: /om-standup์„ ์‹คํ–‰ํ•ฉ๋‹ˆ๋‹ค. ์—์ด์ „ํŠธ๊ฐ€ North Star, ํ™œ์„ฑ ํ”„๋กœ์ ํŠธ, ๋ฏธ์™„๋ฃŒ ์ž‘์—…, ์ตœ๊ทผ ๋ณ€๊ฒฝ์‚ฌํ•ญ์„ ๋กœ๋“œํ•ฉ๋‹ˆ๋‹ค. ๊ตฌ์กฐํ™”๋œ ์š”์•ฝ๊ณผ ์ถ”์ฒœ ์šฐ์„ ์ˆœ์œ„๋ฅผ ๋ฐ›์Šต๋‹ˆ๋‹ค.

ํ•˜๋ฃจ ์ค‘: ์ž์—ฐ์Šค๋Ÿฝ๊ฒŒ ์ด์•ผ๊ธฐํ•˜์„ธ์š”. ๋‚ด๋ฆฐ ๊ฒฐ์ •, ๋ฐœ์ƒํ•œ ์ธ์‹œ๋˜ํŠธ, ๋ฐฉ๊ธˆ ๋งˆ์นœ 1:1, ๊ธฐ์–ตํ•˜๊ณ  ์‹ถ์€ ์„ฑ๊ณผ๋ฅผ ์–ธ๊ธ‰ํ•˜์„ธ์š”. ๋ถ„๋ฅ˜ ํ›…์ด ์—์ด์ „ํŠธ๊ฐ€ ๊ฐ ํ•ญ๋ชฉ์„ ์˜ฌ๋ฐ”๋ฅด๊ฒŒ ๊ธฐ๋กํ•˜๋„๋ก ์•ˆ๋‚ดํ•ฉ๋‹ˆ๋‹ค. ๋” ํฐ ๋ธŒ๋ ˆ์ธ ๋คํ”„๋ฅผ ํ•˜๋ ค๋ฉด /om-dump์„ ์‚ฌ์šฉํ•˜๊ณ  ํ•œ ๋ฒˆ์— ๋ชจ๋“  ๊ฒƒ์„ ์ด์•ผ๊ธฐํ•˜์„ธ์š”.

ํ•˜๋ฃจ ๋: "wrap up"์ด๋ผ๊ณ  ๋งํ•˜๋ฉด ์—์ด์ „ํŠธ๊ฐ€ /om-wrap-up์„ ํ˜ธ์ถœํ•ฉ๋‹ˆ๋‹ค โ€” ๋…ธํŠธ ๊ฒ€์ฆ, ์ธ๋ฑ์Šค ์—…๋ฐ์ดํŠธ, ๋งํฌ ํ™•์ธ, ๋ˆ„๋ฝ๋œ ์„ฑ๊ณผ ๋ฐœ๊ฒฌ.

์ฃผ๊ฐ„: /om-weekly๋ฅผ ์‹คํ–‰ํ•˜์—ฌ ์„ธ์…˜ ๊ฐ„ ์ข…ํ•ฉ ๋ถ„์„ โ€” North Star ์ •๋ ฌ, ํŒจํ„ด, ๋ˆ„๋ฝ๋œ ์„ฑ๊ณผ, ๋‹ค์Œ ์ฃผ ์šฐ์„ ์ˆœ์œ„. /om-vault-audit๋ฅผ ์‹คํ–‰ํ•˜์—ฌ ๊ณ ์•„ ๋…ธํŠธ, ๊นจ์ง„ ๋งํฌ, ์˜ค๋ž˜๋œ ์ฝ˜ํ…์ธ ๋ฅผ ์ ๊ฒ€ํ•ฉ๋‹ˆ๋‹ค.

๋ฆฌ๋ทฐ ์‹œ์ฆŒ: /om-review-brief manager๋ฅผ ์‹คํ–‰ํ•˜๋ฉด ๋ชจ๋“  ์ฆ๊ฑฐ๊ฐ€ ์ด๋ฏธ ๋งํฌ๋œ ๊ตฌ์กฐํ™”๋œ ๋ฆฌ๋ทฐ ์ค€๋น„ ๋ฌธ์„œ๋ฅผ ๋ฐ›์Šต๋‹ˆ๋‹ค.


๐Ÿ› ๏ธ ๋ช…๋ น์–ด

.claude/commands/์— ์ •์˜๋˜์–ด ์žˆ์Šต๋‹ˆ๋‹ค. ๋ชจ๋“  Claude Code ์„ธ์…˜์—์„œ ์‹คํ–‰ํ•  ์ˆ˜ ์žˆ์Šต๋‹ˆ๋‹ค.

๋ช…๋ น์–ด ๊ธฐ๋Šฅ
/om-standup ์•„์นจ ํ‚ฅ์˜คํ”„ โ€” ์ปจํ…์ŠคํŠธ ๋กœ๋“œ, ์–ด์ œ ๋ฆฌ๋ทฐ, ์ž‘์—… ํ‘œ๋ฉดํ™”, ์šฐ์„ ์ˆœ์œ„ ์ œ์•ˆ
/om-dump ์ž์œ  ํ˜•์‹ ์บก์ฒ˜ โ€” ๋ฌด์—‡์ด๋“  ์ž์—ฐ์Šค๋Ÿฝ๊ฒŒ ์ด์•ผ๊ธฐํ•˜๋ฉด ์˜ฌ๋ฐ”๋ฅธ ๋…ธํŠธ๋กœ ๋ผ์šฐํŒ…
/om-wrap-up ์ „์ฒด ์„ธ์…˜ ๋ฆฌ๋ทฐ โ€” ๋…ธํŠธ, ์ธ๋ฑ์Šค, ๋งํฌ ๊ฒ€์ฆ, ๊ฐœ์„ ์‚ฌํ•ญ ์ œ์•ˆ
/om-humanize ๋ชฉ์†Œ๋ฆฌ ๋ณด์ • ํŽธ์ง‘ โ€” Claude๊ฐ€ ์ž‘์„ฑํ•œ ํ…์ŠคํŠธ๋ฅผ ๋ณธ์ธ์ด ์“ด ๊ฒƒ์ฒ˜๋Ÿผ ์ˆ˜์ •
/om-weekly ์ฃผ๊ฐ„ ์ข…ํ•ฉ โ€” ์„ธ์…˜ ๊ฐ„ ํŒจํ„ด, North Star ์ •๋ ฌ, ๋ˆ„๋ฝ๋œ ์„ฑ๊ณผ
/om-prep-1on1 1:1 ์ค€๋น„ โ€” ์ƒ๋Œ€๋ฐฉ ์ปจํ…์ŠคํŠธ, ๋ฏธํ•ด๊ฒฐ ํ•ญ๋ชฉ, ์ œ์•ˆ ์•ˆ๊ฑด ๋กœ๋“œ
/om-meeting ์ฃผ์ œ๋ณ„ ๋ฏธํŒ… ์ค€๋น„ โ€” ๋ฏธํ•ด๊ฒฐ ํ•ญ๋ชฉ, ์ฐจ๋‹จ ์š”์†Œ, ๊ณ ๋ ค์‚ฌํ•ญ ๋ธŒ๋ฆฌํ•‘
/om-intake ๋ฏธํŒ… ๋…ธํŠธ ์ˆ˜์‹ ํ•จ ์ฒ˜๋ฆฌ โ€” work/meetings/์˜ ํŒŒ์ผ์„ ๋ถ„๋ฅ˜ํ•˜๊ณ  ์ ์ ˆํ•œ ๋…ธํŠธ๋กœ ๋ผ์šฐํŒ…
/om-capture-1on1 1:1 ๋ฏธํŒ… ํŠธ๋žœ์Šคํฌ๋ฆฝํŠธ๋ฅผ ๊ตฌ์กฐํ™”๋œ ๋ณผํŠธ ๋…ธํŠธ๋กœ ์บก์ฒ˜
/om-incident-capture Slack/์ฑ„๋„์˜ ์ธ์‹œ๋˜ํŠธ๋ฅผ ๊ตฌ์กฐํ™”๋œ ๋…ธํŠธ๋กœ ์บก์ฒ˜
/om-slack-scan Slack ์ฑ„๋„/DM์„ ๊นŠ์ด ์Šค์บ”ํ•˜์—ฌ ์ฆ๊ฑฐ ์ˆ˜์ง‘
/om-peer-scan ๋™๋ฃŒ์˜ GitHub PR์„ ๊นŠ์ด ์Šค์บ”ํ•˜์—ฌ ๋ฆฌ๋ทฐ ์ค€๋น„
/om-review-brief ๋ฆฌ๋ทฐ ๋ธŒ๋ฆฌํ”„ ์ƒ์„ฑ (๋งค๋‹ˆ์ € ๋˜๋Š” ๋™๋ฃŒ ๋ฒ„์ „)
/om-self-review ๋ฆฌ๋ทฐ ์‹œ์ฆŒ์„ ์œ„ํ•œ ์ž๊ธฐ ํ‰๊ฐ€ ์ž‘์„ฑ โ€” ํ”„๋กœ์ ํŠธ, ์—ญ๋Ÿ‰, ์›์น™
/om-review-peer ๋™๋ฃŒ ๋ฆฌ๋ทฐ ์ž‘์„ฑ โ€” ํ”„๋กœ์ ํŠธ, ์›์น™, ์„ฑ๊ณผ ์š”์•ฝ
/om-correct ์ˆ˜์ •๋œ ์‚ฌ์‹ค์„ ์ผ๊ด„ ๋ฐ˜์˜ โ€” ๋‹จ์ผ ์ถœ์ฒ˜์— ์ ์šฉํ•˜๊ณ , ์žฌ์ง„์ˆ ์€ ๋งํฌ๋กœ ๋Œ€์ฒดํ•˜๋ฉฐ, ๋‚ ์งœ๊ฐ€ ์žˆ๋Š” ๊ธฐ๋ก์€ ๋ณด์กด
/om-vault-audit ์ธ๋ฑ์Šค, ๋งํฌ, ๊ณ ์•„ ๋…ธํŠธ, ์˜ค๋ž˜๋œ ์ปจํ…์ŠคํŠธ ๊ฐ์‚ฌ
/om-vault-upgrade ๊ธฐ์กด ๋ณผํŠธ์—์„œ ์ฝ˜ํ…์ธ  ๊ฐ€์ ธ์˜ค๊ธฐ โ€” ๋ฒ„์ „ ๊ฐ์ง€, ๋ถ„๋ฅ˜, ๋งˆ์ด๊ทธ๋ ˆ์ด์…˜
/om-project-archive ์™„๋ฃŒ๋œ ํ”„๋กœ์ ํŠธ๋ฅผ active/์—์„œ archive/๋กœ ์ด๋™, ์ธ๋ฑ์Šค ์—…๋ฐ์ดํŠธ
/om-tidy ์ž์ฒด ์œ ์ง€๋ณด์ˆ˜ โ€” ์œ„์ƒ ํ”Œ๋ž˜๊ทธ์— ๋”ฐ๋ผ ์™„๋ฃŒ ๋…ธํŠธ ์•„์นด์ด๋ธŒ, ํด๋Ÿฌ์Šคํ„ฐ ํด๋”ํ™”, ๋น„๋Œ€ ๋…ธํŠธ ๋ถ„ํ• ์„ ์ˆ˜ํ–‰. ์‚ญ์ œ๋„ ์ปค๋ฐ‹๋„ ํ•˜์ง€ ์•Š์Œ

๐Ÿค– ์„œ๋ธŒ์—์ด์ „ํŠธ

๊ฒฉ๋ฆฌ๋œ ์ปจํ…์ŠคํŠธ ์œˆ๋„์šฐ์—์„œ ์‹คํ–‰๋˜๋Š” ์ „๋ฌธ ์—์ด์ „ํŠธ์ž…๋‹ˆ๋‹ค. ๋ฉ”์ธ ๋Œ€ํ™”๋ฅผ ์˜ค์—ผ์‹œํ‚ค์ง€ ์•Š๊ณ  ๋ฌด๊ฑฐ์šด ์ž‘์—…์„ ์ฒ˜๋ฆฌํ•ฉ๋‹ˆ๋‹ค.

์—์ด์ „ํŠธ ์šฉ๋„ ํ˜ธ์ถœ ๋ฐฉ๋ฒ•
brag-spotter ๋ˆ„๋ฝ๋œ ์„ฑ๊ณผ์™€ ์—ญ๋Ÿ‰ ๊ฒฉ์ฐจ ๋ฐœ๊ฒฌ /om-wrap-up, /om-weekly
context-loader ์ธ๋ฌผ, ํ”„๋กœ์ ํŠธ, ๊ฐœ๋…์— ๋Œ€ํ•œ ๋ชจ๋“  ๋ณผํŠธ ์ปจํ…์ŠคํŠธ ๋กœ๋“œ ์ง์ ‘ ํ˜ธ์ถœ
cross-linker ๋ˆ„๋ฝ๋œ ์œ„ํ‚ค๋งํฌ, ๊ณ ์•„ ๋…ธํŠธ, ๊นจ์ง„ ๋ฐฑ๋งํฌ ๋ฐœ๊ฒฌ /om-vault-audit
people-profiler Slack ํ”„๋กœํ•„์—์„œ ์ธ๋ฌผ ๋…ธํŠธ๋ฅผ ์ผ๊ด„ ์ƒ์„ฑ/์—…๋ฐ์ดํŠธ /om-incident-capture
review-prep ๋ฆฌ๋ทฐ ๊ธฐ๊ฐ„์˜ ๋ชจ๋“  ์„ฑ๊ณผ ์ฆ๊ฑฐ ์ง‘๊ณ„ /om-review-brief
slack-archaeologist ์ „์ฒด Slack ๋ณต์› โ€” ๋ชจ๋“  ๋ฉ”์‹œ์ง€, ์Šค๋ ˆ๋“œ, ํ”„๋กœํ•„ /om-incident-capture
vault-librarian ์‹ฌ์ธต ๋ณผํŠธ ์œ ์ง€๋ณด์ˆ˜ โ€” ๊ณ ์•„ ๋…ธํŠธ, ๊นจ์ง„ ๋งํฌ, ์˜ค๋ž˜๋œ ๋…ธํŠธ /om-vault-audit
review-fact-checker ๋ฆฌ๋ทฐ ์ดˆ์•ˆ์˜ ๋ชจ๋“  ์ฃผ์žฅ์„ ๋ณผํŠธ ์†Œ์Šค์™€ ๋Œ€์กฐ ๊ฒ€์ฆ /om-self-review, /om-review-peer
vault-migrator ์†Œ์Šค ๋ณผํŠธ์—์„œ ์ฝ˜ํ…์ธ  ๋ถ„๋ฅ˜, ๋ณ€ํ™˜, ๋งˆ์ด๊ทธ๋ ˆ์ด์…˜ /om-vault-upgrade

[!NOTE] ์„œ๋ธŒ์—์ด์ „ํŠธ๋Š” .claude/agents/์— ์ •์˜๋˜์–ด ์žˆ์Šต๋‹ˆ๋‹ค. ๋„๋ฉ”์ธ๋ณ„ ์›Œํฌํ”Œ๋กœ์šฐ๋ฅผ ์œ„ํ•ด ์ง์ ‘ ์ถ”๊ฐ€ํ•  ์ˆ˜ ์žˆ์Šต๋‹ˆ๋‹ค.


๐Ÿ“Š ์„ฑ๊ณผ ๊ทธ๋ž˜ํ”„

๋ณผํŠธ๋Š” ์„ฑ๊ณผ ์ถ”์  ์‹œ์Šคํ…œ์œผ๋กœ๋„ ํ™œ์šฉ๋ฉ๋‹ˆ๋‹ค:

  1. ์—ญ๋Ÿ‰ ๋…ธํŠธ(perf/competencies/)๊ฐ€ ์กฐ์ง์˜ ์—ญ๋Ÿ‰ ํ”„๋ ˆ์ž„์›Œํฌ๋ฅผ ์ •์˜ํ•ฉ๋‹ˆ๋‹ค โ€” ์—ญ๋Ÿ‰๋ณ„๋กœ ํ•˜๋‚˜์˜ ๋…ธํŠธ
  2. ์ž‘์—… ๋…ธํŠธ๊ฐ€ ## Related ์„น์…˜์—์„œ ์—ญ๋Ÿ‰์— ๋งํฌํ•˜๋ฉฐ, ์–ด๋–ค ์—ญ๋Ÿ‰์ด ๋ฐœํœ˜๋˜์—ˆ๋Š”์ง€ ์ฃผ์„์„ ๋‹ต๋‹ˆ๋‹ค
  3. ๋ฐฑ๋งํฌ๊ฐ€ ์ž๋™์œผ๋กœ ์ถ•์ ๋ฉ๋‹ˆ๋‹ค โ€” ๋ฆฌ๋ทฐ ์ค€๋น„๋Š” ๊ฐ ์—ญ๋Ÿ‰ ๋…ธํŠธ์˜ ๋ฐฑ๋งํฌ ํŒจ๋„์„ ์ฝ๋Š” ๊ฒƒ์œผ๋กœ ์ถฉ๋ถ„ํ•ฉ๋‹ˆ๋‹ค
  4. Brag Doc๊ฐ€ ๋ถ„๊ธฐ๋ณ„ ์„ฑ๊ณผ๋ฅผ ์ฆ๊ฑฐ ๋…ธํŠธ ๋งํฌ์™€ ํ•จ๊ป˜ ์ง‘๊ณ„ํ•ฉ๋‹ˆ๋‹ค
  5. **/om-peer-scan**์ด ๋™๋ฃŒ์˜ GitHub PR์„ ๊นŠ์ด ์Šค์บ”ํ•˜๊ณ  ๊ตฌ์กฐํ™”๋œ ์ฆ๊ฑฐ๋ฅผ perf/evidence/์— ์ž‘์„ฑํ•ฉ๋‹ˆ๋‹ค
  6. **/om-review-brief**๊ฐ€ ๋ชจ๋“  ๊ฒƒ์„ ์ง‘๊ณ„ํ•˜์—ฌ ์ „์ฒด ๋ฆฌ๋ทฐ ๋ธŒ๋ฆฌํ”„๋ฅผ ์ƒ์„ฑํ•ฉ๋‹ˆ๋‹ค: Brag ํ•ญ๋ชฉ, ์˜์‚ฌ๊ฒฐ์ •, ์ธ์‹œ๋˜ํŠธ, ์—ญ๋Ÿ‰ ์ฆ๊ฑฐ, 1:1 ํ”ผ๋“œ๋ฐฑ

[!TIP] ์‹œ์ž‘ํ•˜๋ ค๋ฉด: ํ…œํ”Œ๋ฆฟ์—์„œ ์—ญ๋Ÿ‰ ๋…ธํŠธ๋ฅผ ๋งŒ๋“ค๊ณ , ์ž‘์—…ํ•˜๋ฉด์„œ ์ž‘์—… ๋…ธํŠธ์— ์—ญ๋Ÿ‰์„ ๋งํฌํ•˜์„ธ์š”. ๊ทธ๋ž˜ํ”„๊ฐ€ ๋‚˜๋จธ์ง€๋ฅผ ์ฒ˜๋ฆฌํ•ฉ๋‹ˆ๋‹ค.


๐Ÿ“‹ Bases

bases/ ํด๋”์—๋Š” ๋…ธํŠธ์˜ ํ”„๋ก ํŠธ๋งคํ„ฐ ์†์„ฑ์„ ์ฟผ๋ฆฌํ•˜๋Š” ๋ฐ์ดํ„ฐ๋ฒ ์ด์Šค ๋ทฐ๊ฐ€ ์žˆ์Šต๋‹ˆ๋‹ค. ๋…ธํŠธ๊ฐ€ ๋ณ€๊ฒฝ๋˜๋ฉด ์ž๋™์œผ๋กœ ์—…๋ฐ์ดํŠธ๋ฉ๋‹ˆ๋‹ค.

Base ํ‘œ์‹œ ๋‚ด์šฉ
Work Dashboard ๋ถ„๊ธฐ๋ณ„ ํ•„ํ„ฐ๋ง, ์ƒํƒœ๋ณ„ ๊ทธ๋ฃนํ™”๋œ ํ™œ์„ฑ ํ”„๋กœ์ ํŠธ โ€” 14์ผ ์ด์ƒ ์†๋Œ€์ง€ ์•Š์€ ํ™œ์„ฑ ๋…ธํŠธ๋ฅผ ๋ณด์—ฌ์ฃผ๋Š” Stale Actives ๋ทฐ ํฌํ•จ
Recently Touched ์‹ค์ œ ์ˆ˜์ • ์‹œ๊ฐ ์ˆœ์˜ ๋ชจ๋“  ๋…ธํŠธ โ€” "์ตœ๊ทผ ๋ฌด์—‡์„ ์ž‘์—…ํ–ˆ๋‚˜"์— ๋Œ€ํ•œ ์ •ํ™•ํ•œ ๋‹ต (์‚ด์•„์žˆ๋Š” ๋…ธํŠธ์—์„œ ํŒŒ์ผ๋ช… ๋‚ ์งœ๋Š” ๋ฏฟ์„ ์ˆ˜ ์—†์Œ)
Incidents ์‹ฌ๊ฐ๋„์™€ ๋‚ ์งœ์ˆœ์œผ๋กœ ์ •๋ ฌ๋œ ๋ชจ๋“  ์ธ์‹œ๋˜ํŠธ
People Directory org/people/์˜ ๋ชจ๋“  ์ธ๋ฌผ๊ณผ ์—ญํ• , ํŒ€ ์ •๋ณด
1:1 History ์ธ๋ฌผ๊ณผ ๋‚ ์งœ๋กœ ์ •๋ ฌ ๊ฐ€๋Šฅํ•œ ๋ชจ๋“  1:1 ๋…ธํŠธ
Review Evidence ์ธ๋ฌผ๊ณผ ์ฃผ๊ธฐ๋ณ„๋กœ ๊ทธ๋ฃนํ™”๋œ PR ์Šค์บ” ๋ฐ ์ฆ๊ฑฐ
Competency Map ๋ฐฑ๋งํฌ ๊ธฐ๋ฐ˜ ์ฆ๊ฑฐ ์ˆ˜๋ฅผ ํฌํ•จํ•œ ์—ญ๋Ÿ‰ ๋ชฉ๋ก
Templates ๋ชจ๋“  ํ…œํ”Œ๋ฆฟ์— ๋Œ€ํ•œ ๋น ๋ฅธ ์ ‘๊ทผ

Home.md๊ฐ€ ์ด ๋ทฐ๋“ค์„ ์ž„๋ฒ ๋“œํ•˜์—ฌ ๋ณผํŠธ์˜ ๋Œ€์‹œ๋ณด๋“œ ์—ญํ• ์„ ํ•ฉ๋‹ˆ๋‹ค.


๐Ÿ“ ๋ณผํŠธ ๊ตฌ์กฐ

Home.md                 ๋ณผํŠธ ์ง„์ž…์  โ€” ์ž„๋ฒ ๋“œ๋œ Base ๋ทฐ, ๋ฐ”๋กœ๊ฐ€๊ธฐ ๋งํฌ
CLAUDE.md               ์šด์˜ ๋งค๋‰ด์–ผ โ€” ์—์ด์ „ํŠธ๊ฐ€ ๋งค ์„ธ์…˜๋งˆ๋‹ค ์ฝ์Œ
AGENTS.md               ๋ฉ€ํ‹ฐ์—์ด์ „ํŠธ ๊ฐ€์ด๋“œ โ€” Codex, Cursor, Windsurf ๋“ฑ
GEMINI.md               ๋ฉ€ํ‹ฐ์—์ด์ „ํŠธ ๊ฐ€์ด๋“œ โ€” Gemini CLI
vault-manifest.json     ํ…œํ”Œ๋ฆฟ ๋ฉ”ํƒ€๋ฐ์ดํ„ฐ โ€” ๋ฒ„์ „, ๊ตฌ์กฐ, ์Šคํ‚ค๋งˆ
.shardmindignore        `shardmind install`์—์„œ ์ œ์™ธ๋˜๋Š” ํŒŒ์ผ (CONTRIBUTING, ๋ฒˆ์—ญ, ๋งˆ์ผ€ํŒ… ๋ฏธ๋””์–ด)
CHANGELOG.md            ๋ฒ„์ „ ํžˆ์Šคํ† ๋ฆฌ
CONTRIBUTING.md         ํ…œํ”Œ๋ฆฟ ๊ฐœ๋ฐœ ์ฒดํฌ๋ฆฌ์ŠคํŠธ
README.md               ์ œํ’ˆ ๋ฌธ์„œ
LICENSE                 MIT ๋ผ์ด์„ ์Šค

bases/                  ๋™์  ๋ฐ์ดํ„ฐ๋ฒ ์ด์Šค ๋ทฐ (Work Dashboard, Incidents, People ๋“ฑ)

work/
  active/               ํ˜„์žฌ ํ”„๋กœ์ ํŠธ (ํ•œ ๋ฒˆ์— 1โ€“3๊ฐœ ํŒŒ์ผ)
  archive/YYYY/         ์™„๋ฃŒ๋œ ์ž‘์—…, ์—ฐ๋„๋ณ„ ์ •๋ฆฌ
  incidents/            ์ธ์‹œ๋˜ํŠธ ๋ฌธ์„œ (๋ฉ”์ธ ๋…ธํŠธ + RCA + ์‹ฌ์ธต ๋ถ„์„)
  1-1/                  1:1 ๋ฏธํŒ… ๋…ธํŠธ โ€” <Person> YYYY-MM-DD.md ํ˜•์‹
  Index.md              ๋ชจ๋“  ์ž‘์—…์˜ Map of Content

org/
  people/               ์ธ๋ฌผ๋ณ„ ๋…ธํŠธ โ€” ์—ญํ• , ํŒ€, ๊ด€๊ณ„, ์ฃผ์š” ์ˆœ๊ฐ„
  teams/                ํŒ€๋ณ„ ๋…ธํŠธ โ€” ๊ตฌ์„ฑ์›, ๋ฒ”์œ„, ์ƒํ˜ธ์ž‘์šฉ
  People & Context.md   ์กฐ์ง ์ง€์‹์˜ MOC

perf/
  Brag Doc.md           ์ฆ๊ฑฐ์— ๋งํฌ๋œ ์„ฑ๊ณผ ๊ธฐ๋ก
  brag/                 ๋ถ„๊ธฐ๋ณ„ Brag ๋…ธํŠธ (๋ถ„๊ธฐ๋‹น ํ•˜๋‚˜)
  competencies/         ์—ญ๋Ÿ‰๋ณ„ ๋…ธํŠธ (๋งํฌ ๋Œ€์ƒ)
  evidence/             PR ์‹ฌ์ธต ์Šค์บ”, ๋ฆฌ๋ทฐ์šฉ ๋ฐ์ดํ„ฐ ์ถ”์ถœ
  <cycle>/              ๋ฆฌ๋ทฐ ์ฃผ๊ธฐ๋ณ„ ๋ธŒ๋ฆฌํ”„ ๋ฐ ์‚ฐ์ถœ๋ฌผ

brain/
  North Star.md         ๋ชฉํ‘œ์™€ ์ง‘์ค‘ ์˜์—ญ โ€” ๋งค ์„ธ์…˜๋งˆ๋‹ค ์ฝ์Œ
  Memories.md           ๋ฉ”๋ชจ๋ฆฌ ํ† ํ”ฝ ์ธ๋ฑ์Šค
  Key Decisions.md      ์ค‘์š”ํ•œ ์˜์‚ฌ๊ฒฐ์ •๊ณผ ๊ทผ๊ฑฐ
  Patterns.md           ์ž‘์—… ์ „๋ฐ˜์—์„œ ๊ด€์ฐฐ๋œ ๋ฐ˜๋ณต ํŒจํ„ด
  Gotchas.md            ์ž˜๋ชป๋œ ๊ฒƒ๋“ค๊ณผ ๊ทธ ์ด์œ 
  Skills.md             ์ปค์Šคํ…€ ์›Œํฌํ”Œ๋กœ์šฐ์™€ ์Šฌ๋ž˜์‹œ ๋ช…๋ น์–ด

reference/              ์ฝ”๋“œ๋ฒ ์ด์Šค ์ง€์‹, ์•„ํ‚คํ…์ฒ˜ ๋งต, ํ”Œ๋กœ์šฐ ๋ฌธ์„œ
thinking/               ์ดˆ์•ˆ์„ ์œ„ํ•œ ์Šคํฌ๋ž˜์น˜ํŒจ๋“œ โ€” ๊ฒฐ๊ณผ ์ •๋ฆฌ ํ›„ ์‚ญ์ œ
templates/              YAML ํ”„๋ก ํŠธ๋งคํ„ฐ๊ฐ€ ํฌํ•จ๋œ Obsidian ํ…œํ”Œ๋ฆฟ

.claude/
  commands/             18๊ฐœ ์Šฌ๋ž˜์‹œ ๋ช…๋ น์–ด
  agents/               9๊ฐœ ์„œ๋ธŒ์—์ด์ „ํŠธ
  scripts/              ํ›… ์Šคํฌ๋ฆฝํŠธ + charcount.ts ์œ ํ‹ธ๋ฆฌํ‹ฐ
  skills/               Obsidian + QMD ์Šคํ‚ฌ, obsidian-mind mod
  settings.json         5๊ฐœ ํ›… ์„ค์ •

.scripts/                ๋ณผํŠธ ์ˆ˜์ค€ ๋„๊ตฌ โ€” QMD ๋ถ€ํŠธ์ŠคํŠธ๋žฉ (์ƒˆ ํด๋ก ์—์„œ ํ•œ ๋ฒˆ ์‹คํ–‰)

.shardmind/             ShardMind ์‚ฌ์ด๋“œ์นด โ€” `shardmind install`๋กœ ์„ค์น˜ํ•œ ๊ฒฝ์šฐ์—๋งŒ ์‚ฌ์šฉ
  shard.yaml            ๋งค๋‹ˆํŽ˜์ŠคํŠธ (์ด๋ฆ„, ๋ฒ„์ „, ๋ชจ๋“ˆ, ํ›…)
  shard-schema.yaml     ๋งˆ๋ฒ•์‚ฌ ๊ฐ’ + ๋ชจ๋“ˆ ๊ฒŒ์ดํŒ…
  hooks/                bootstrap (git ์ดˆ๊ธฐํ™” + QMD), personalize (North Star), post-update

[!NOTE] .shardmind/๋Š” ์ถ”๊ฐ€ ๊ธฐ๋Šฅ์ด๋ฉฐ, ํ•„์ˆ˜ ์š”์†Œ๊ฐ€ ์•„๋‹™๋‹ˆ๋‹ค. ํด๋ก ํ•˜์—ฌ ์—ด๊ธฐ๋งŒ ํ•˜๋Š” ๋ณผํŠธ๋Š” ์ด ํŒŒ์ผ์„ ์ฝ์ง€ ์•Š์œผ๋ฉฐ, shardmind CLI๋งŒ ์‚ฌ์šฉํ•ฉ๋‹ˆ๋‹ค. ์‚ญ์ œํ•ด๋„ ๋ณผํŠธ๋Š” ๊ณ„์† ์ž‘๋™ํ•ฉ๋‹ˆ๋‹ค. v6 ๋ ˆ์ด์•„์›ƒ ๊ณ„์•ฝ์€ shardmind/docs/SHARD-LAYOUT.md๋ฅผ ์ฐธ์กฐํ•˜์„ธ์š”.


๐Ÿ“ ํ…œํ”Œ๋ฆฟ

YAML ํ”„๋ก ํŠธ๋งคํ„ฐ๊ฐ€ ํฌํ•จ๋œ ํ…œํ”Œ๋ฆฟ์œผ๋กœ, ๊ฐ๊ฐ ์ ์ง„์  ๊ณต๊ฐœ๋ฅผ ์œ„ํ•œ description ํ•„๋“œ๋ฅผ ํฌํ•จํ•ฉ๋‹ˆ๋‹ค:

  • Work Note โ€” ๋‚ ์งœ, ์„ค๋ช…, ํ”„๋กœ์ ํŠธ, ์ƒํƒœ, ๋ถ„๊ธฐ, ํƒœ๊ทธ
  • Decision Record โ€” ๋‚ ์งœ, ์„ค๋ช…, ์ƒํƒœ (proposed/accepted/deprecated), ๋‹ด๋‹น์ž, ๋งฅ๋ฝ
  • Thinking Note โ€” ๋‚ ์งœ, ์„ค๋ช…, ๋งฅ๋ฝ, ํƒœ๊ทธ (์Šคํฌ๋ž˜์น˜ํŒจ๋“œ โ€” ์ •๋ฆฌ ํ›„ ์‚ญ์ œ)
  • Competency Note โ€” ๋‚ ์งœ, ์„ค๋ช…, ํ˜„์žฌ ๋ ˆ๋ฒจ, ๋ชฉํ‘œ ๋ ˆ๋ฒจ, ์ˆ™๋ จ๋„ ํ‘œ
  • 1:1 Note โ€” ๋‚ ์งœ, ์ƒ๋Œ€๋ฐฉ, ํ•ต์‹ฌ ์š”์ , ์•ก์…˜ ์•„์ดํ…œ, ์ธ์šฉ, ์ฃผ์‹œ ์‚ฌํ•ญ
  • Incident Note โ€” ๋‚ ์งœ, ํ‹ฐ์ผ“, ์‹ฌ๊ฐ๋„, ์—ญํ• , ํƒ€์ž„๋ผ์ธ, ๊ทผ๋ณธ ์›์ธ, ์˜ํ–ฅ

๐Ÿ”ง ํฌํ•จ ํ•ญ๋ชฉ

๐Ÿงฉ Obsidian ์Šคํ‚ฌ

kepano/obsidian-skills๊ฐ€ .claude/skills/์— ์‚ฌ์ „ ์„ค์น˜๋˜์–ด ์žˆ์Šต๋‹ˆ๋‹ค:

  • obsidian-markdown โ€” Obsidian ํŠนํ™” ๋งˆํฌ๋‹ค์šด (์œ„ํ‚ค๋งํฌ, ์ž„๋ฒ ๋“œ, ์ฝœ์•„์›ƒ, ์†์„ฑ)
  • obsidian-cli โ€” ๋ณผํŠธ ์šด์˜์„ ์œ„ํ•œ CLI ๋ช…๋ น์–ด
  • obsidian-bases โ€” ๋ฐ์ดํ„ฐ๋ฒ ์ด์Šค ์Šคํƒ€์ผ .base ํŒŒ์ผ
  • json-canvas โ€” ์‹œ๊ฐ์  .canvas ํŒŒ์ผ ์ƒ์„ฑ
  • defuddle โ€” ์›น ํŽ˜์ด์ง€๋ฅผ ๋งˆํฌ๋‹ค์šด์œผ๋กœ ์ถ”์ถœ

๐Ÿ” QMD ์Šคํ‚ฌ

.claude/skills/qmd/์— ์žˆ๋Š” ์ปค์Šคํ…€ ์Šคํ‚ฌ๋กœ, Claude๊ฐ€ QMD ์‹œ๋งจํ‹ฑ ๊ฒ€์ƒ‰์„ ๋Šฅ๋™์ ์œผ๋กœ ์‚ฌ์šฉํ•˜๋„๋ก ํ•ฉ๋‹ˆ๋‹ค โ€” ํŒŒ์ผ์„ ์ฝ๊ธฐ ์ „, ๋…ธํŠธ ์ƒ์„ฑ ์ „(์ค‘๋ณต ํ™•์ธ), ๋…ธํŠธ ์ƒ์„ฑ ํ›„(๋งํฌํ•  ๊ด€๋ จ ์ฝ˜ํ…์ธ  ํƒ์ƒ‰).


๐ŸŽจ ์ปค์Šคํ„ฐ๋งˆ์ด์ฆˆ

์ด๊ฒƒ์€ ์ถœ๋ฐœ์ ์ž…๋‹ˆ๋‹ค. ์ž์‹ ์˜ ์—…๋ฌด ๋ฐฉ์‹์— ๋งž๊ฒŒ ์กฐ์ •ํ•˜์„ธ์š”:

ํ•ญ๋ชฉ ์œ„์น˜
๋ชฉํ‘œ brain/North Star.md โ€” ๋ชจ๋“  ์„ธ์…˜์˜ ๊ธฐ์ค€
์กฐ์ง org/ โ€” ๋งค๋‹ˆ์ €, ํŒ€, ํ•ต์‹ฌ ํ˜‘๋ ฅ์ž ์ถ”๊ฐ€
์—ญ๋Ÿ‰ perf/competencies/ โ€” ์กฐ์ง์˜ ํ”„๋ ˆ์ž„์›Œํฌ์— ๋งž์ถ”๊ธฐ
๋„๊ตฌ .claude/commands/ โ€” GitHub ์กฐ์ง, Slack ์›Œํฌ์ŠคํŽ˜์ด์Šค์— ๋งž๊ฒŒ ํŽธ์ง‘
๊ทœ์น™ CLAUDE.md โ€” ์šด์˜ ๋งค๋‰ด์–ผ, ์ง„ํ–‰ํ•˜๋ฉด์„œ ๋ฐœ์ „์‹œํ‚ค๊ธฐ
๋„๋ฉ”์ธ ํด๋” ์ถ”๊ฐ€, .claude/agents/์— ์„œ๋ธŒ์—์ด์ „ํŠธ ์ถ”๊ฐ€, .claude/scripts/์— ๋ถ„๋ฅ˜ ๊ทœ์น™ ์ถ”๊ฐ€

[!IMPORTANT] CLAUDE.md๋Š” ์šด์˜ ๋งค๋‰ด์–ผ์ž…๋‹ˆ๋‹ค. ๊ทœ์น™์„ ๋ณ€๊ฒฝํ•˜๋ฉด ์ด ํŒŒ์ผ์„ ์—…๋ฐ์ดํŠธํ•˜์„ธ์š” โ€” ์—์ด์ „ํŠธ๊ฐ€ ๋งค ์„ธ์…˜๋งˆ๋‹ค ์ฝ์Šต๋‹ˆ๋‹ค.


๐Ÿ”„ ์—…๊ทธ๋ ˆ์ด๋“œ

์—์ด์ „ํŠธ์—๊ฒŒ ์š”์ฒญํ•˜๊ธฐ

๊ฐ€์žฅ ๊ฐ„๋‹จํ•œ ๋ฐฉ๋ฒ• โ€” ์—์ด์ „ํŠธ์—๊ฒŒ ๋งํ•˜์„ธ์š”:

์ด ๋ณผํŠธ๋ฅผ ์ตœ์‹  obsidian-mind๋กœ ์—…๋ฐ์ดํŠธํ•ด์ค˜ https://github.com/breferrari/obsidian-mind

์—์ด์ „ํŠธ๊ฐ€ ์ตœ์‹  ๋ณ€๊ฒฝ์‚ฌํ•ญ์„ ๊ฐ€์ ธ์˜ค๊ณ , ์ถฉ๋Œ์„ ํ•ด๊ฒฐํ•˜๊ณ , ์ธํ”„๋ผ ํŒŒ์ผ์„ ์—…๋ฐ์ดํŠธํ•ฉ๋‹ˆ๋‹ค. Claude Code, Codex CLI, Gemini CLI ๋ชจ๋‘์—์„œ ์ž‘๋™ํ•ฉ๋‹ˆ๋‹ค.

๊ธฐ์กด ํด๋ก  ์—…๋ฐ์ดํŠธ

๋ฆฌํฌ์ง€ํ† ๋ฆฌ๋ฅผ ์ง์ ‘ ํด๋ก ํ•œ ๊ฒฝ์šฐ:

cd your-vault
git pull origin main

์ƒˆ ํŒŒ์ผ(AGENTS.md, GEMINI.md, .codex/, .gemini/)์ด ์ž๋™์œผ๋กœ ์ถ”๊ฐ€๋˜๊ณ  ํ›… ์Šคํฌ๋ฆฝํŠธ๋„ ์—…๋ฐ์ดํŠธ๋ฉ๋‹ˆ๋‹ค.

ํฌํฌ ์—…๋ฐ์ดํŠธ

๋ฆฌํฌ์ง€ํ† ๋ฆฌ๋ฅผ ํฌํฌํ•œ ๊ฒฝ์šฐ:

git remote add upstream https://github.com/breferrari/obsidian-mind.git
git fetch upstream
git merge upstream/main

์ปค์Šคํ„ฐ๋งˆ์ด์ง•ํ•œ ํŒŒ์ผ(์ผ๋ฐ˜์ ์œผ๋กœ CLAUDE.md, brain/ ๋…ธํŠธ)์˜ ์ถฉ๋Œ์„ ํ•ด๊ฒฐํ•˜์„ธ์š”. ์ธํ”„๋ผ ํŒŒ์ผ(.claude/scripts/, .codex/, .gemini/)์€ ๊น”๋”ํ•˜๊ฒŒ ๋ณ‘ํ•ฉ๋ฉ๋‹ˆ๋‹ค.

๊ธฐ์กด ํด๋ก ์„ ShardMind๋กœ ์ฑ„ํƒ (v5.x โ†’ v6)

์ด๋ฏธ obsidian-mind๋ฅผ ํด๋ก ํ–ˆ๊ณ  ์ปค์Šคํ„ฐ๋งˆ์ด์ง•์„ ์žƒ์ง€ ์•Š๊ณ  ๋งˆ๋ฒ•์‚ฌ, ์„ ํƒ์  ๋ชจ๋“ˆ, 3-way ๋จธ์ง€ ์—…๊ทธ๋ ˆ์ด๋“œ๋ฅผ ์›ํ•˜์‹œ๋‚˜์š”? shardmind adopt๊ฐ€ ๊ธฐ์กด ๋ณผํŠธ๋ฅผ ๊ด€๋ฆฌ๋˜๋Š” v6 ์„ค์น˜๋กœ ์กฐ์ •ํ•ด์ค๋‹ˆ๋‹ค โ€” ํŽธ์ง‘ํ•œ ๋ชจ๋“  ๋ฐ”์ดํŠธ๋ฅผ ์œ ์ง€ํ•˜๋ฉด์„œ .shardmind/ ์‚ฌ์ด๋“œ์นด์™€ shard-values.yaml๋งŒ ์ถ”๊ฐ€ํ•ฉ๋‹ˆ๋‹ค:

npm install -g shardmind
shardmind adopt github:breferrari/obsidian-mind

2-way diff UI๊ฐ€ ๋กœ์ปฌ ๋ณ€๊ฒฝ ์‚ฌํ•ญ์„ ์•ˆ๋‚ดํ•˜๊ณ , ํŒŒ์ผ๋ณ„๋กœ ๋ฌด์—‡์„ ์œ ์ง€ํ• ์ง€ ๋ฌป๊ณ , ์—”์ง„ ๋ฉ”ํƒ€๋ฐ์ดํ„ฐ๋ฅผ ์ž‘์„ฑํ•ฉ๋‹ˆ๋‹ค. ๊ฒฐ๊ณผ: ๊ธฐ์กด ์ฝ˜ํ…์ธ ๊ฐ€ ๊ทธ๋Œ€๋กœ ์œ ์ง€๋œ v6 ๊ด€๋ฆฌ ๋ณผํŠธ, ์ดํ›„๋กœ๋Š” shardmind update๋ฅผ ์‚ฌ์šฉํ•  ์ˆ˜ ์žˆ์Šต๋‹ˆ๋‹ค. ๋‹ค์‹œ ํด๋ก ํ•  ํ•„์š” ์—†์Œ.

์ด์ „ ๋ณผํŠธ์—์„œ ๋งˆ์ด๊ทธ๋ ˆ์ด์…˜ (๋˜๋Š” ๋‹ค๋ฅธ ๋ณผํŠธ)

v5 ์ด์ „ ๋ฒ„์ „์˜ obsidian-mind๋ฅผ ์‚ฌ์šฉ ์ค‘์ด๊ฑฐ๋‚˜, ์™„์ „ํžˆ ๋‹ค๋ฅธ Obsidian ๋ณผํŠธ์—์„œ ๋งˆ์ด๊ทธ๋ ˆ์ด์…˜ํ•˜์‹œ๋‚˜์š”? /om-vault-upgrade ๋ช…๋ น์–ด๊ฐ€ ์ตœ์‹  ํ…œํ”Œ๋ฆฟ์œผ๋กœ ์ฝ˜ํ…์ธ ๋ฅผ ๋งˆ์ด๊ทธ๋ ˆ์ด์…˜ํ•ฉ๋‹ˆ๋‹ค:

# 1. ์ตœ์‹  obsidian-mind ํด๋ก 
git clone https://github.com/breferrari/obsidian-mind.git ~/new-vault

# 2. ์—์ด์ „ํŠธ๋กœ ์—ด๊ธฐ
cd ~/new-vault && claude   # ๋˜๋Š” codex, gemini

# 3. ์ด์ „ ๋ณผํŠธ๋ฅผ ์ง€์ •ํ•˜์—ฌ ์—…๊ทธ๋ ˆ์ด๋“œ ์‹คํ–‰
/om-vault-upgrade ~/my-old-vault

์—์ด์ „ํŠธ๊ฐ€ ์ˆ˜ํ–‰ํ•˜๋Š” ์ž‘์—…:

  1. ๊ฐ์ง€ โ€” ๋ณผํŠธ ๋ฒ„์ „ ํ™•์ธ (v1โ€“v3.x, ๋˜๋Š” obsidian-mind๊ฐ€ ์•„๋‹Œ ๋ณผํŠธ ์‹๋ณ„)
  2. ์ธ๋ฒคํ† ๋ฆฌ โ€” ๋ชจ๋“  ํŒŒ์ผ์„ ์‚ฌ์šฉ์ž ์ฝ˜ํ…์ธ , ์Šค์บํด๋“œ, ์ธํ”„๋ผ, ๋ฏธ๋ถ„๋ฅ˜๋กœ ๋ถ„๋ฅ˜
  3. ๋งˆ์ด๊ทธ๋ ˆ์ด์…˜ ๊ณ„ํš ์ œ์‹œ โ€” ๋ณต์‚ฌ, ๋ณ€ํ™˜, ๊ฑด๋„ˆ๋›ธ ํ•ญ๋ชฉ์„ ์ •ํ™•ํžˆ ๋ณด์—ฌ์คŒ
  4. ์Šน์ธ ํ›„ ์‹คํ–‰ โ€” ํ”„๋ก ํŠธ๋งคํ„ฐ ๋ณ€ํ™˜, ์œ„ํ‚ค๋งํฌ ์ˆ˜์ •, ์ธ๋ฑ์Šค ์žฌ๊ตฌ์ถ•
  5. ๊ฒ€์ฆ โ€” ๊ณ ์•„ ๋…ธํŠธ, ๊นจ์ง„ ๋งํฌ, ๋ˆ„๋ฝ๋œ ํ”„๋ก ํŠธ๋งคํ„ฐ ํ™•์ธ

๊ธฐ์กด ๋ณผํŠธ๋Š” ์ ˆ๋Œ€ ์ˆ˜์ •๋˜์ง€ ์•Š์Šต๋‹ˆ๋‹ค. --dry-run์„ ์‚ฌ์šฉํ•˜๋ฉด ์‹คํ–‰ ์—†์ด ๊ณ„ํš๋งŒ ๋ฏธ๋ฆฌ ๋ณผ ์ˆ˜ ์žˆ์Šต๋‹ˆ๋‹ค.

[!NOTE] obsidian-mind๋ฟ๋งŒ ์•„๋‹ˆ๋ผ ๋ชจ๋“  Obsidian ๋ณผํŠธ์—์„œ ์ž‘๋™ํ•ฉ๋‹ˆ๋‹ค. obsidian-mind๊ฐ€ ์•„๋‹Œ ๋ณผํŠธ์˜ ๊ฒฝ์šฐ, ์—์ด์ „ํŠธ๊ฐ€ ๊ฐ ๋…ธํŠธ๋ฅผ ์ฝ๊ณ  ์˜๋ฏธ์ ์œผ๋กœ ๋ถ„๋ฅ˜ํ•ฉ๋‹ˆ๋‹ค โ€” ์ž‘์—… ๋…ธํŠธ, ์ธ๋ฌผ, ์ธ์‹œ๋˜ํŠธ, 1:1, ์˜์‚ฌ๊ฒฐ์ •์„ ์˜ฌ๋ฐ”๋ฅธ ํด๋”๋กœ ๋ผ์šฐํŒ…ํ•ฉ๋‹ˆ๋‹ค.


๐Ÿ—บ๏ธ ๋กœ๋“œ๋งต

์ด์Šˆ์™€ ๋ฒ„๊ทธ ๋ณด๊ณ ๋ฅผ ํ™˜์˜ํ•ฉ๋‹ˆ๋‹ค. ์ฝ”๋“œ ๊ธฐ์—ฌ๋Š” ํ• ๋‹น์ œ๋กœ ์ง„ํ–‰๋ฉ๋‹ˆ๋‹ค. ์ด์Šˆ์— ๋Œ“๊ธ€๋กœ ์ž‘์—… ์˜์‚ฌ๋ฅผ ๋ฐํžˆ๊ณ , ํ• ๋‹น๋œ ๋’ค์— PR์„ ์—ด์–ด ์ฃผ์„ธ์š”. ๋ณธ์ธ์—๊ฒŒ ํ• ๋‹น๋˜์ง€ ์•Š์€ ์ด์Šˆ์— ๋Œ€ํ•œ PR์€ ๋ฆฌ๋ทฐ ์—†์ด ๋‹ซํž™๋‹ˆ๋‹ค. ์ž์„ธํ•œ ๋‚ด์šฉ์€ CONTRIBUTING.md๋ฅผ ์ฐธ๊ณ ํ•˜์„ธ์š”.


๐Ÿ™ ๋””์ž์ธ ์˜ํ–ฅ

  • kepano/obsidian-skills โ€” ๊ณต์‹ Obsidian ์—์ด์ „ํŠธ ์Šคํ‚ฌ
  • James Bedford โ€” ๋ณผํŠธ ๊ตฌ์กฐ ์ฒ ํ•™, AI ์ƒ์„ฑ ์ฝ˜ํ…์ธ  ๋ถ„๋ฆฌ
  • arscontexta โ€” description ํ•„๋“œ๋ฅผ ํ†ตํ•œ ์ ์ง„์  ๊ณต๊ฐœ, ์„ธ์…˜ ํ›…

๐Ÿ‘ค ์ €์ž

Brenno Ferrari ์ œ์ž‘ โ€” ๋ฒ ๋ฅผ๋ฆฐ์˜ ์‹œ๋‹ˆ์–ด iOS ์—”์ง€๋‹ˆ์–ด, Claude Code๋กœ ๊ฐœ๋ฐœ์ž ๋„๊ตฌ๋ฅผ ๊ตฌ์ถ•ํ•˜๊ณ  ์žˆ์Šต๋‹ˆ๋‹ค.


๐Ÿ“„ ๋ผ์ด์„ ์Šค

MIT