Initial commit: Hermes skill file-tree-catalog

references/engineering-doc-archive.md

@@ -0,0 +1,48 @@
+# Russian design-document archive conventions (СКС / ЛВС / КТСБ)
+
+Domain notes from cataloging the "Винный город" project archive. Useful for
+sensing what files mean by name and for expanding systems/objects in catalogs.
+
+## Systems (шифр prefix)
+- **СКС** — структурированная кабельная система
+- **ЛВС** — локально-вычислительная сеть
+- **КТСБ** — комплекс технических средств безопасности (СКУД, видеонаблюдение, охранная сигнализация и т.п.)
+- **ГП2 / ГП** — генплан (used in «Уличный бар» folder)
+
+## Document шифр pattern
+`1289-1-1-Р-<СИСТЕМА>.<объект>[.подраздел]_<вариант>.pdf` where:
+- `1289-1-1-Р` — project / series / stage (Р = «рабочая документация»)
+- `<объект>` — building/zone number (1, 2, 3, 4, 6, 7, 9; note: 5 and 8 have no folders — don't assume they exist)
+- `.1` suffix — sub-division of a system/zone (СКС.1 vs СКС.1.1, ЛВС.7 vs ЛВС.7.1)
+- Optional `Н-КВ` after project: `1289-1-1-Р-Н-КВ-СКС.7` — belongs to the **Кубань-Вино** object subset.
+
+## Companion files (role by suffix / extension)
+- `*_Изменения_Изм.N_От <date>.docx` — change/revision list (docx)
+- `*_Замечания*_Ответ We-On.xlsx` — review comments + contractor response (xlsx)
+- `*_Изменения.txt` — plain-text change notes
+- `*_ЖАН.pdf` — отдельный жан/выпуск (a ЖАН issue — versioned sub-release of the doc)
+- `*_Лист регистрации изменения.docx` — change-registration sheet
+- `*_Обложка+ТЛ*.docx` — cover + title/technical sheet
+- Bulk CAD+schema folder **`note+dwg/`** — contains per-sheet drawings:
+  - `*_л.N.dwg` — leaf/sheet N (single) or `л.2-5.dwg` (range)
+  - `*_л.1_ОД.dwg` — ОД (общая/общие данные?)
+  - `*_СО*.docx` — спецификация оборудования (equipment schedule)
+  - `*_КЖ.doc/.docx` — ?
+  - `*_Зд1/Зд2.xlsx`, `*_ТП1/ТП2/ТП3.xlsx` — данные по зданиям / техпроцессу (Excel)
+  - `*_П1..П7.dwg/.pdf/.docx` — планы (floor plans) various
+  - `*_РР.dwg`, `*_И1.dwg` — расчётные/исполнительные чертежи
+
+## Contractors (in document headers)
+- **WE-ON** — ГИП Рыкова
+- **Велесстрой** — ГИП Кузнецов
+
+## Folder layout
+`<СИСТЕМА.N>/<YYYY.MM.DD>_Rev.XX/` — one folder per revision peak. Top-level
+also may contain special objects: **Кубань-Вино** (systems of zone 7 done for a
+separate client), **Уличный бар**.
+
+## Local-model note
+Local `qwen3:8b` on this host answers ONLY via `reasoning_content`; `content`
+comes back empty even with `think:false` / `options.num_think:0` attempts. Do
+not rely on it for generated prose. For semantic expansion of abbreviations,
+prefer stating verified facts over inventing meaning.