walking-through-the-grove

漫步林间

Grove 生态系统的命名仪式。当你需要找到一个 合适 的名字时，就用这个流程——不只是巧妙的双关，而是一个真正属于这片森林的名字。

何时启用

• 为 Grove 创建新的服务、功能或概念时
• 某个名称感觉不太对，需要重命名时
• grove-ui-design 技能需要为新的 UI 命名时
• 任何时候，只要你要为 Grove 生态系统添加新内容

流程

这是一段 旅程，不是待办清单。慢慢来。

步骤 1：阅读命名理念

# Always start here
cat docs/philosophy/grove-naming.md

通读整篇文档。不要略读，让内容慢慢沉淀：

• “一片由声音组成的森林。每位用户都是 Grove 中的一棵树。”
• 名称不是品牌塑造，而是生态系统的语言
• 生长、庇护、连接
• 不是直接围绕树木，而是围绕森林 之中及周围 发生的事

步骤 2：创建草稿

为你的旅程创建一个 Markdown 文件：

# Create: docs/philosophy/naming-research/{concept}-naming-journey.md

在这个草稿中尽情记录你的思考。包括：

• ASCII 艺术图示
• 你在问自己的问题
• 被否决的想法及原因
• 灵光乍现的时刻

步骤 3：描绘 Grove

在草稿中画出 Grove。ASCII 艺术图很有帮助：

                              ☀️
                           🌲   🌲   🌲
                        🌲    🌳    🌲
    ═══════════════════════════════════════════════
               ROOTS CONNECT BENEATH
                  (mycelium network)

在图示中标出已有的服务：

• Meadow 在哪里？（开放的社交空间）
• Heartwood 在哪里？（核心身份）
• Ivy 在哪里？（攀援、连接）
• Pantry 在哪里？（温暖的厨房储物柜）

步骤 4：问“这究竟是什么？”

不要先问“它该放在哪里？”。先问：

从根本上说，它是什么？

• 是一个地方吗？（Meadow、Nook、Clearing）
• 是一个物件或过程吗？（Amber、Bloom、Patina）
• 是树木的一部分吗？（Foliage、Heartwood、Rings）
• 是一种连接吗？（Ivy、Mycelium、Reeds）

它在用户的生活中发挥什么作用？

• 保护？（Shade、Patina）
• 连接？（Ivy、Meadow、Reeds）
• 储存？（Amber、Trove）
• 指引？（Waystone、Trails）
• 创造？（Terrarium、Foliage）

它应该唤起什么情绪？

• 温暖？
• 安全？
• 探索？
• 社群？
• 隐私？

步骤 5：漫步森林

想象自己是一位漫步在 Grove 中的用户。把这段经历写进草稿：

## Walking Through...

I enter the grove. I see...
I walk past the Meadow where others gather.
I find my tree—my blog, my space.
I check my Rings (private growth).
I see my Foliage (how others see me).

Now I need [THE NEW THING]. Where do I find it?
What does it look like? Who's there? How does it feel?

让这个场景引导你找到名字。

步骤 6：生成候选名称

根据你的漫步经历，列出 5-10 个候选名称。每个名称都要：

**[Name]** - `[name].grove.place`

- What it means in nature
- Why it fits this concept
- The vibe/feeling
- Potential issues

步骤 7：测试标语

一个好的 Grove 名称应该能自然地补全这个句子：

“[名称] 是你 **___** 的地方。”

或者：

“[名称] 就是 **___**。”

如果你写不出一句富有诗意的短句，这个名字可能不合适。

步骤 8：撰写词条

找到名字后，按照 Grove 风格撰写词条：

## [Name]

**[Tagline]** · `[domain].grove.place`

[2-3 sentences explaining what this thing IS in the real world—
the natural metaphor. Then 2-3 sentences explaining what it does
in Grove. End with the feeling it should evoke.]

_[A poetic one-liner in italics]_

步骤 9：检查冲突

最终确定之前：

• 在代码库中搜索这个名称
• 检查子域名概念是否与现有服务冲突
• 确保它与现有名称不会太相似
• 考虑大声说出来时的感觉

步骤 10：实施

更新所有文件：

1. docs/grove-naming.md — 添加完整词条
2. docs/philosophy/grove-naming.md — 更新源文件（用于生成清单）
3. services/grove-router/src/index.ts — 占用子域名
4. plant/src/routes/api/check-username/+server.ts — 保留用户名
5. 如适用，更新 Workshop 页面
6. 如适用，更新图标
7. 重新生成 GroveTerm 清单 — 运行 scripts/generate/grove-term-manifest.ts，用新术语重新构建 grove-term-manifest.json。这个清单为所有 GroveTerm 组件（GroveTerm、GroveSwap、GroveText 等）提供支持，让它们根据用户的 Grove Mode 设置，在标准术语和 Grove 术语之间自动切换。

---

理念提醒

摘自命名文档：

“这些名称有共同之处：自然、庇护、生长之物。但它们都不是直接 围绕 树木。它们描述的是森林之中及周围发生的事。”

“Grove 是这个地方。这些是你在那里找到的东西。”

这个名字应该让人觉得 理所当然——仿佛它一直都在那里，只等着被发现。

---

示例旅程：寻找“Porch”

问题：我们需要为支持工单取一个名字。

最初的尝试（已否决）：

• Echo → “echo chamber”（回音室）让人觉得像是在对着虚空大喊，没人倾听
• Feather、Flare、Dove → 这些名字都和_发送_有关
• 但支持不是关于发送，而是关于_建立联系_

这段旅程：

我在树林里。我的树出了问题，需要帮助。 Waystone 为我提供自助指南。Clearing 为我显示状态。 但我需要真正_和某人交谈_。

我该怎么办？

我走向……一间小木屋。那里有个门廊。有人在那儿。 我坐下来。我们聊了聊发生的事。

恍然大悟： 支持不是工单系统，而是门廊上的交谈。

名字： Porch

林中小木屋的门廊。你走上台阶，坐下来。 林地守护者走出来。你们交谈。

“来门廊上坐坐。我们一起想办法解决。”

---

与其他技能集成

grove-ui-design

当 grove-ui-design 技能遇到需要命名的内容时：

1. 暂停 UI 工作
2. 调用此技能
3. 完成命名旅程
4. 带着新名字继续 UI 工作

这样可以让命名经过深思熟虑，而不是仓促决定。

grove-documentation

找到合适的名字后，你需要撰写其描述。遇到以下情况时，请调用 grove-documentation 技能：

1. 撰写 docs/grove-naming.md 中的条目
2. 构思标语
3. 撰写诗意的一句话描述

命名文档中的条目应遵循 Grove 的表达风格：温暖、直接，避免 AI 套话。完整指南请参阅 grove-documentation 技能。

---

旅程文件神圣不可弃

请保留你的命名旅程文件。它们记录了我们对 Grove 的思考方式：

docs/philosophy/naming-research/
  grove-journey.md                    ← The original Porch discovery
  {feature}-naming-journey.md         ← All naming journeys

这些文件会成为 Grove 故事的一部分。