Skip to content

Commit c77c6c2

Browse files
nullvariantclaude
andauthored
docs: clarify karesansui philosophy vs Western minimalism (#113)
Add explicit explanation that karesansui is NOT efficiency-driven minimalism: - Add definition of karesansui (Japanese rock garden) in opening note - Add "What This Is Not" section contrasting the two philosophies - Western minimalism asks "What can we remove?" - Karesansui asks "What deserves to remain?" - Explicitly reject "If it works, it's fine" mentality - Emphasize that sand patterns and accents ARE the richness, not waste - Closing insight: "intentional richness that appears minimal" This prevents misreading the philosophy as mere simplification for efficiency. 🖥️ IDE: [Cursor](https://cursor.sh) 🔌 Extension: [Claude Code](https://claude.ai/download) Model-Raw: claude-opus-4-5-20251101 Co-authored-by: Claude Opus 4.5 <noreply@anthropic.com>
1 parent e220c70 commit c77c6c2

1 file changed

Lines changed: 29 additions & 0 deletions

File tree

extensions/git-id-switcher/docs/DESIGN_PHILOSOPHY.md

Lines changed: 29 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -2,6 +2,9 @@
22

33
*A design philosophy for Git ID Switcher*
44

5+
> **Note**: Karesansui (枯山水) is a Japanese rock garden--sand and stone representing mountains and water.
6+
> This philosophy is not efficiency-driven minimalism. It invests deeply in what appears simple.
7+
58
---
69

710
## Placing Stones
@@ -89,6 +92,32 @@ Lining up coverage badges is like hanging a scroll. They're there because they'r
8992

9093
---
9194

95+
## What This Is Not
96+
97+
Karesansui is not Western minimalism.
98+
99+
Western minimalism asks: "What can we remove?"
100+
Karesansui asks: "What deserves to remain?"
101+
102+
Western minimalism removes to save cost and effort.
103+
Karesansui invests enormously to *appear* simple.
104+
105+
In a real karesansui, sand patterns require daily raking.
106+
In this codebase, "invisible quality" requires continuous investment.
107+
The "empty" space is the most intentional part.
108+
What looks effortless demands the most effort.
109+
110+
"Eliminate waste" misses the point entirely.
111+
"If it works, it's fine" has no place here.
112+
In this garden, sand patterns and accents *are* the richness--not waste to be cut.
113+
114+
The goal is not efficiency or quick results.
115+
The goal is depth disguised as simplicity.
116+
117+
Karesansui is intentional richness that *appears* minimal.
118+
119+
---
120+
92121
## Origin
93122

94123
2003\. CSS Zen Garden.

0 commit comments

Comments
 (0)