ubiquitous-language

Ubiquitous Language

从当前 conversation 中提取并形式化 domain terminology，整理成一致 glossary，并保存到本地文件。

Process

1. Scan the conversation，寻找 domain-relevant nouns、verbs 和 concepts
2. Identify problems：
   • 同一个词被用于不同 concepts（ambiguity）
   • 不同词被用于同一个 concept（synonyms）
   • 模糊或 overloaded terms
3. Propose a canonical glossary，对 term 选择保持 opinionated
4. Write to UBIQUITOUS_LANGUAGE.md，在 working directory 中使用下面格式
5. Output a summary，在 conversation 中内联总结

Output Format

写一个 UBIQUITOUS_LANGUAGE.md 文件，结构如下：

# Ubiquitous Language
 
## Order lifecycle
 
| Term        | Definition                                              | Aliases to avoid      |
| ----------- | ------------------------------------------------------- | --------------------- |

Rules

• Be opinionated. 同一概念有多个词时，选择最好的一个，并把其他列为 aliases to avoid。
• Flag conflicts explicitly. 如果 term 在 conversation 中被模糊使用，在 "Flagged ambiguities" section 中指出，并给出明确 recommendation。
• Only include terms relevant for domain experts. 除非 module 或 class 名在 domain language 中有意义，否则跳过。
• Keep definitions tight. 最多一句。定义它是什么，不定义它做什么。
• Show relationships. 使用粗体 term names，并在明显时表达 cardinality。
• Only include domain terms. 跳过 generic programming concepts（array、function、endpoint），除非它们有 domain-specific meaning。
• Group terms into multiple tables，当自然 clusters 出现时使用（例如按 subdomain、lifecycle 或 actor）。每组有自己的 heading 和 table。如果所有 terms 属于一个 cohesive domain，一个 table 就够，不要强行分组。
• Write an example dialogue. 写一段 dev 与 domain expert 之间的短对话（3-5 exchanges），展示 terms 如何自然互动。对话应澄清相关 concepts 的边界，并展示精确使用 terms。

Example dialogue

Dev: "How do I test the sync service without Docker?"

Domain expert: "Provide the filesystem layer instead of the Docker layer. It implements the same Sandbox service interface but uses a local directory as the sandbox."

Dev: "So sync-in still creates a bundle and unpacks it?"

Domain expert: "Exactly. The sync service doesn't know which layer it's talking to. It calls exec and copyIn — the filesystem layer just runs those as local shell commands."

Re-running

在同一 conversation 中再次调用时：

1. 读取已有 UBIQUITOUS_LANGUAGE.md
2. 合并后续讨论中的新 terms
3. 如果理解演进，更新 definitions
4. 重新标记任何新 ambiguities
5. 重写 example dialogue 以纳入新 terms