๐Ÿ“˜ github.com/claude-code-expert โ€” ํด๋กœ๋“œ ์ฝ”๋“œ ๋งˆ์Šคํ„ฐ (ํ•œ๋น›๋ฏธ๋””์–ด ์„œ์  ๊ณต์‹ ๋ฆฌํฌ์ง€ํ† ๋ฆฌ) | ๐Ÿบ www.brewnet.dev โ€” ์…€ํ”„ ํ˜ธ์ŠคํŒ… ํ™ˆ์„œ๋ฒ„ ์ž๋™ ๊ตฌ์ถ• ์˜คํ”ˆ์†Œ์Šค
shanraisshan
claude-code-best-practice
โ˜… 19.7k stars
github.com/shanraisshan/claude-code-best-practice
VoltAgent
awesome-claude-code-subagents
โ˜… 13k stars
github.com/VoltAgent/awesome-claude-code-subagents
๊ธฐ๋ณธ ์„ฑ๊ฒฉ
ํฌ์ง€์…”๋‹
์›์น™ยท์ฒ ํ•™ Best Practice ๊ฐ€์ด๋“œ
๋ฒ ์ŠคํŠธํ”„๋ž™ํ‹ฐ์Šค + ์‹ค์ „ ํŒ ๋ชจ์Œ
์ฆ‰์‹œ์‚ฌ์šฉ ์—์ด์ „ํŠธ ์ปฌ๋ ‰์…˜
๋ฐ”๋กœ ์„ค์น˜ํ•ด์„œ ์“ฐ๋Š” ์„œ๋ธŒ์—์ด์ „ํŠธ ๋ผ์ด๋ธŒ๋Ÿฌ๋ฆฌ
์ €์ž
Shan Raisshan (Claude Community Ambassador, Certified Architect)
VoltAgent ํŒ€ + ์ปค๋ฎค๋‹ˆํ‹ฐ ๊ธฐ์—ฌ์ž 400๋ช…+
์—…๋ฐ์ดํŠธ ๋ฐฉ์‹
206 ์ปค๋ฐ‹ / Boris Cherny ํŠธ์œ— ์‹ค์‹œ๊ฐ„ ๋ฐ˜์˜
409 ์ปค๋ฐ‹ / PR๋กœ ์—์ด์ „ํŠธ ๊ณ„์† ์ถ”๊ฐ€ ์ค‘
์„œ๋ธŒ์—์ด์ „ํŠธ ์ปค๋ฒ„๋ฆฌ์ง€
์—์ด์ „ํŠธ ์ˆ˜
์†Œ์ˆ˜ ์˜ˆ์‹œ ์ค‘์‹ฌ โ€” ํŒจํ„ด ์„ค๋ช… ์œ„์ฃผ
127๊ฐœ+ โ€” 9๊ฐœ ์นดํ…Œ๊ณ ๋ฆฌ, 127+ ์—์ด์ „ํŠธ ๋ณด์œ 
์นดํ…Œ๊ณ ๋ฆฌ
๋ฏธ๋ถ„๋ฅ˜ ๊ฐœ๋…๋ณ„ ์„ค๋ช…
Core Dev ยท Lang ยท Infra ยท QA/Sec ยท Data/AI
DevExp ยท Domains ยท Biz ยท Meta (9๊ฐœ)
๋ชจ๋ธ ์ž๋™ ๋ผ์šฐํŒ…
์–ธ๊ธ‰ ์—†์Œ
์ž๋™ ๋ชจ๋ธ ์„ ํƒ Opus / Sonnet / Haiku ํƒœ์Šคํฌ๋ณ„ ์ž๋™ ๋ฐฐ์ •
Tool ๊ถŒํ•œ ์„ค๊ณ„
์›์น™ ์„ค๋ช… ("์ตœ์†Œ ๊ถŒํ•œ ๋ถ€์—ฌ")
4๋‹จ๊ณ„ ๊ถŒํ•œ ๋ถ„๋ฆฌ Read-only / Research / Code Writer / Doc
์„ค์น˜ ๋ฐฉ๋ฒ•
์ˆ˜๋™ ๋ณต์‚ฌ ~/.claude/agents/ ์„ค๋ช…
4๊ฐ€์ง€ ์„ค์น˜๋ฒ• Plugin marketplace / ์ˆ˜๋™ / ์Šคํฌ๋ฆฝํŠธ / agent-installer
์˜ค์ผ€์ŠคํŠธ๋ ˆ์ด์…˜ & ์›Œํฌํ”Œ๋กœ์šฐ
์˜ค์ผ€์ŠคํŠธ๋ ˆ์ด์…˜ ํŒจํ„ด
Command โ†’ Agent โ†’ Skill ๋ช…ํ™•ํ•œ 3๋‹จ๊ณ„ ํŒจํ„ด
SVG ๋‹ค์ด์–ด๊ทธ๋žจ + GIF ๋ฐ๋ชจ ํฌํ•จ
meta ์นดํ…Œ๊ณ ๋ฆฌ multi-agent-coordinator ๋“ฑ ์ œ๊ณต
๋ฉ€ํ‹ฐ์—์ด์ „ํŠธ
Agent Teams (beta) tmux + git worktrees ๋ณ‘๋ ฌ ๊ฐœ๋ฐœ ๊ฐ€์ด๋“œ
meta-orchestration ์นดํ…Œ๊ณ ๋ฆฌ ๋‚ด ์—์ด์ „ํŠธ๋กœ ์ œ๊ณต
์Šค์ผ€์ค„๋ง
/loop Scheduled Tasks โ€” ์ตœ๋Œ€ 3์ผ ๋ฐ˜๋ณต ์‹คํ–‰ ๊ฐ€์ด๋“œ + ๊ตฌํ˜„ ์˜ˆ์‹œ
๋ฏธ์ œ๊ณต
์‹ค์ „ ํŒ & ๋…ธํ•˜์šฐ
์šด์˜ ํŒ ์ˆ˜
84๊ฐœ ํŒ Boris Cherny (Claude Code ์ฐฝ์‹œ์ž) ์ง์ ‘ ์ธ์šฉ
์—†์Œ ์„ค์น˜ยท์‚ฌ์šฉ๋ฒ• ์œ„์ฃผ
์•ˆํ‹ฐํŒจํ„ด ๋ช…์‹œ
"์ž‘์€ ํƒœ์Šคํฌ์—” vanilla CC๊ฐ€ ๋‚ซ๋‹ค" ๋“ฑ ์–ธ์ œ ์“ฐ์ง€ ๋ง์ง€ ๋ช…ํ™•ํžˆ ๊ธฐ์ˆ 
์—†์Œ
์ปจํ…์ŠคํŠธ ๊ด€๋ฆฌ
/compact ์‹œ์ , /clear ์ „๋žต, ์ปจํ…์ŠคํŠธ ๋“œ๋ฆฌํ”„ํŠธ ๋ฐฉ์ง€ ํŒ ํฌํ•จ
context-manager ์—์ด์ „ํŠธ ์ œ๊ณต (์‹คํ–‰ ๋‹จ์œ„)
์„ค์ • & ์ƒํƒœ๊ณ„ ์—ฐ๊ณ„
CLAUDE.md ๊ฐ€์ด๋“œ
7๊ฐœ ํŒ + 200์ค„ ์ดํ•˜ ์›์น™ + ์‹ค์ „ ์˜ˆ์‹œ + @path import ํŒจํ„ด
๊ธฐ๋ณธ CLAUDE.md๋งŒ ํฌํ•จ
Hooks
5๊ฐœ ํŒ + PreToolUse / PostToolUse / Stop hook ํŒจํ„ด ์ƒ์„ธ ์„ค๋ช…
์—†์Œ
MCP ํ†ตํ•ฉ
Best Practice ๋ฌธ์„œ + .mcp.json ๊ตฌํ˜„ ์˜ˆ์‹œ ํฌํ•จ
mcp-developer ์—์ด์ „ํŠธ 1๊ฐœ ์ œ๊ณต
Beta ๊ธฐ๋Šฅ ์ปค๋ฒ„
Channels / Code Review / Voice Dictation / Remote Control / Sandboxing ์ „๋ถ€ ๋ฌธ์„œํ™”
์—†์Œ
ํƒ€ ํ”„๋ ˆ์ž„์›Œํฌ ๋น„๊ต
Superpowers / GSD / BMAD / OpenSpec ๋“ฑ 8๊ฐœ ๋น„๊ตํ‘œ ๋‚ด์žฅ
์—†์Œ
์„œ๋ธŒ์—์ด์ „ํŠธ ์นดํƒˆ๋กœ๊ทธ ๋„๊ตฌ
์—†์Œ
/subagent-catalog search / fetch / list / invalidate ์ปค๋งจ๋“œ
์ปค๋ฎค๋‹ˆํ‹ฐ
์—†์Œ
Discord ์ฑ„๋„ ์šด์˜ ์ค‘
shanraisshan์„ ์จ์•ผ ํ•  ๋•Œ
์„œ๋ธŒ์—์ด์ „ํŠธ ๊ฐœ๋…ยท์„ค๊ณ„ ์›์น™์„ ๋ฐฐ์šฐ๊ณ  ์‹ถ์„ ๋•Œ
์˜ค์ผ€์ŠคํŠธ๋ ˆ์ด์…˜ ์•„ํ‚คํ…์ฒ˜๋ฅผ ์ง์ ‘ ์„ค๊ณ„ํ•  ๋•Œ
Beta ๊ธฐ๋Šฅ (Agent Teams, Channels ๋“ฑ) ํ™œ์šฉํ•  ๋•Œ
Hooks ยท MCP ยท CLAUDE.md ์„ธํŒ…์„ ์ตœ์ ํ™”ํ•  ๋•Œ
Claude Code ์ฑ… ์ง‘ํ•„ ๋ ˆํผ๋Ÿฐ์Šค๋กœ ํ™œ์šฉํ•  ๋•Œ
VoltAgent๋ฅผ ์จ์•ผ ํ•  ๋•Œ
์ฆ‰์‹œ ์“ธ ์ˆ˜ ์žˆ๋Š” ์—์ด์ „ํŠธ๊ฐ€ ํ•„์š”ํ•  ๋•Œ
ํŠน์ • ์–ธ์–ด/ํ”„๋ ˆ์ž„์›Œํฌ ์ „๋ฌธ๊ฐ€ ์—์ด์ „ํŠธ ํ•„์š”์‹œ
์ž๋™ ๋ชจ๋ธ ๋ผ์šฐํŒ… (Opus/Sonnet/Haiku) ์›ํ•  ๋•Œ
Plugin marketplace๋กœ ํŒ€ ์ „์ฒด์— ๋ฐฐํฌํ•  ๋•Œ
์‹ค์Šต ์˜ˆ์ œยท์ฝ”๋“œ ์†Œ์Šค๋กœ ํ™œ์šฉํ•  ๋•Œ
์กฐํ•ฉ ์ถ”์ฒœ โ†’ shanraisshan์œผ๋กœ ๊ตฌ์กฐ์™€ ์ฒ ํ•™์„ ์žก๊ณ , VoltAgent๋กœ ์ฆ‰์‹œ ์‚ฌ์šฉ ๊ฐ€๋Šฅํ•œ ์—์ด์ „ํŠธ๋ฅผ ๊ฐ€์ ธ๋‹ค ์“ฐ๋Š” ๊ฒƒ์ด ์ตœ์  ยท ์‹ค์ „ ํด๋กœ๋“œ ์ฝ”๋“œ ๊ฐœ๋ฐœํ•˜๊ธฐ