From 53343bea85fe5585f16661939aef293a2e9fcdc2 Mon Sep 17 00:00:00 2001 From: Claude Date: Sun, 19 Jul 2026 22:47:11 +0000 Subject: [PATCH] add ai session memory: CLAUDE.md + .claude/memory/ MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit absorb core ideas from obsidian-knowledge-brain v4.0 (lightweight version): - CLAUDE.md: always-loaded session protocol (start/work/收尾) - .claude/memory/pitfalls.md: fixed bugs, seeded from vault warnings - .claude/memory/decisions.md: final adopted solutions - anti-pollution rules: final solutions only, dedupe by seen+1 Co-Authored-By: Claude Fable 5 Claude-Session: https://claude.ai/code/session_01FdhGpX3ZBYu2pWv6FbiRwR --- .claude/memory/decisions.md | 34 ++++++++++++++++ .claude/memory/pitfalls.md | 32 +++++++++++++++ CLAUDE.md | 79 +++++++++++++++++++++++++++++++++++++ 3 files changed, 145 insertions(+) create mode 100644 .claude/memory/decisions.md create mode 100644 .claude/memory/pitfalls.md create mode 100644 CLAUDE.md diff --git a/.claude/memory/decisions.md b/.claude/memory/decisions.md new file mode 100644 index 0000000..f4c8558 --- /dev/null +++ b/.claude/memory/decisions.md @@ -0,0 +1,34 @@ +# 🦚 Decisions / 定案 ➜ final adopted solutions, don't re-discuss + +``` +format (one entry ≤ 6 lines): + +## [scope] short title + decision: what adopted + why: key reason + date: yyyy-mm +``` + + +## [lab.vpn] wireguard + netmaker + decision: vpn use wireguard, manage by netmaker + why: simple + fast, see card LAB.Net.VPN.Choose + date: old + + +## [rv.ha] home assistant use supervised on rpi4 ubuntu22 + decision: ha os choose supervised, not haos/container + why: need host os control + addons both + date: old + + +## [rv.solar] panels connect parallel not series + decision: solar panel parallel connect + why: one panel broken ➜ no affect whole system + date: old + + +## [ai.memory] absorb obsidian-knowledge-brain ideas, not whole skill + decision: lightweight CLAUDE.md + .claude/memory/ only + why: v4.0 full skill = 20 scripts + bootstrap, too heavy for vault repo + date: 2026-07 diff --git a/.claude/memory/pitfalls.md b/.claude/memory/pitfalls.md new file mode 100644 index 0000000..4ce78a9 --- /dev/null +++ b/.claude/memory/pitfalls.md @@ -0,0 +1,32 @@ +# 🦚 Pitfalls / 坑 ➜ fixed bugs, never step twice + +``` +format (one entry ≤ 6 lines): + +## [scope] short title + problem: what broke + cause: root cause + fix: final fix + seen: 1 ➜ same pitfall again = seen+1, NO new entry +``` + + +## [net.vxlan] ros + fgt vxlan port mismatch + problem: mikrotik ↔ fortigate vxlan not talk + cause: default port diff ➜ ros.8472, fgt.4789 + fix: change ros vxlan & vtep port to 4789 + seen: 1 + + +## [rpi.nic] startech dual-usb nic no balance-rr + problem: rpi nic bond balance-rr not work + cause: startech dual-usb nic not support balance-rr + fix: use 802.3ad bond instead + seen: 1 + + +## [rv.power] bmv-712 battery monitor not accurate + problem: capacity reading crazy, setting crazy + cause: device design, not config error + fix: tell capacity by voltage table, skip bmv-712 + seen: 1 diff --git a/CLAUDE.md b/CLAUDE.md new file mode 100644 index 0000000..3e111de --- /dev/null +++ b/CLAUDE.md @@ -0,0 +1,79 @@ +# 🦚 CLAUDE.md ➜ AI Session Memory / AI 会话记忆 + +``` +🟢 Why + + every ai session forget everything when it end + this file + .claude/memory/ make ai remember + + 每次 AI 会话结束就失忆 ➜ 用这套文件让它跨会话记住 +``` + + +## 🟢 Repo Is What + +``` +this repo = obsidian card vault ➜ homelab + rv + it knowledge + + Readme.md ➜ cards link center + Cards-AIO ➜ cards real path + ◼︎X-xxx ➜ notes need organize + .claude/ ➜ ai memory (this system) + +card name format: + 🧬0️⃣0️⃣0️⃣0️⃣-A0z9 🐬 A.B.C ➜ xxxx + Level_1 + Level_2 + Category-Icon + Category-Abbr + Card Name + +status icon: + ✔️ done ✅ verified 💯 best 🐶 draft ✖️ todo ❌ no/fail + ❗️ warning ➜ important warning repeat 3 times in code block +``` + + +## 🟢 Session Start / 会话开始 + +``` +1. read .claude/memory/pitfalls.md ➜ known pitfalls, don't step twice +2. read .claude/memory/decisions.md ➜ final decisions, don't re-discuss +3. then start work +``` + + +## 🟢 Session Work / 会话中 + +``` +fix a bug / find a pitfall ➜ append to .claude/memory/pitfalls.md NOW (立刻记) +make a final decision ➜ remember it, write at session end (收尾时记) +``` + + +## 🟢 Session End / 收尾 + +``` +user say "收尾" or "wrap up" ➜ do this: + +1. extract final decisions from this session ➜ .claude/memory/decisions.md +2. check pitfalls all recorded +3. reply short summary: what recorded, what changed +``` + + +## 🟢 Anti-Pollution Rules / 防污染 ❗️ + +``` +❗️ only record FINAL adopted solutions. no exploring dead-ends ❗️ +❗️ same pitfall happen again ➜ seen+1 on old entry. NO new entry ❗️ +❗️ unresolved problem ➜ NOT record. stay in your head or todo ❗️ + +keep entries short. one entry ≤ 6 lines. +write style follow this vault: terse + code block + bilingual ok +``` + + +## 🟢 Repo Edit Rules + +``` +- keep card name format 🧬 when create/rename cards +- keep terse code-block style, don't rewrite user's notes into long prose +- important warning ➜ ❗️ line repeat 3 times, same as vault style +```