Skip to content
Draft
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
34 changes: 34 additions & 0 deletions .claude/memory/decisions.md
Original file line number Diff line number Diff line change
@@ -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
32 changes: 32 additions & 0 deletions .claude/memory/pitfalls.md
Original file line number Diff line number Diff line change
@@ -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
79 changes: 79 additions & 0 deletions CLAUDE.md
Original file line number Diff line number Diff line change
@@ -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
```