Claude Code Patterns Obsidian Vault: Sub-agents Hooks 2026

Claude code patterns obsidian vault là 3 advanced pattern Claude Code apply cho vault Obsidian: sub-agents (delegate task cho specialized agent), hooks (event-driven automation), custom slash commands (skill personalization). 3 pattern này biến vault từ knowledge base thành workspace tự động hoá end-to-end cho developer.

Bài này deep-dive 3 pattern, ví dụ thực tế cho vault Obsidian, integration với AgriciDaniel skill ecosystem, anti-patterns cần tránh. Bài pillar Obsidian + Claude Code cover integration tổng quát, bài này focus advanced workflow.

Sub-agents Là Gì Và Khi Nào Dùng?

Sub-agent là pattern Claude Code spawn agent con với isolated context để xử lý task chuyên biệt, return kết quả cho main agent. Khác với main session phải hold full context, sub-agent có context riêng, không pollute main conversation.

3 use case chính cho vault Obsidian. Một, research task: spawn general-purpose sub-agent search 5+ sources online, return structured summary, main agent ingest vào vault. Hai, audit task: spawn seo-content hoặc blog-reviewer agent đọc note, return quality report. Ba, refactor task: spawn agent batch-rename frontmatter fields qua 200 notes, không tốn main context.

Pattern hiệu quả: sub-agent cho exploration, main agent cho synthesis. Sub-agent search 10 sources, main agent đọc summary và quyết định next step. Tránh anti-pattern delegate decision-making cho sub-agent (main agent mới biết user intent đầy đủ).

Cluster Obsidian + Claude Code có pillar overview, 3-layer architecture, /wiki bootstrap, capture trio, /wiki-query 3 modes, /wiki-lint + /wiki-fold cover skill primary. Sub-agent là layer above skill, orchestrate skill multiple cho workflow phức tạp.

Anti-pattern. Spawn sub-agent cho task <2 phút (overhead lớn hơn benefit). Pass full context cho sub-agent (defeats purpose). Spawn nhiều sub-agent serialized (parallel mới có lợi).

Hooks Hoạt Động Ra Sao Cho Vault?

Hooks là event-driven script Claude Code execute tự động trên specific event. 8 event types chính: SessionStart, SessionEnd, UserPromptSubmit, PreToolUse, PostToolUse, Stop, SubagentStop, PreCompact. Hooks defined trong ~/.claude/settings.json hoặc project CLAUDE.md.

Sample 3 hook hữu ích cho vault.

Hook 1, SessionStart auto-load context. Mỗi khi mở Claude Code trong vault folder, hook đọc wiki/hot.md và inject vào system context. Result: agent biết recent context không cần manual prompt.

{
  "hooks": {
    "SessionStart": [
      {
        "type": "shell",
        "command": "cat $VAULT_PATH/wiki/hot.md 2>/dev/null || echo ''"
      }
    ]
  }
}

Hook 2, PostToolUse refresh index. Mỗi khi Write tool tạo file mới trong vault, hook trigger /wiki-lint –quick scan để verify frontmatter clean và update index.md.

Hook 3, Stop archive session. Khi session kết thúc, hook chạy script append session summary vào wiki/log.md và update wiki/hot.md với key events. Kết hợp với /wiki-fold monthly maintenance giữ log.md clean.

Setup hook cho vault. Tạo .claude/settings.json trong root vault, define hook cho 3 event chính (SessionStart, PostToolUse, Stop). Test hook qua /hooks-debug nếu Claude Code support, hoặc echo log vào file để verify trigger.

Performance consideration. Hook script phải chạy <2s, không block UI. Heavy task (lint full vault) chỉ run async qua background process. Hook chỉ trigger nhanh job (read file, update timestamp, send signal).

Anti-pattern. Hook chạy LLM call trong inline (chậm, tốn token). Hook write to vault trong PreToolUse (race condition). Hook depend on external service không có timeout.

Custom Slash Commands Hoạt Động Ra Sao?

Custom slash command là skill personal user định nghĩa trong ~/.claude/skills/[skill-name]/SKILL.md. Skill được Claude Code load tự động và invoke qua /skill-name trong prompt.

Cấu trúc skill cơ bản. SKILL.md với frontmatter (name, description, keywords) + instruction body. Optional: scripts/ folder cho supporting code, references/ cho documentation skill load on-demand.

Sample skill /daily cho vault.

---
name: daily
description: Generate daily note với template từ frontmatter + recent context
---

Workflow:
1. Đọc wiki/hot.md cho recent context
2. Đọc daily-notes/ folder, find latest note
3. Tạo note mới today với template:
   - Frontmatter: date, type=daily, tags
   - Section: tasks today, learn today, blockers
4. Pre-fill từ context: open tasks từ note hôm qua
5. Save và print path

10 skill personal mình production-ready cho vault. /daily (note hôm nay), /weekly-review (rollup tuần), /audit-vault (run /wiki-lint full + report), /entity-add (capture entity mới với template), /concept-add (capture concept với references), /research-start (init research project structure), /publish-prep (chuẩn bị blog draft thành publish-ready), /backup-vault (snapshot vault trước thao tác risky), /export-canvas (canvas → PNG cho social), /wiki-stats (thống kê vault size, growth, orphan rate).

Pattern phối hợp với AgriciDaniel skill. Custom skill /daily có thể call /save (capture session note), /wiki-ingest (pull external source), /wiki-query (recall context). Custom skill là orchestration layer above primary skill.

Time investment. Setup 1 custom skill mất 30-60 phút write + test. Reuse hàng ngày, ROI sau 1 tuần. 10 skill personal save mình ~5 giờ/tuần boilerplate work.

