| 1 | # Status: software.authoring v1 |
| 2 | |
| 3 | **Домен:** принципы написания кода, декомпозиция, OOA&D (канон для агента и человека). |
| 4 | |
| 5 | **Версия:** v1.0 · 2026-05-17 |
| 6 | |
| 7 | --- |
| 8 | |
| 9 | ## Operating contract (текущий) |
| 10 | |
| 11 | | Приоритет | Документ | Когда | |
| 12 | |-----------|----------|--------| |
| 13 | | 1 | `playbook-ooad-agent-operational-v1.md` | Новая фича, рефакторинг, рост `switch`/god-class | |
| 14 | | 2 | `kb-ooad-fundamentals-v1.md` | Фундамент, GRASP, источники (Larman, UML) | |
| 15 | | 3 | `playbook-domain-nouns-verbs-decomposition-v1.md` | Быстрый контракт: существительные → типы, глаголы → методы | |
| 16 | | 4 | `code-writing-principles-v1.md` | C# / .NET стиль после структуры | |
| 17 | |
| 18 | --- |
| 19 | |
| 20 | ## Maintenance Policy |
| 21 | |
| 22 | - **Проверено:** при изменении инженерной практики в Cascade IDE или после сессии с явным уроком (как chat Skia 2026-05). |
| 23 | - **Связь с engineering-evidence:** Track C в `map-engineering-reading-v1.md`; evidence-строки — в `kb-engineering-evidence-v1.md` § Object-oriented analysis and design. |
| 24 | |
| 25 | --- |
| 26 | |
| 27 | ## Closure snapshot |
| 28 | |
| 29 | - OOA&D фундамент и операционный проход — **в каноне** (v1.0). |
| 30 | - Nouns/verbs playbook — **дочерний** операционный слой. |
| 31 | - Отдельный `status-ooad-v1` не выделяем: домен **software.authoring** покрывает анализ→код. |
| 32 | |
| 33 | <!-- section:operating-contract-matrix --> |
| 34 | ## Transfer matrix (cross-domain software) |
| 35 | |
| 36 | | Когда | Документ | |
| 37 | |-------|----------| |
| 38 | | Неявный симптом (визуал + структура, god-class, switch, Skia, новый экран) | `matrix-software-cross-domain-transfer-v1.md` **до** углубления в kb | |
| 39 | | Явный OOA&D / декомпозиция | сразу `playbook-ooad-agent-operational-v1.md` (матрица опциональна) | |
| 40 | |
| 41 | Роутер supplement: `router-software-transfer-matrix` в `index-knowledge-router-supplement-v1.md`. |
| 42 | <!-- /section:operating-contract-matrix --> |
| 43 | |
| 44 | <!-- section:language-worlds-v1 --> |
| 45 | ## Языковые миры (иерархия) |
| 46 | |
| 47 | Родитель **`software.authoring`** — только кросс-языковое (OOA&D, matrix, nouns/verbs). |
| 48 | |
| 49 | Дочерние (примеры): `software.authoring.dotnet.csharp`, `software.authoring.php`, `software.authoring.javascript` — полная таблица и резолв по файлам: **`kb-software-authoring-language-worlds-v1.md`**. |
| 50 | |
| 51 | Легаси-теги `software.php`, `software.javascript` в старых карточках = те же миры. |
| 52 | <!-- /section:language-worlds-v1 --> |
| 53 | |
| 54 | |