aibot88 Domain discovery skill
When to invoke
Invoked by domain-researcher agent, or when operator says:
- "новый bounded context"
- "event storming"
- "исследуем домен"
- "нужна Ubiquitous Language"
Hard prerequisites
Before starting, verify:
docs/domain/directory exists (or will be created).- The BC name is known. Ask if not.
- Confirm this is not existing BC evolution — for evolution, use
/planand update existingoverview.md.
Five-phase interview
Phase 1: Actors (5 min)
Ask:
Кто взаимодействует с этим BC? Внешние акторы, внутренние сервисы, автоматические процессы. Минимум 3.
Record as - ActorName: role (human/service/scheduler/external-system).
Phase 2: Events (past tense, 20 min)
Ask:
Event Storming. Что уже произошло, что важно для этого BC? В прошедшем времени. Не "выставить счёт" (это команда), а "СчётВыставлен" (это событие).
Cycle through colors:
- Orange (события) — что произошло
- Blue (команды) — что вызывает событие (в повелительном наклонении)
- Lilac (политики) — "когда X, тогда Y"
- Yellow (агрегаты) — кто хранит инварианты
- Green (read models) — что потребляется для чтения
- Red (горячие точки) — неопределённости, разногласия, неизвестное
REFUSE to proceed if < 5 events. Keep pressing until operator surfaces more.
Phase 3: Boundary (10 min)
Ask:
Что входит в scope этого BC и что специально НЕ входит? Где проходит граница? И самое важное: какой термин меняет смысл при переходе через эту границу? Если ни один — возможно, это не отдельный BC.
Example: "Customer" inside Sales BC = покупатель; "Customer" inside Support BC = тикет-автор. Same word, different concept.
Phase 4: Ubiquitous Language (15 min)
Ask:
Минимум 5 терминов. Определения — на языке бизнеса, не технологий. "Order is a Go struct" — плохо. "Order is a customer's commitment to purchase that triggers fulfillment" — хорошо.
Build a table: | Term | Business definition | Aliases to avoid |
REFUSE if < 5 real terms.
Phase 5: Context map edges (10 min)
For each other BC the current one interacts with, ask:
Какой паттерн связи? Shared Kernel / Customer-Supplier / Conformist / Anticorruption Layer / Open Host Service / Published Language / Separate Ways / Big Ball of Mud.
If operator doesn't know these patterns, briefly explain — but insist on picking one. "Just use" is not a pattern.
Output
Write docs/domain/<bc-name>/overview.md per the section table below. This table is the authoritative output schema; domain-researcher.md agent output format is a subset used for the discovery phase only.
The output document must include all of the following sections. Sections marked [discovery] are produced from the interview. Sections marked [post-interview] are authored after the interview using empirical sources (code, ADRs, principles).
| Section | Source | Minimum content |
|---|---|---|
| Purpose | [discovery] Phase 3 | One paragraph: what the BC owns and explicitly does NOT own |
| Actors | [discovery] Phase 1 | ≥ 3 actors with role and authority |
| Commands and Domain Events | [discovery] Phase 2 | ≥ 5 events; commands paired with their emitted events |
| Boundary | [discovery] Phase 3 | In-scope list, out-of-scope list, terms that change meaning at the boundary |
| Aggregate Root | [discovery] Phase 2 | Invariants enumerated explicitly as checkable conditions |
| Policies | [discovery] Phase 2 | Trigger → action pairs (when X, then Y) |
| Context Map | [discovery] Phase 5 | DDD pattern named for each external BC edge |
| Use Cases | [post-interview] | ≥ 5 UCs; each with Actor, Preconditions, Main scenario, Alternatives, Postconditions |
| Domain Data Model | [post-interview] | Key entities with attributes and valid states; invariants enumerated per entity |
| Interface Contracts | [post-interview] | One row per external interface; columns: Operations, Handled failures, Unhandled failures (sourced from code, not inferred) |
| NFR | [post-interview] | Only mechanically-verified constraints cited to an existing check or ADR; speculative constraints dropped |
| Internal Compliance | [post-interview] | Table: Norm | Enforcement type | Artifact | Honor-system gap? — every DoD norm must appear |
| Red Hotspots | [discovery] | Explicit unresolved questions; "none" requires justification |
Note on Security: if the BC has a security model documented in ADRs or runbooks, add a ## Security section with one-line pointers only — no duplication of content from the source documents. This section is optional for new BCs with no established security model.
Hand-off
Domain overview написан в
docs/domain/<bc>/overview.md. Следующий шаг:@agent-domain-reviewer docs/domain/<bc>/overview.md. Если одобрит — commit и продолжайте на/planуровне.
Hard rules
- НЕ пропускайте phase, даже под давлением "у меня мало времени".
- НЕ принимайте "это очевидно" как ответ. Event Storming очевидное ловит в первой фазе; проблемы — в следующих.
- НЕ проектируйте implementation. Tables, APIs, code — всё в downstream.
- НЕ допускайте БГ (Big Ball of Mud) как постоянный паттерн — это временный статус, требующий рефакторинга.