AGENT SKILL

domain-modeling

Build or revise domain vocabulary in GLOSSARY.md and record approved architectural decisions. Use when terms or domain boundaries need resolving, or the user requests a glossary or ADR.

License 许可
MIT
最近更新
2026-10-17
Stars
★ 1
Forks
0

01 前言 Front Matter

name
domain-modeling
description
Build or revise domain vocabulary in GLOSSARY.md and record approved architectural decisions. Use when terms or domain boundaries need resolving, or the user requests a glossary or ADR.

02 资源文件 3

03 SKILL.md 正文

Domain modeling

Read docs/agents/domain.md for the existing context layout and ADRs. This profile keeps its vocabulary in GLOSSARY.md, or in context-specific glossaries named by GLOSSARY-MAP.md.

  1. Challenge terms that conflict with the existing glossary. Ask which meaning the user intends.
  2. Resolve overloaded language through concrete scenarios and code evidence. Propose one canonical term per concept.
  3. When the user requested domain documentation, record resolved terms in GLOSSARY.md as they settle. Preserve existing entries. Use GLOSSARY-FORMAT.md for the domain title, description, language entries, and context layout. Create a missing glossary only once there is a resolved term to record.
  4. During a discussion without a documentation request, present proposed entries in conversation and ask before creating durable files.
  5. Offer an ADR only for a costly-to-reverse decision, surprising without context, that follows a real tradeoff. Write it after approval using ADR-FORMAT.md.

Keep the glossary free of implementation details, specifications, scratch notes, and decisions. Record approved decisions in ADRs. Create glossary files and ADR directories only when an authorized deliverable needs them. Report conflicts with existing ADRs rather than silently replacing their decisions.

04 同仓库更多 Skills