Элементы объекта

Каждая заметка здесь — физическая вещь в квартире: помещение, стена, прибор или узел. Решения и открытые форки во всех доменах ссылаются на них обычной ссылкой [[имя]].

Зачем это нужно вам, а не только агенту

Откройте любую заметку и посмотрите панель Backlinks внизу справа. Она покажет все решения и все открытые вопросы, которые касаются этой вещи — из всех доменов сразу. До этого, чтобы узнать, что происходит со стеной между кухней и С/У, надо было прочитать plumbing/DECISIONS.md, plumbing/OPEN.md, electrical/DECISIONS.md и electrical/OPEN.md и сшить это в голове.

Родной граф Обсидиана (Graph view) рисует то же самое картинкой.

Зачем это агенту

Экстрактор scripts/home-kg-extract.py читает те же самые [[ссылки]] и строит из них записи, которые уходят и в граф знаний, и в поисковый индекс. Одна разметка — три потребителя. Разметка, которой пользуется только машина, гниёт; этой пользуетесь и вы.

Правила

Заметка на вещь, а не на тему. «Стена кухня ↔ С/У» — элемент. «Гидроизоляция» — нет, это свойство, оно живёт в решении.
Имя — то, что произносят вслух. су-умывальник, а не wc-basin-01.
Ссылка на несуществующий элемент валит экстракцию. Это сделано нарочно: два имени одной стены — самый тихий способ развалить модель.
Здесь не живут решения. Заметка описывает вещь и её неизменные свойства. Что с ней решили — в DECISIONS.md своего домена, и оно само сюда сошлётся.

Проверить

python3 scripts/home-kg-extract.py                        # целостность ссылок
python3 scripts/home-ask.py element стена-кухня-су        # кто её касается
python3 scripts/home-ask.py open                          # все открытые форки со связями