Anti-pattern. Skill quá generic (overlap với existing). Skill chỉ wrap 1 command đơn giản (alias đủ). Skill chứa secret hoặc credential (security risk).

Pattern Combination Workflow End-to-End Ra Sao?

3 pattern combine thành workflow tự động hoá complete. Sample case: ingest research article và auto-archive.

Workflow flow.

1. User tap /save https://article.com/research.
2. Slash command /save trigger /wiki-ingest skill (AgriciDaniel).
3. Pre-Hook PreToolUse fire: spawn sub-agent general-purpose extract article content qua Firecrawl.
4. Sub-agent return cleaned markdown.
5. Main agent route content qua /defuddle skill (token reduce 40-60%).
6. Output write vào wiki/sources/article-X.md.
7. PostToolUse hook fire: trigger /wiki-lint –quick để verify frontmatter clean.
8. Hook update wiki/hot.md với entry mới.
9. Stop hook fire: append summary entry vào wiki/log.md.
10. Custom skill /weekly-review pickup new entry sau cuối tuần cho rollup.

Total user action: 1 prompt. Total automation: 9 step. Time: <30s end-to-end. Mình apply pattern này hàng ngày capture 5-15 article, không tốn manual triage.

Pattern khác hữu ích. Daily ritual: SessionStart hook chạy /daily slash command auto. Weekly ritual: cron + Claude Code chạy /weekly-review mỗi sáng thứ Hai. Monthly ritual: cron chạy /wiki-fold + /wiki-lint full report.

Performance trade-off. Pattern combination tốn ~$0.10-0.30 mỗi run (LLM cost cho sub-agent + main). Compare với manual workflow (~$0 cost nhưng 30-60 phút time), automation justify cho task lặp lại >5 lần/tuần.

Use Case Cụ Thể Nào Cho Developer?

Mình apply 4 advanced workflow điển hình cho vault production.

Workflow 1, content research pipeline. /save URL → sub-agent fetch content → /defuddle → /wiki-ingest → frontmatter auto-fill → archive sources/. Thời gian: 30s. Frequency: 10-15 article/tuần.

Workflow 2, daily note automation. SessionStart hook chạy /daily → tạo note today với template + recent context → pre-fill tasks từ hôm qua. Thời gian: 5s. Frequency: mỗi sáng.

Workflow 3, weekly review automation. Cron sáng Chủ nhật chạy /weekly-review → spawn sub-agent đọc log.md tuần → synthesize key events + insights → write weekly-reviews/YYYY-WW.md. Thời gian: 2 phút. Frequency: weekly.

Workflow 4, vault audit + cleanup. /audit-vault → spawn sub-agent run /wiki-lint full + check orphan rate + dead link → return report → suggest action items. Thời gian: 5 phút. Frequency: bi-weekly.

KPI track. Automation hours saved/week (target 5+ hours). Slash command trigger count (target 50+/week shows active use). Hook trigger error rate (target <1%, debug nếu cao). Mình personal save ~6 giờ/tuần với 4 workflow trên.

Câu Hỏi Thường Gặp

Cần version Claude Code nào để dùng sub-agents?

Sub-agent feature có từ Claude Code v0.2+ (cuối 2024). Update Claude Code latest version qua npm hoặc binary update. Check version: claude --version. Bài pillar Claude Code cover release timeline.

Hooks có debug được không?

Có. Set environment variable CLAUDE_HOOK_DEBUG=1 trước khi launch Claude Code, hoặc dùng claude --hook-debug. Hook trigger sẽ log vào stderr với timestamp. Test hook trước khi commit vào settings để tránh break session.

Custom slash command có upload lên git không?

Có. Skill folder ở ~/.claude/skills/[name]/ là plain markdown + script, có thể commit Git. Repository như AgriciDaniel claude-obsidian là community example. Share skill team qua Git, version control changes.

Sub-agent có nested được không (sub-agent spawn sub-agent)?

Có ở mức 2 level. Main agent spawn sub-agent, sub-agent spawn 1 nested sub-agent. Beyond 2 level overhead lớn hơn benefit. Refactor logic thay vì nest deep.

Hook có security risk không?

Có nếu hook execute command từ user input không sanitize. Best practice: hook chỉ execute fixed script trong vault (.claude/scripts/), không eval string trực tiếp. Review hook code như review production code.

Pattern combination có overhead nhiều không?

Có ở mức acceptable. End-to-end workflow tốn ~$0.10-0.30 LLM cost + 10-30s wallclock. Compare với manual flow (free nhưng 30-60 phút), automation worth cho task >5 lần/tuần. Task <2 lần/tuần dùng manual.

Bạn Setup Advanced Pattern Như Thế Nào?

Tuần 1, tạo 2 hook đầu tiên. SessionStart load hot.md, PostToolUse run lint quick. Test 1 tuần observe error rate. Tuần 2, tạo 1 custom skill /daily. Setup template, test 1 tuần. Tuần 3, integrate hook + skill: hook trigger /daily auto SessionStart. Tuần 4, add sub-agent cho task complex (research, audit). Build từng layer, không setup tất cả 1 lần.

Tham khảo cluster Obsidian + Claude Code: pillar setup, Karpathy LLM Wiki story, 3-layer architecture, /wiki bootstrap, capture trio, /wiki-query 3 modes, maintenance, visual layer, 11 skills overview. Bài này (E-1) là spoke advanced patterns, complement cluster D primary skill.

Tài liệu tham khảo bên ngoài

• Claude Code Sub-agents (Anthropic official).
• Claude Code Hooks (Anthropic official).
• Custom slash commands (Anthropic official).