AGENTS.md — 60-flows/20-analogs

Назначение уровня

Раздел описывает подбор аналогов как построено (current, as-built), сверено с кодом: путь данных от опроса поставщиков до ранжированной выдачи. Целевой дизайн сценария — в ../../10-business/scenarios/analog-search.md; при расхождении верен этот раздел.

Содержание

20-analogs/
├── AGENTS.md              # ← вы здесь
└── README.md              # карта конвейера: восемь стадий, словарь, состояние

Use-case файлы по отдельным категориям и замерам добавляются прямо в эту директорию.

Ключевые концепции уровня

Якорь (anchor) — канонический товар, для которого ищутся аналоги. Область поиска ограничена его поддеревом категорий.
Оси сравнения — характеристики с ролью в category_characteristic_significance: identity и range определяют допустимость, score только ранжирует.
Профиль совместимости — набор активных осей product family; без положительной eligibility-оси режим exact невозможен (ADR-0076).
Остальные термины — см. ../../GLOSSARY.md.

Когда смотреть сюда

Нужно понять, почему по конкретному товару выдача пуста или короче ожидаемой.
Нужна точная ссылка на символ кода (file:line) в стадиях конвейера подбора.
Готовите impact-анализ правок в подборе и хотите отталкиваться от проверенных фактов.

Когда НЕ смотреть сюда

Нужны операционные действия и диагностика инцидента → ../../40-operations/runbooks/matching-and-analogs-search.md.
Нужен целевой бизнес-сценарий → ../../10-business/scenarios/analog-search.md.
Нужна сервисная граница матчинга → ../../30-services/.

Связано

Соглашения

Каждый факт — со ссылкой на file:line, каждый файл — с маркером «Статус: current (as-built), сверено на commit <hash>».
Замеры качества выдачи приводятся с датой и объёмом выборки: без них число нельзя перепроверить.

Tracium

Разделы