Merge dev: form skills (info, compile, validate, add, patterns)

Complete managed form pipeline: - /form-info: compact XML analysis - /form-compile: JSON DSL to Form.xml generation - /form-validate: structural validation - /form-add: add elements/attributes/commands to existing forms - /form-patterns: layout guide with archetypes and conventions Event validation, element-level stdCommand, ERP patterns. Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-06-13 01:14:56 +03:00 · 2026-02-09 19:03:45 +03:00
parent 044bc18974 ecfb473827
commit 8fc30c9b9a
13 changed files with 5273 additions and 1 deletions
@@ -0,0 +1,127 @@
+---
+name: form-add
+description: Добавление элементов, реквизитов и команд в существующую управляемую форму 1С (Form.xml)
+argument-hint: <FormPath> <JsonPath>
+allowed-tools:
+  - Bash
+  - Read
+  - Write
+  - Glob
+---
+
+# /form-add — Добавление в форму
+
+Добавляет элементы, реквизиты и/или команды в существующий Form.xml. Автоматически выделяет ID из правильного пула, генерирует companion-элементы (ContextMenu, ExtendedTooltip, и др.) и обработчики событий.
+
+## Использование
+
+```
+/form-add <FormPath> <JsonPath>
+```
+
+## Параметры
+
+| Параметр  | Обязательный | Описание                         |
+|-----------|:------------:|----------------------------------|
+| FormPath  | да           | Путь к существующему Form.xml    |
+| JsonPath  | да           | Путь к JSON с описанием добавлений |
+
+## Команда
+
+```powershell
+powershell.exe -NoProfile -File .claude\skills\form-add\scripts\form-add.ps1 -FormPath "<путь>" -JsonPath "<путь>"
+```
+
+## JSON формат
+
+```json
+{
+  "into": "ГруппаШапка",
+  "after": "Контрагент",
+  "elements": [
+    { "input": "Склад", "path": "Объект.Склад", "on": ["OnChange"] }
+  ],
+  "attributes": [
+    { "name": "СуммаИтого", "type": "decimal(15,2)" }
+  ],
+  "commands": [
+    { "name": "Рассчитать", "action": "РассчитатьОбработка" }
+  ]
+}
+```
+
+### Позиционирование элементов
+
+| Ключ | По умолчанию | Описание |
+|------|-------------|----------|
+| `into` | корневой ChildItems | Имя группы/таблицы/страницы, куда вставлять |
+| `after` | в конец | Имя элемента, после которого вставлять |
+
+### Типы элементов
+
+Те же DSL-ключи, что в `/form-compile`:
+
+| Ключ | XML тег | Companions |
+|------|---------|------------|
+| `input` | InputField | ContextMenu, ExtendedTooltip |
+| `check` | CheckBoxField | ContextMenu, ExtendedTooltip |
+| `label` | LabelDecoration | ContextMenu, ExtendedTooltip |
+| `labelField` | LabelField | ContextMenu, ExtendedTooltip |
+| `group` | UsualGroup | ExtendedTooltip |
+| `table` | Table | ContextMenu, AutoCommandBar, Search*, ViewStatus* |
+| `pages` | Pages | ExtendedTooltip |
+| `page` | Page | ExtendedTooltip |
+| `button` | Button | ExtendedTooltip |
+
+Группы и таблицы поддерживают `children`/`columns` для вложенных элементов.
+
+### Кнопки: command и stdCommand
+
+- `"command": "ИмяКоманды"` → `Form.Command.ИмяКоманды`
+- `"stdCommand": "Close"` → `Form.StandardCommand.Close`
+- `"stdCommand": "Товары.Add"` → `Form.Item.Товары.StandardCommand.Add` (стандартная команда элемента)
+
+### Допустимые события (`on`)
+
+Компилятор предупреждает об ошибках в именах событий. Основные:
+
+- **input**: `OnChange`, `StartChoice`, `ChoiceProcessing`, `Clearing`, `AutoComplete`, `TextEditEnd`
+- **check**: `OnChange`
+- **table**: `OnStartEdit`, `OnEditEnd`, `OnChange`, `Selection`, `BeforeAddRow`, `BeforeDeleteRow`, `OnActivateRow`
+- **label/picture**: `Click`, `URLProcessing`
+- **pages**: `OnCurrentPageChange`
+- **button**: `Click`
+
+### Система типов (для attributes)
+
+`string`, `string(100)`, `decimal(15,2)`, `boolean`, `date`, `dateTime`, `CatalogRef.XXX`, `DocumentObject.XXX`, `ValueTable`, `DynamicList`, `Type1 | Type2` (составной).
+
+## Вывод
+
+```
+=== form-add: Форма ===
+
+Added elements (into ГруппаШапка, after Контрагент):
+  + [Input] Склад -> Объект.Склад {OnChange}
+
+Added attributes:
+  + СуммаИтого: decimal(15,2) (id=12)
+
+---
+Total: 1 element(s) (+2 companions), 1 attribute(s)
+Run /form-validate to verify.
+```
+
+## Когда использовать
+
+- **После `/form-compile`**: добавить элементы, которые не были в исходном JSON
+- **Модификация существующих форм**: добавить поле, реквизит или команду в форму из конфигурации
+- **Пакетное добавление**: один JSON может содержать элементы + реквизиты + команды
+
+## Workflow
+
+1. `/form-info` — посмотреть текущую структуру формы
+2. Создать JSON с описанием добавлений
+3. `/form-add` — добавить в форму
+4. `/form-validate` — проверить корректность
+5. `/form-info` — убедиться что добавилось правильно
@@ -0,0 +1,409 @@
+---
+name: form-compile
+description: Компиляция управляемой формы 1С (Form.xml) из компактного JSON-определения
+argument-hint: <JsonPath> <OutputPath>
+allowed-tools:
+  - Bash
+  - Read
+  - Write
+  - Glob
+---
+
+# /form-compile — Генерация Form.xml из JSON DSL
+
+Принимает компактное JSON-определение формы (20–50 строк) и генерирует полный корректный Form.xml (100–500+ строк) с namespace-декларациями, автогенерированными companion-элементами, последовательными ID.
+
+> **При проектировании формы с нуля (5+ элементов или нечёткие требования)** — вызовите `/form-patterns` для загрузки справочника: архетипы, конвенции именования, продвинутые паттерны. Для простых форм (1–3 поля, пользователь описал что нужно) — не нужно.
+
+## Использование
+
+```
+/form-compile <JsonPath> <OutputPath>
+```
+
+## Параметры
+
+| Параметр   | Обязательный | Описание                          |
+|------------|:------------:|-----------------------------------|
+| JsonPath   | да           | Путь к JSON-определению формы     |
+| OutputPath | да           | Путь к выходному файлу Form.xml   |
+
+## Команда
+
+```powershell
+powershell.exe -NoProfile -File .claude\skills\form-compile\scripts\form-compile.ps1 -JsonPath "<json>" -OutputPath "<xml>"
+```
+
+## JSON DSL — справка
+
+### Структура верхнего уровня
+
+```json
+{
+  "title": "Заголовок формы",
+  "properties": { "autoTitle": false, ... },
+  "events": { "OnCreateAtServer": "ПриСозданииНаСервере" },
+  "excludedCommands": ["Reread"],
+  "elements": [ ... ],
+  "attributes": [ ... ],
+  "commands": [ ... ],
+  "parameters": [ ... ]
+}
+```
+
+- `title` — заголовок формы (multilingual). Можно указать и в `properties`, но лучше на верхнем уровне
+- `properties` — свойства формы: `autoTitle`, `windowOpeningMode`, `commandBarLocation`, `saveDataInSettings`, `width`, `height` и др.
+- `events` — обработчики событий формы (ключ: имя события 1С, значение: имя процедуры)
+- `excludedCommands` — исключённые стандартные команды
+
+### Элементы (ключ определяет тип)
+
+| DSL ключ     | XML элемент       | Значение ключа                                    |
+|--------------|-------------------|---------------------------------------------------|
+| `"group"`    | UsualGroup        | `"horizontal"` / `"vertical"` / `"alwaysHorizontal"` / `"alwaysVertical"` / `"collapsible"` |
+| `"input"`    | InputField        | имя элемента                                      |
+| `"check"`    | CheckBoxField     | имя                                               |
+| `"label"`    | LabelDecoration   | имя (текст задаётся через `title`)                |
+| `"labelField"` | LabelField      | имя                                               |
+| `"table"`    | Table             | имя                                               |
+| `"pages"`    | Pages             | имя                                               |
+| `"page"`     | Page              | имя                                               |
+| `"button"`   | Button            | имя                                               |
+| `"picture"`  | PictureDecoration | имя                                               |
+| `"picField"` | PictureField      | имя                                               |
+| `"calendar"` | CalendarField     | имя                                               |
+| `"cmdBar"`   | CommandBar        | имя                                               |
+| `"popup"`    | Popup             | имя                                               |
+
+### Общие свойства (все типы элементов)
+
+| Ключ | Описание |
+|------|----------|
+| `name` | Переопределить имя (по умолчанию = значение ключа типа) |
+| `title` | Заголовок элемента |
+| `visible: false` | Скрыть (синоним: `hidden: true`) |
+| `enabled: false` | Сделать недоступным (синоним: `disabled: true`) |
+| `readOnly: true` | Только чтение |
+| `on: [...]` | События с автоименованием обработчиков |
+| `handlers: {...}` | Явное задание имён обработчиков: `{"OnChange": "МоёИмя"}` |
+
+### Допустимые имена событий (`on`)
+
+Компилятор предупреждает о неизвестных событиях. Имена регистрозависимы — используйте точно как указано.
+
+**Форма** (`events`): `OnCreateAtServer`, `OnOpen`, `BeforeClose`, `OnClose`, `NotificationProcessing`, `ChoiceProcessing`, `OnReadAtServer`, `BeforeWriteAtServer`, `OnWriteAtServer`, `AfterWriteAtServer`, `BeforeWrite`, `AfterWrite`, `FillCheckProcessingAtServer`, `BeforeLoadDataFromSettingsAtServer`, `OnLoadDataFromSettingsAtServer`, `ExternalEvent`, `Opening`
+
+**input / picField**: `OnChange`, `StartChoice`, `ChoiceProcessing`, `AutoComplete`, `TextEditEnd`, `Clearing`, `Creating`, `EditTextChange`
+
+**check**: `OnChange`
+
+**table**: `OnStartEdit`, `OnEditEnd`, `OnChange`, `Selection`, `ValueChoice`, `BeforeAddRow`, `BeforeDeleteRow`, `AfterDeleteRow`, `BeforeRowChange`, `BeforeEditEnd`, `OnActivateRow`, `OnActivateCell`, `Drag`, `DragStart`, `DragCheck`, `DragEnd`
+
+**label / picture**: `Click`, `URLProcessing`
+
+**labelField**: `OnChange`, `StartChoice`, `ChoiceProcessing`, `Click`, `URLProcessing`, `Clearing`
+
+**button**: `Click`
+
+**pages**: `OnCurrentPageChange`
+
+### Поле ввода (input)
+
+| Ключ | Описание | Пример |
+|------|----------|--------|
+| `path` | DataPath — привязка к данным | `"Объект.Организация"` |
+| `titleLocation` | Размещение заголовка | `"none"`, `"left"`, `"top"` |
+| `multiLine: true` | Многострочное поле | текстовое поле, комментарий |
+| `passwordMode: true` | Режим пароля (звёздочки) | поле ввода пароля |
+| `choiceButton: true` | Кнопка выбора ("...") | ссылочное поле |
+| `clearButton: true` | Кнопка очистки ("X") | |
+| `spinButton: true` | Кнопка прокрутки | числовые поля |
+| `dropListButton: true` | Кнопка выпадающего списка | |
+| `markIncomplete: true` | Пометка незаполненного | обязательные поля |
+| `skipOnInput: true` | Пропускать при обходе Tab | |
+| `inputHint` | Подсказка в пустом поле | `"Введите наименование..."` |
+| `width` / `height` | Размер | числа |
+| `autoMaxWidth: false` | Отключить авто-ширину | для фиксированных полей |
+| `horizontalStretch: true` | Растягивать по ширине | |
+
+### Чекбокс (check)
+
+| Ключ | Описание |
+|------|----------|
+| `path` | DataPath |
+| `titleLocation` | Размещение заголовка |
+
+### Надпись-декорация (label)
+
+| Ключ | Описание |
+|------|----------|
+| `title` | Текст надписи (обязательно) |
+| `hyperlink: true` | Сделать ссылкой |
+| `width` / `height` | Размер |
+
+### Группа (group)
+
+Значение ключа задаёт ориентацию: `"horizontal"`, `"vertical"`, `"alwaysHorizontal"`, `"alwaysVertical"`, `"collapsible"`.
+
+| Ключ | Описание |
+|------|----------|
+| `showTitle: true` | Показывать заголовок группы |
+| `united: false` | Не объединять рамку |
+| `representation` | `"none"`, `"normal"`, `"weak"`, `"strong"` |
+| `children: [...]` | Вложенные элементы |
+
+### Таблица (table)
+
+**Важно**: таблица требует связанный реквизит формы типа `ValueTable` с колонками (см. раздел "Связки").
+
+| Ключ | Описание |
+|------|----------|
+| `path` | DataPath (привязка к реквизиту-таблице) |
+| `columns: [...]` | Колонки — массив элементов (обычно `input`) |
+| `changeRowSet: true` | Разрешить добавление/удаление строк |
+| `changeRowOrder: true` | Разрешить перемещение строк |
+| `height` | Высота в строках таблицы |
+| `header: false` | Скрыть шапку |
+| `footer: true` | Показать подвал |
+| `commandBarLocation` | `"None"`, `"Top"`, `"Auto"` |
+| `searchStringLocation` | `"None"`, `"Top"`, `"Auto"` |
+
+### Страницы (pages + page)
+
+| Ключ (pages) | Описание |
+|------|----------|
+| `pagesRepresentation` | `"None"`, `"TabsOnTop"`, `"TabsOnBottom"` и др. |
+| `children: [...]` | Массив `page` |
+
+| Ключ (page) | Описание |
+|------|----------|
+| `title` | Заголовок вкладки |
+| `group` | Ориентация внутри страницы |
+| `children: [...]` | Содержимое страницы |
+
+### Кнопка (button)
+
+| Ключ | Описание |
+|------|----------|
+| `command` | Имя команды формы → `Form.Command.Имя` |
+| `stdCommand` | Стандартная команда: `"Close"` → `Form.StandardCommand.Close`; с точкой: `"Товары.Add"` → `Form.Item.Товары.StandardCommand.Add` |
+| `defaultButton: true` | Кнопка по умолчанию |
+| `type` | `"usual"`, `"hyperlink"`, `"commandBar"` |
+| `picture` | Картинка кнопки |
+| `representation` | `"Auto"`, `"Text"`, `"Picture"`, `"PictureAndText"` |
+| `locationInCommandBar` | `"Auto"`, `"InCommandBar"`, `"InAdditionalSubmenu"` |
+
+### Командная панель (cmdBar)
+
+| Ключ | Описание |
+|------|----------|
+| `autofill: true` | Автозаполнение стандартными командами |
+| `children: [...]` | Кнопки панели |
+
+### Выпадающее меню (popup)
+
+| Ключ | Описание |
+|------|----------|
+| `title` | Заголовок подменю |
+| `children: [...]` | Кнопки подменю |
+
+Используется внутри `cmdBar` для группировки кнопок в подменю:
+```json
+{ "cmdBar": "Панель", "children": [
+  { "popup": "Добавить", "title": "Добавить", "children": [
+    { "button": "ДобавитьСтроку", "stdCommand": "Товары.Add" },
+    { "button": "ДобавитьИзДокумента", "command": "ДобавитьИзДокумента", "title": "Из документа" }
+  ]}
+]}
+```
+
+### Реквизиты (attributes)
+
+```json
+{ "name": "Объект", "type": "DataProcessorObject.Загрузка", "main": true }
+{ "name": "Итого", "type": "decimal(15,2)" }
+{ "name": "Таблица", "type": "ValueTable", "columns": [
+    { "name": "Номенклатура", "type": "CatalogRef.Номенклатура" },
+    { "name": "Количество", "type": "decimal(10,3)" }
+]}
+```
+
+- `savedData: true` — сохраняемые данные
+
+### Команды (commands)
+
+```json
+{ "name": "Загрузить", "action": "ЗагрузитьОбработка", "shortcut": "Ctrl+Enter" }
+```
+
+- `title` — заголовок (если отличается от name)
+- `picture` — картинка команды
+
+### Система типов
+
+| DSL                    | XML                                    |
+|------------------------|----------------------------------------|
+| `"string"` / `"string(100)"` | `xs:string` + StringQualifiers  |
+| `"decimal(15,2)"`     | `xs:decimal` + NumberQualifiers        |
+| `"decimal(10,0,nonneg)"` | с AllowedSign=Nonnegative           |
+| `"boolean"`            | `xs:boolean`                          |
+| `"date"` / `"dateTime"` / `"time"` | `xs:dateTime` + DateFractions |
+| `"CatalogRef.XXX"`    | `cfg:CatalogRef.XXX`                   |
+| `"DocumentRef.XXX"`   | `cfg:DocumentRef.XXX`                  |
+| `"ValueTable"`         | `v8:ValueTable`                       |
+| `"ValueList"`          | `v8:ValueListType`                    |
+| `"Type1 \| Type2"`    | составной тип                          |
+
+## Связки: элемент + реквизит
+
+Таблица и некоторые поля требуют связанный реквизит. Элемент ссылается на реквизит через `path`.
+
+**Таблица** — элемент `table` + реквизит `ValueTable`:
+```json
+{
+  "elements": [
+    { "table": "Товары", "path": "Объект.Товары", "columns": [
+      { "input": "Номенклатура", "path": "Объект.Товары.Номенклатура" }
+    ]}
+  ],
+  "attributes": [
+    { "name": "Объект", "type": "DataProcessorObject.Загрузка", "main": true,
+      "columns": [
+        { "name": "Товары", "type": "ValueTable", "columns": [
+          { "name": "Номенклатура", "type": "CatalogRef.Номенклатура" }
+        ]}
+      ]
+    }
+  ]
+}
+```
+
+Или, если таблица привязана к реквизиту формы (не к Объект):
+```json
+{
+  "elements": [
+    { "table": "ТаблицаДанных", "path": "ТаблицаДанных", "columns": [
+      { "input": "Наименование", "path": "ТаблицаДанных.Наименование" }
+    ]}
+  ],
+  "attributes": [
+    { "name": "ТаблицаДанных", "type": "ValueTable", "columns": [
+      { "name": "Наименование", "type": "string(150)" }
+    ]}
+  ]
+}
+```
+
+## Паттерны
+
+### Диалог загрузки файла
+
+```json
+{
+  "title": "Загрузка из файла",
+  "properties": { "autoTitle": false },
+  "events": { "OnCreateAtServer": "ПриСозданииНаСервере" },
+  "elements": [
+    { "group": "horizontal", "name": "ГруппаФайл", "children": [
+      { "input": "ИмяФайла", "path": "ИмяФайла", "title": "Файл", "inputHint": "Выберите файл...", "choiceButton": true, "on": ["StartChoice"] },
+      { "check": "ПерваяСтрокаЗаголовок", "path": "ПерваяСтрокаЗаголовок" }
+    ]},
+    { "input": "Результат", "path": "Результат", "multiLine": true, "height": 8, "readOnly": true, "title": "Лог" },
+    { "group": "horizontal", "name": "ГруппаКнопок", "children": [
+      { "button": "Загрузить", "command": "Загрузить", "defaultButton": true },
+      { "button": "Закрыть", "stdCommand": "Close" }
+    ]}
+  ],
+  "attributes": [
+    { "name": "Объект", "type": "ExternalDataProcessorObject.ЗагрузкаИзФайла", "main": true },
+    { "name": "ИмяФайла", "type": "string" },
+    { "name": "ПерваяСтрокаЗаголовок", "type": "boolean" },
+    { "name": "Результат", "type": "string" }
+  ],
+  "commands": [
+    { "name": "Загрузить", "action": "ЗагрузитьОбработка", "shortcut": "Ctrl+Enter" }
+  ]
+}
+```
+
+### Мастер (wizard) с шагами
+
+```json
+{
+  "title": "Мастер настройки",
+  "properties": { "autoTitle": false },
+  "elements": [
+    { "pages": "СтраницыМастера", "pagesRepresentation": "None", "children": [
+      { "page": "Шаг1", "title": "Параметры", "children": [
+        { "input": "Параметр1", "path": "Параметр1" }
+      ]},
+      { "page": "Шаг2", "title": "Результат", "children": [
+        { "input": "Итог", "path": "Итог", "readOnly": true }
+      ]}
+    ]},
+    { "group": "horizontal", "name": "Навигация", "children": [
+      { "button": "Назад", "command": "Назад", "title": "< Назад" },
+      { "button": "Далее", "command": "Далее", "title": "Далее >" }
+    ]}
+  ],
+  "attributes": [
+    { "name": "Объект", "type": "ExternalDataProcessorObject.Мастер", "main": true },
+    { "name": "Параметр1", "type": "string" },
+    { "name": "Итог", "type": "string" }
+  ],
+  "commands": [
+    { "name": "Назад", "action": "НазадОбработка" },
+    { "name": "Далее", "action": "ДалееОбработка" }
+  ]
+}
+```
+
+### Список с фильтром и таблицей
+
+```json
+{
+  "title": "Просмотр данных",
+  "elements": [
+    { "group": "horizontal", "name": "Фильтр", "children": [
+      { "input": "Период", "path": "Период", "on": ["OnChange"] },
+      { "input": "Организация", "path": "Организация", "on": ["OnChange"] }
+    ]},
+    { "table": "Данные", "path": "Данные", "changeRowSet": true, "columns": [
+      { "input": "Дата", "path": "Данные.Дата" },
+      { "input": "Сумма", "path": "Данные.Сумма" },
+      { "input": "Комментарий", "path": "Данные.Комментарий" }
+    ]}
+  ],
+  "attributes": [
+    { "name": "Объект", "type": "ExternalDataProcessorObject.Просмотр", "main": true },
+    { "name": "Период", "type": "date" },
+    { "name": "Организация", "type": "string" },
+    { "name": "Данные", "type": "ValueTable", "columns": [
+      { "name": "Дата", "type": "date" },
+      { "name": "Сумма", "type": "decimal(15,2)" },
+      { "name": "Комментарий", "type": "string(200)" }
+    ]}
+  ]
+}
+```
+
+## Автогенерация
+
+- **Companion-элементы**: ContextMenu, ExtendedTooltip и др. создаются автоматически
+- **Обработчики событий**: `"on": ["OnChange"]` → `ОрганизацияПриИзменении`
+- **Namespace**: все 17 namespace-деклараций
+- **ID**: последовательная нумерация, AutoCommandBar = id="-1"
+- **Unknown keys**: выводится предупреждение о нераспознанных ключах
+
+## Верификация
+
+```
+/form-validate <OutputPath>    — проверка корректности XML
+/form-info <OutputPath>        — визуальная сводка структуры
+```
+
+## Особенности для внешних обработок (EPF)
+
+- **Тип главного реквизита**: `ExternalDataProcessorObject.ИмяОбработки` (не `DataProcessorObject`)
+- **DataPath**: используйте реквизиты формы (`ИмяРеквизита`), а не `Объект.ИмяРеквизита` — у внешних обработок нет реквизитов объекта в метаданных
+- **Ссылочные типы**: `CatalogRef.XXX`, `DocumentRef.XXX` и т.д. могут не собраться в пустой базе — используйте `string` или базовые типы для автономной сборки
@@ -0,0 +1,180 @@
+---
+name: form-info
+description: Анализ структуры управляемой формы 1С (Form.xml) — элементы, реквизиты, команды, события
+argument-hint: <FormPath>
+allowed-tools:
+  - Bash
+  - Read
+  - Glob
+---
+
+# /form-info — Компактная сводка формы
+
+Читает Form.xml управляемой формы и выводит компактную сводку: дерево элементов, реквизиты с типами, команды, события. Заменяет необходимость читать тысячи строк XML.
+
+## Использование
+
+```
+/form-info <FormPath>
+```
+
+## Параметры
+
+| Параметр  | Обязательный | По умолчанию | Описание                                    |
+|-----------|:------------:|--------------|---------------------------------------------|
+| FormPath  | да           | —            | Путь к файлу Form.xml                       |
+| Limit     | нет          | `150`        | Макс. строк вывода (защита от переполнения) |
+| Offset    | нет          | `0`          | Пропустить N строк (для пагинации)          |
+
+## Команда
+
+```powershell
+powershell.exe -NoProfile -File .claude\skills\form-info\scripts\form-info.ps1 -FormPath "<путь к Form.xml>"
+```
+
+С пагинацией:
+```powershell
+powershell.exe -NoProfile -File .claude\skills\form-info\scripts\form-info.ps1 -FormPath "<путь>" -Offset 150
+```
+
+## Чтение вывода
+
+### Заголовок
+
+```
+=== Form: ФормаДокумента — "Реализация товаров и услуг" (Documents.РеализацияТоваровУслуг) ===
+```
+
+Имя формы, заголовок (Title) и контекст объекта определяются из пути к файлу и XML.
+
+### Properties — свойства формы
+
+Только нестандартные свойства (отличающиеся от умолчания). Title показывается в заголовке, не здесь:
+
+```
+Properties: AutoTitle=false, WindowOpeningMode=LockOwnerWindow, CommandBarLocation=Bottom
+```
+
+### Events — обработчики событий формы
+
+```
+Events:
+  OnCreateAtServer -> ПриСозданииНаСервере
+  OnOpen -> ПриОткрытии
+```
+
+### Elements — дерево UI-элементов
+
+Компактное дерево с типами, привязками к данным, флагами и событиями:
+
+```
+Elements:
+  ├─ [Group:AH] ГруппаШапка
+  │  ├─ [Input] Организация -> Объект.Организация {OnChange}
+  │  └─ [Input] Договор -> Объект.Договор [visible:false] {StartChoice}
+  ├─ [Table] Товары -> Объект.Товары
+  │  ├─ [Input] Номенклатура -> Объект.Товары.Номенклатура {OnChange}
+  │  └─ [Input] Сумма -> Объект.Товары.Сумма [ro]
+  └─ [Pages] Страницы
+     ├─ [Page] Основное (5 items)
+     └─ [Page] Печать (2 items)
+```
+
+**Сокращения типов элементов:**
+
+| Сокращение | Элемент |
+|---|---|
+| `[Group:V]` | UsualGroup Vertical |
+| `[Group:H]` | UsualGroup Horizontal |
+| `[Group:AH]` | UsualGroup AlwaysHorizontal |
+| `[Group:AV]` | UsualGroup AlwaysVertical |
+| `[Group]` | UsualGroup (ориентация по умолчанию) |
+| `[Input]` | InputField |
+| `[Check]` | CheckBoxField |
+| `[Label]` | LabelDecoration |
+| `[LabelField]` | LabelField |
+| `[Picture]` | PictureDecoration |
+| `[PicField]` | PictureField |
+| `[Calendar]` | CalendarField |
+| `[Table]` | Table |
+| `[Button]` | Button |
+| `[CmdBar]` | CommandBar |
+| `[Pages]` | Pages |
+| `[Page]` | Page (показывает кол-во элементов вместо раскрытия) |
+| `[Popup]` | Popup |
+| `[BtnGroup]` | ButtonGroup |
+
+**Флаги** (только при отклонении от умолчания):
+- `[visible:false]` — элемент скрыт (Visible=false)
+- `[enabled:false]` — элемент недоступен (Enabled=false)
+- `[ro]` — ReadOnly=true
+- `,collapse` — Behavior=Collapsible (для групп)
+
+**Привязка к данным**: `-> Объект.Поле` — DataPath
+
+**Привязка к команде**: `-> ИмяКоманды [cmd]` — команда формы, `-> Close [std]` — стандартная команда
+
+**События**: `{OnChange, StartChoice}` — имена обработчиков
+
+**Заголовок**: `[title:Текст]` — только если отличается от имени элемента
+
+### Attributes — реквизиты формы
+
+```
+Attributes:
+  *Объект: DocumentObject.РеализацияТоваров (main)
+  Валюта: CatalogRef.Валюты
+  Итого: decimal(15,2)
+  Таблица: ValueTable [Номенклатура: CatalogRef.Номенклатура, Кол: decimal(10,3)]
+  Список: DynamicList -> Catalog.Пользователи
+```
+
+- `*` и `(main)` — основной реквизит формы (MainAttribute)
+- Типы ValueTable/ValueTree раскрывают колонки в `[...]`
+- DynamicList показывает MainTable через `->`
+
+### Parameters — параметры формы
+
+```
+Parameters:
+  Ключ: DocumentRef.ЗакупкаТоваров (key)
+  Основание: DocumentRef.*
+```
+
+- `(key)` — ключевой параметр (KeyParameter)
+
+### Commands — команды формы
+
+```
+Commands:
+  Печать -> ПечатьДокумента [Ctrl+P]
+  Заполнить -> ЗаполнитьОбработка
+```
+
+Формат: `Имя -> Обработчик [Сочетание]`
+
+## Что пропускается
+
+Скрипт убирает 80%+ XML-объёма:
+- Визуальные свойства (Width, Height, Color, Font, Border, Align, Stretch)
+- Автогенерированные ExtendedTooltip и ContextMenu
+- Мультиязычные обёртки (v8:item/v8:lang/v8:content)
+- Namespace-декларации
+- Атрибуты id
+
+Для точечного изучения деталей — используйте grep по имени элемента из сводки.
+
+## Когда использовать
+
+- **Перед модификацией формы**: понять структуру, найти нужную группу для вставки элемента
+- **Анализ формы**: какие реквизиты, команды, обработчики задействованы
+- **Навигация по большим формам**: 28K строк XML → 50-100 строк контекста
+
+## Защита от переполнения
+
+Вывод ограничен 150 строками по умолчанию. При превышении:
+```
+[TRUNCATED] Shown 150 of 220 lines. Use -Offset 150 to continue.
+```
+
+Используйте `-Offset N` и `-Limit N` для постраничного просмотра.
@@ -0,0 +1,527 @@
+param(
+	[Parameter(Mandatory=$true)]
+	[string]$FormPath,
+	[int]$Limit = 150,
+	[int]$Offset = 0
+)
+
+$ErrorActionPreference = "Stop"
+[Console]::OutputEncoding = [System.Text.Encoding]::UTF8
+
+# --- Validate path ---
+
+if (-not (Test-Path $FormPath)) {
+	Write-Error "File not found: $FormPath"
+	exit 1
+}
+
+# --- Load XML ---
+
+$xmlDoc = New-Object System.Xml.XmlDocument
+$xmlDoc.PreserveWhitespace = $false
+$xmlDoc.Load((Resolve-Path $FormPath).Path)
+
+$ns = New-Object System.Xml.XmlNamespaceManager($xmlDoc.NameTable)
+$ns.AddNamespace("d", "http://v8.1c.ru/8.3/xcf/logform")
+$ns.AddNamespace("v8", "http://v8.1c.ru/8.1/data/core")
+$ns.AddNamespace("v8ui", "http://v8.1c.ru/8.1/data/ui")
+$ns.AddNamespace("xr", "http://v8.1c.ru/8.3/xcf/readable")
+$ns.AddNamespace("xs", "http://www.w3.org/2001/XMLSchema")
+$ns.AddNamespace("xsi", "http://www.w3.org/2001/XMLSchema-instance")
+$ns.AddNamespace("cfg", "http://v8.1c.ru/8.1/data/enterprise/current-config")
+$ns.AddNamespace("dcsset", "http://v8.1c.ru/8.1/data-composition-system/settings")
+
+$root = $xmlDoc.DocumentElement
+
+# --- Helper: extract multilang text ---
+
+function Get-MLText($node) {
+	if (-not $node) { return "" }
+	$content = $node.SelectSingleNode("v8:item/v8:content", $ns)
+	if ($content) { return $content.InnerText }
+	$text = $node.InnerText.Trim()
+	if ($text) { return $text }
+	return ""
+}
+
+# --- Helper: format type compactly ---
+
+function Format-Type($typeNode) {
+	if (-not $typeNode -or -not $typeNode.HasChildNodes) { return "" }
+
+	$typeSet = $typeNode.SelectSingleNode("v8:TypeSet", $ns)
+	if ($typeSet) {
+		$val = $typeSet.InnerText
+		# Strip cfg: prefix for DefinedType, keep as-is
+		if ($val -like "cfg:*") { $val = $val.Substring(4) }
+		return $val
+	}
+
+	$types = $typeNode.SelectNodes("v8:Type", $ns)
+	if ($types.Count -eq 0) { return "" }
+
+	$parts = @()
+	foreach ($t in $types) {
+		$raw = $t.InnerText
+		switch -Wildcard ($raw) {
+			"xs:string" {
+				$sq = $typeNode.SelectSingleNode("v8:StringQualifiers/v8:Length", $ns)
+				$len = if ($sq) { [int]$sq.InnerText } else { 0 }
+				if ($len -gt 0) { $parts += "string($len)" } else { $parts += "string" }
+			}
+			"xs:decimal" {
+				$nq = $typeNode.SelectSingleNode("v8:NumberQualifiers", $ns)
+				if ($nq) {
+					$d = $nq.SelectSingleNode("v8:Digits", $ns)
+					$f = $nq.SelectSingleNode("v8:FractionDigits", $ns)
+					$digits = if ($d) { $d.InnerText } else { "0" }
+					$frac = if ($f) { $f.InnerText } else { "0" }
+					$parts += "decimal($digits,$frac)"
+				} else {
+					$parts += "decimal"
+				}
+			}
+			"xs:boolean" { $parts += "boolean" }
+			"xs:dateTime" {
+				$dq = $typeNode.SelectSingleNode("v8:DateQualifiers/v8:DateFractions", $ns)
+				if ($dq) {
+					switch ($dq.InnerText) {
+						"Date" { $parts += "date" }
+						"Time" { $parts += "time" }
+						default { $parts += "dateTime" }
+					}
+				} else {
+					$parts += "dateTime"
+				}
+			}
+			"xs:binary" { $parts += "binary" }
+			"cfg:*" { $parts += $raw.Substring(4) }
+			"v8:ValueTable" { $parts += "ValueTable" }
+			"v8:ValueTree" { $parts += "ValueTree" }
+			"v8:ValueListType" { $parts += "ValueList" }
+			"v8:TypeDescription" { $parts += "TypeDescription" }
+			"v8:Universal" { $parts += "Universal" }
+			"v8:FixedArray" { $parts += "FixedArray" }
+			"v8:FixedStructure" { $parts += "FixedStructure" }
+			"v8ui:FormattedString" { $parts += "FormattedString" }
+			"v8ui:Picture" { $parts += "Picture" }
+			"v8ui:Color" { $parts += "Color" }
+			"v8ui:Font" { $parts += "Font" }
+			"dcsset:*" { $parts += $raw.Replace("dcsset:", "DCS.") }
+			"dcssch:*" { $parts += $raw.Replace("dcssch:", "DCS.") }
+			"dcscor:*" { $parts += $raw.Replace("dcscor:", "DCS.") }
+			default { $parts += $raw }
+		}
+	}
+
+	return ($parts -join " | ")
+}
+
+# --- Helper: check if title differs from name ---
+
+function Test-TitleDiffers($node, [string]$name) {
+	$titleNode = $node.SelectSingleNode("d:Title", $ns)
+	if (-not $titleNode) { return $null }
+	$titleText = Get-MLText $titleNode
+	if (-not $titleText) { return $null }
+	# Normalize: remove spaces, lowercase
+	$normTitle = ($titleText -replace '\s', '').ToLower()
+	$normName = $name.ToLower()
+	if ($normTitle -eq $normName) { return $null }
+	return $titleText
+}
+
+# --- Helper: get events as compact string ---
+
+function Get-EventsStr($node) {
+	$eventsNode = $node.SelectSingleNode("d:Events", $ns)
+	if (-not $eventsNode) { return "" }
+	$evts = @()
+	foreach ($e in $eventsNode.SelectNodes("d:Event", $ns)) {
+		$evts += $e.GetAttribute("name")
+	}
+	if ($evts.Count -eq 0) { return "" }
+	return " {$($evts -join ', ')}"
+}
+
+# --- Helper: get flags ---
+
+function Get-Flags($node) {
+	$flags = @()
+	$vis = $node.SelectSingleNode("d:Visible", $ns)
+	if ($vis -and $vis.InnerText -eq "false") { $flags += "visible:false" }
+	$en = $node.SelectSingleNode("d:Enabled", $ns)
+	if ($en -and $en.InnerText -eq "false") { $flags += "enabled:false" }
+	$ro = $node.SelectSingleNode("d:ReadOnly", $ns)
+	if ($ro -and $ro.InnerText -eq "true") { $flags += "ro" }
+	if ($flags.Count -eq 0) { return "" }
+	return " [$($flags -join ',')]"
+}
+
+# --- Element type abbreviations ---
+
+$skipElements = @{
+	"ExtendedTooltip" = $true
+	"ContextMenu" = $true
+	"AutoCommandBar" = $true
+	"SearchStringAddition" = $true
+	"ViewStatusAddition" = $true
+	"SearchControlAddition" = $true
+	"ColumnGroup" = $true
+}
+
+function Get-ElementTag($node) {
+	$localName = $node.LocalName
+	switch ($localName) {
+		"UsualGroup" {
+			$groupNode = $node.SelectSingleNode("d:Group", $ns)
+			$orient = ""
+			if ($groupNode) {
+				switch ($groupNode.InnerText) {
+					"Vertical" { $orient = ":V" }
+					"Horizontal" { $orient = ":H" }
+					"AlwaysHorizontal" { $orient = ":AH" }
+					"AlwaysVertical" { $orient = ":AV" }
+				}
+			}
+			$beh = $node.SelectSingleNode("d:Behavior", $ns)
+			$collapse = ""
+			if ($beh -and $beh.InnerText -eq "Collapsible") { $collapse = ",collapse" }
+			return "[Group$orient$collapse]"
+		}
+		"InputField" { return "[Input]" }
+		"CheckBoxField" { return "[Check]" }
+		"LabelDecoration" { return "[Label]" }
+		"LabelField" { return "[LabelField]" }
+		"PictureDecoration" { return "[Picture]" }
+		"PictureField" { return "[PicField]" }
+		"CalendarField" { return "[Calendar]" }
+		"Table" { return "[Table]" }
+		"Button" { return "[Button]" }
+		"CommandBar" { return "[CmdBar]" }
+		"Pages" { return "[Pages]" }
+		"Page" { return "[Page]" }
+		"Popup" { return "[Popup]" }
+		"ButtonGroup" { return "[BtnGroup]" }
+		default { return "[$localName]" }
+	}
+}
+
+# --- Count significant children (for Page summary) ---
+
+function Count-SignificantChildren($childItemsNode) {
+	if (-not $childItemsNode) { return 0 }
+	$count = 0
+	foreach ($child in $childItemsNode.ChildNodes) {
+		if ($child.NodeType -ne "Element") { continue }
+		if ($skipElements.ContainsKey($child.LocalName)) { continue }
+		$count++
+	}
+	return $count
+}
+
+# --- Build element tree recursively ---
+
+$treeLines = [System.Collections.Generic.List[string]]::new()
+
+function Build-Tree($childItemsNode, [string]$prefix, [bool]$isLast) {
+	if (-not $childItemsNode) { return }
+
+	# Collect significant children
+	$children = @()
+	foreach ($child in $childItemsNode.ChildNodes) {
+		if ($child.NodeType -ne "Element") { continue }
+		if ($skipElements.ContainsKey($child.LocalName)) { continue }
+		$children += $child
+	}
+
+	for ($i = 0; $i -lt $children.Count; $i++) {
+		$child = $children[$i]
+		$last = ($i -eq $children.Count - 1)
+		$connector = if ($last) { [char]0x2514 + [string][char]0x2500 } else { [char]0x251C + [string][char]0x2500 }
+		$continuation = if ($last) { "  " } else { [string][char]0x2502 + " " }
+
+		$tag = Get-ElementTag $child
+		$name = $child.GetAttribute("name")
+		$flags = Get-Flags $child
+		$events = Get-EventsStr $child
+
+		# DataPath or CommandName
+		$binding = ""
+		$dp = $child.SelectSingleNode("d:DataPath", $ns)
+		if ($dp) {
+			$binding = " -> $($dp.InnerText)"
+		} else {
+			$cn = $child.SelectSingleNode("d:CommandName", $ns)
+			if ($cn) {
+				$cnVal = $cn.InnerText
+				if ($cnVal -match '^Form\.StandardCommand\.(.+)$') {
+					$binding = " -> $($Matches[1]) [std]"
+				} elseif ($cnVal -match '^Form\.Command\.(.+)$') {
+					$binding = " -> $($Matches[1]) [cmd]"
+				} else {
+					$binding = " -> $cnVal"
+				}
+			}
+		}
+
+		# Title differs?
+		$titleStr = ""
+		$diffTitle = Test-TitleDiffers $child $name
+		if ($diffTitle) { $titleStr = " [title:$diffTitle]" }
+
+		$line = "$prefix$connector $tag $name$binding$flags$titleStr$events"
+		$treeLines.Add($line)
+
+		# Recurse into containers (but not Page — show summary)
+		$localName = $child.LocalName
+		if ($localName -eq "Page") {
+			$ci = $child.SelectSingleNode("d:ChildItems", $ns)
+			$cnt = Count-SignificantChildren $ci
+			# Append count to last line
+			$idx = $treeLines.Count - 1
+			$treeLines[$idx] = $treeLines[$idx] + " ($cnt items)"
+		} elseif ($localName -in @("UsualGroup", "Pages", "Table", "CommandBar", "ButtonGroup", "Popup")) {
+			$ci = $child.SelectSingleNode("d:ChildItems", $ns)
+			if ($ci) {
+				Build-Tree $ci "$prefix$continuation" $last
+			}
+		}
+	}
+}
+
+# --- Determine form name and object from path ---
+
+$resolvedPath = (Resolve-Path $FormPath).Path
+$parts = $resolvedPath -split '[/\\]'
+
+$formName = ""
+$objectContext = ""
+
+# Look for /Forms/<FormName>/Ext/Form.xml pattern
+$formsIdx = -1
+for ($i = $parts.Count - 1; $i -ge 0; $i--) {
+	if ($parts[$i] -eq "Forms") { $formsIdx = $i; break }
+}
+
+if ($formsIdx -ge 0 -and ($formsIdx + 1) -lt $parts.Count) {
+	$formName = $parts[$formsIdx + 1]
+	# Object is 2 levels up: .../<ObjectType>/<ObjectName>/Forms/...
+	if ($formsIdx -ge 2) {
+		$objType = $parts[$formsIdx - 2]
+		$objName = $parts[$formsIdx - 1]
+		$objectContext = "$objType.$objName"
+	}
+} else {
+	# CommonForms pattern: .../<ObjectType>/<FormName>/Ext/Form.xml
+	$extIdx = -1
+	for ($i = $parts.Count - 1; $i -ge 0; $i--) {
+		if ($parts[$i] -eq "Ext") { $extIdx = $i; break }
+	}
+	if ($extIdx -ge 2) {
+		$formName = $parts[$extIdx - 1]
+		$objType = $parts[$extIdx - 2]
+		$objectContext = $objType
+	} else {
+		$formName = [System.IO.Path]::GetFileNameWithoutExtension($FormPath)
+	}
+}
+
+# --- Collect output ---
+
+$lines = @()
+
+# Header — include Title if present
+$titleNode = $root.SelectSingleNode("d:Title", $ns)
+$formTitle = $null
+if ($titleNode) {
+	$formTitle = Get-MLText $titleNode
+	if (-not $formTitle) { $formTitle = $titleNode.InnerText }
+}
+$header = "=== Form: $formName"
+if ($formTitle) { $header += " — `"$formTitle`"" }
+if ($objectContext) { $header += " ($objectContext)" }
+$header += " ==="
+$lines += $header
+
+# --- Form properties (Title excluded — shown in header) ---
+
+$propNames = @(
+	"Width", "Height", "Group",
+	"WindowOpeningMode", "EnterKeyBehavior", "AutoTitle", "AutoURL",
+	"AutoFillCheck", "Customizable", "CommandBarLocation",
+	"SaveDataInSettings", "AutoSaveDataInSettings",
+	"AutoTime", "UsePostingMode", "RepostOnWrite",
+	"UseForFoldersAndItems",
+	"ReportResult", "DetailsData", "ReportFormType",
+	"VerticalScroll", "ScalingMode"
+)
+
+$props = @()
+foreach ($pn in $propNames) {
+	$pNode = $root.SelectSingleNode("d:$pn", $ns)
+	if ($pNode) {
+		$val = Get-MLText $pNode
+		if (-not $val) { $val = $pNode.InnerText }
+		$props += "$pn=$val"
+	}
+}
+
+if ($props.Count -gt 0) {
+	$lines += ""
+	$lines += "Properties: $($props -join ', ')"
+}
+
+# --- Excluded commands ---
+
+$excludedCmds = @()
+foreach ($ec in $root.SelectNodes("d:CommandSet/d:ExcludedCommand", $ns)) {
+	$excludedCmds += $ec.InnerText
+}
+
+# --- Form events ---
+
+$formEvents = $root.SelectSingleNode("d:Events", $ns)
+if ($formEvents -and $formEvents.HasChildNodes) {
+	$lines += ""
+	$lines += "Events:"
+	foreach ($e in $formEvents.SelectNodes("d:Event", $ns)) {
+		$eName = $e.GetAttribute("name")
+		$eHandler = $e.InnerText
+		$lines += "  $eName -> $eHandler"
+	}
+}
+
+# --- Element tree ---
+
+$childItems = $root.SelectSingleNode("d:ChildItems", $ns)
+if ($childItems) {
+	$lines += ""
+	$lines += "Elements:"
+	Build-Tree $childItems "  " $false
+	$lines += $treeLines.ToArray()
+}
+
+# --- Attributes ---
+
+$attrsNode = $root.SelectSingleNode("d:Attributes", $ns)
+if ($attrsNode) {
+	$attrLines = @()
+	foreach ($attr in $attrsNode.SelectNodes("d:Attribute", $ns)) {
+		$aName = $attr.GetAttribute("name")
+		$typeNode = $attr.SelectSingleNode("d:Type", $ns)
+		$typeStr = Format-Type $typeNode
+
+		$mainAttr = $attr.SelectSingleNode("d:MainAttribute", $ns)
+		$isMain = ($mainAttr -and $mainAttr.InnerText -eq "true")
+
+		$prefix = if ($isMain) { "*" } else { " " }
+		$mainSuffix = if ($isMain) { " (main)" } else { "" }
+
+		# DynamicList: show MainTable
+		$settings = $attr.SelectSingleNode("d:Settings", $ns)
+		$dynTable = ""
+		if ($settings -and $typeStr -eq "DynamicList") {
+			$mt = $settings.SelectSingleNode("d:MainTable", $ns)
+			if ($mt) { $dynTable = " -> $($mt.InnerText)" }
+		}
+
+		# ValueTable/ValueTree columns
+		$colStr = ""
+		$columns = $attr.SelectSingleNode("d:Columns", $ns)
+		if ($columns -and ($typeStr -eq "ValueTable" -or $typeStr -eq "ValueTree")) {
+			$cols = @()
+			foreach ($col in $columns.SelectNodes("d:Column", $ns)) {
+				$cName = $col.GetAttribute("name")
+				$cTypeNode = $col.SelectSingleNode("d:Type", $ns)
+				$cType = Format-Type $cTypeNode
+				if ($cType) { $cols += "$cName`: $cType" } else { $cols += $cName }
+			}
+			if ($cols.Count -gt 0) {
+				$colStr = " [$($cols -join ', ')]"
+			}
+		}
+
+		$line = "  $prefix$aName`: $typeStr$colStr$dynTable$mainSuffix"
+		if (-not $typeStr -and -not $colStr -and -not $dynTable) {
+			$line = "  $prefix$aName$mainSuffix"
+		}
+		$attrLines += $line
+	}
+	if ($attrLines.Count -gt 0) {
+		$lines += ""
+		$lines += "Attributes:"
+		$lines += $attrLines
+	}
+}
+
+# --- Parameters ---
+
+$paramsNode = $root.SelectSingleNode("d:Parameters", $ns)
+if ($paramsNode) {
+	$paramLines = @()
+	foreach ($param in $paramsNode.SelectNodes("d:Parameter", $ns)) {
+		$pName = $param.GetAttribute("name")
+		$typeNode = $param.SelectSingleNode("d:Type", $ns)
+		$typeStr = Format-Type $typeNode
+
+		$keyParam = $param.SelectSingleNode("d:KeyParameter", $ns)
+		$isKey = ($keyParam -and $keyParam.InnerText -eq "true")
+		$keySuffix = if ($isKey) { " (key)" } else { "" }
+
+		if ($typeStr) {
+			$paramLines += "  $pName`: $typeStr$keySuffix"
+		} else {
+			$paramLines += "  $pName$keySuffix"
+		}
+	}
+	if ($paramLines.Count -gt 0) {
+		$lines += ""
+		$lines += "Parameters:"
+		$lines += $paramLines
+	}
+}
+
+# --- Commands ---
+
+$cmdsNode = $root.SelectSingleNode("d:Commands", $ns)
+if ($cmdsNode) {
+	$cmdLines = @()
+	foreach ($cmd in $cmdsNode.SelectNodes("d:Command", $ns)) {
+		$cName = $cmd.GetAttribute("name")
+		$action = $cmd.SelectSingleNode("d:Action", $ns)
+		$shortcut = $cmd.SelectSingleNode("d:Shortcut", $ns)
+
+		$actionStr = if ($action) { " -> $($action.InnerText)" } else { "" }
+		$scStr = if ($shortcut) { " [$($shortcut.InnerText)]" } else { "" }
+
+		$cmdLines += "  $cName$actionStr$scStr"
+	}
+	if ($cmdLines.Count -gt 0) {
+		$lines += ""
+		$lines += "Commands:"
+		$lines += $cmdLines
+	}
+}
+
+# --- Truncation protection ---
+
+$totalLines = $lines.Count
+
+if ($Offset -gt 0) {
+	if ($Offset -ge $totalLines) {
+		Write-Host "[INFO] Offset $Offset exceeds total lines ($totalLines). Nothing to show."
+		exit 0
+	}
+	$lines = $lines[$Offset..($totalLines - 1)]
+}
+
+if ($lines.Count -gt $Limit) {
+	$shown = $lines[0..($Limit - 1)]
+	foreach ($l in $shown) { Write-Host $l }
+	$remaining = $totalLines - $Offset - $Limit
+	Write-Host ""
+	Write-Host "[TRUNCATED] Shown $Limit of $totalLines lines. Use -Offset $($Offset + $Limit) to continue."
+} else {
+	foreach ($l in $lines) { Write-Host $l }
+}
@@ -0,0 +1,253 @@
+---
+name: form-patterns
+description: Справочник паттернов компоновки управляемых форм 1С — архетипы, конвенции именования, продвинутые приёмы
+argument-hint: (no arguments)
+allowed-tools: []
+---
+
+# /form-patterns — паттерны компоновки форм
+
+Справочник типовых паттернов дизайна управляемых форм 1С. Вызывай **перед** проектированием формы через `/form-compile`, когда требования пользователя не детализируют расположение элементов.
+
+**Как использовать:** выбери подходящий архетип, применяй конвенции именования, при необходимости используй продвинутые паттерны.
+
+---
+
+## Архетипы форм
+
+### Форма документа
+
+```
+Шапка (horizontal, 2 колонки)
+├─ Левая (vertical): НомерДата (H: Номер + Дата "от"), Контрагент, Договор
+├─ Правая (vertical): Организация, Подразделение, ЦеныИВалюта (надпись-ссылка)
+Страницы (pages)
+├─ Товары: таблица Объект.Товары
+├─ Услуги: таблица Объект.Услуги (опционально)
+└─ Дополнительно: прочие реквизиты
+Подвал (vertical)
+├─ Итоги (horizontal): Всего, НДС, Скидка
+└─ КомментарийОтветственный (horizontal): Комментарий + Ответственный
+```
+
+**События:** OnCreateAtServer, OnReadAtServer, OnOpen, BeforeWriteAtServer, AfterWriteAtServer, AfterWrite, NotificationProcessing
+**Свойства:** autoTitle=false
+
+### Форма обработки (DataProcessor)
+
+```
+Параметры (vertical)
+├─ Группа полей ввода (Организация, Период, режимы работы)
+├─ Информационные надписи (label, hyperlink)
+Рабочая область
+├─ Таблица данных или Pages с вкладками
+Кнопки действий
+├─ Выполнить / Применить (defaultButton)
+├─ Закрыть (stdCommand: Close)
+```
+
+**События:** OnCreateAtServer, OnOpen, NotificationProcessing
+**Свойства:** windowOpeningMode=LockOwnerWindow (если диалог), autoTitle=false
+
+### Форма списка
+
+```
+Отборы (group: alwaysHorizontal)
+├─ ГруппаОтбор[Поле] (H): Флажок + Поле ввода (для каждого фильтра)
+Список (table, DynamicList)
+├─ Колонки: labelField (не input — данные только для чтения)
+```
+
+**События:** OnCreateAtServer, OnOpen, NotificationProcessing, OnLoadDataFromSettingsAtServer
+**Свойства:** autoSaveDataInSettings=Use
+**Фильтры:** пара реквизитов на каждый — `Отбор[Поле]` (значение) + `Отбор[Поле]Использование` (boolean)
+
+### Форма элемента справочника
+
+**Простая:**
+```
+ГруппаРеквизитов (horizontal)
+├─ Наименование -> Объект.Description
+└─ Код -> Объект.Code (если нужен)
+```
+
+**Сложная:**
+```
+Главное (vertical)
+├─ Наименование -> Объект.Description
+├─ Параметры (horizontal, 2 колонки)
+│  ├─ Левая: основные реквизиты
+│  └─ Правая: дополнительные реквизиты
+└─ КонтактныеДанные / Дополнительно (vertical)
+```
+
+**События:** OnCreateAtServer, OnReadAtServer, BeforeWriteAtServer, NotificationProcessing
+
+### Мастер (Wizard)
+
+```
+Страницы (pages, OnCurrentPageChange)
+├─ Шаг1: описание + параметры
+├─ Шаг2: основная работа
+└─ Шаг3: результат
+Кнопки (horizontal)
+├─ Назад (command), Далее (command, defaultButton), Выполнить (command)
+└─ Закрыть (stdCommand: Close)
+```
+
+**Свойства:** windowOpeningMode=LockOwnerWindow, commandBarLocation=None
+
+---
+
+## Конвенции именования
+
+### Группы
+
+| Назначение | Имя | Тип |
+|-----------|-----|-----|
+| Шапка | `ГруппаШапка` | horizontal |
+| Левая колонка | `ГруппаШапкаЛевая` | vertical |
+| Правая колонка | `ГруппаШапкаПравая` | vertical |
+| Номер+Дата | `ГруппаНомерДата` | horizontal |
+| Подвал | `ГруппаПодвал` | vertical |
+| Итоги | `ГруппаИтоги` | horizontal |
+| Кнопки | `ГруппаКнопок` | horizontal |
+| Страницы | `ГруппаСтраницы` / `Страницы` | pages |
+| Предупреждение | `ГруппаПредупреждение` | horizontal, visible:false |
+| Доп. секция | `ГруппаДополнительно` / `ГруппаПрочее` | vertical, collapse |
+
+### Элементы
+
+| Назначение | Имя |
+|-----------|-----|
+| Поле в таблице | `[Таблица][Поле]` |
+| Итог | `Итоги[Поле]` |
+| Надпись-ссылка | `[Поле]Надпись` |
+| Фильтр | `Отбор[Поле]` |
+| Флажок фильтра | `Отбор[Поле]Использование` |
+| Кнопка команды | `[Команда]Кнопка` |
+| Баннер-картинка | `[Баннер]Картинка` |
+| Баннер-надпись | `[Баннер]Надпись` |
+| Подменю | `Подменю[Действие]` |
+
+### Обработчики событий
+
+Имя = имя элемента + суффикс на русском:
+
+| Событие | Суффикс | Пример |
+|---------|---------|--------|
+| OnChange | ПриИзменении | `ОрганизацияПриИзменении` |
+| StartChoice | НачалоВыбора | `КонтрагентНачалоВыбора` |
+| Click | Нажатие | `ЦеныИВалютаНажатие` |
+| OnEditEnd | ПриОкончанииРедактирования | `ТоварыПриОкончанииРедактирования` |
+| OnStartEdit | ПриНачалеРедактирования | `ТоварыПриНачалеРедактирования` |
+
+Обработчики формы: `ПриСозданииНаСервере`, `ПриОткрытии`, `ПередЗакрытием`, `ОбработкаОповещения`.
+
+---
+
+## Принципы компоновки
+
+1. **Порядок чтения.** Сверху вниз, слева направо. Самое важное — вверху.
+2. **Двухколоночная шапка.** Основные реквизиты слева (контрагент, склад), организационные справа (организация, подразделение).
+3. **Кнопки действий внизу.** Главная кнопка — `defaultButton: true`. Закрыть — всегда последняя.
+4. **Таблицы — основная область.** Табличные части занимают большую часть формы, обычно на Pages.
+5. **Итоги рядом с таблицей.** В подвале, горизонтальная группа, все поля readOnly.
+6. **Фильтры — отдельная зона.** Над списком, alwaysHorizontal, пара «флажок + поле» на каждый фильтр.
+7. **Скрытые элементы для состояний.** Баннеры, предупреждения — `visible: false`, показываются программно.
+8. **Надписи-ссылки для диалогов.** `labelField` с `hyperlink: true` и событием Click.
+
+---
+
+## Продвинутые паттерны (ERP)
+
+### Сворачиваемые группы
+
+Для необязательных секций (подписи, дополнительно, прочее):
+
+```json
+{ "group": "vertical", "name": "ГруппаПодписи", "title": "Подписи",
+  "behavior": "Collapsible", "collapsed": true, "children": [...] }
+```
+
+### Баннер-предупреждение
+
+Группа «картинка + надпись», скрыта по умолчанию, показывается программно:
+
+```json
+{ "group": "horizontal", "name": "ГруппаПредупреждение", "showTitle": false,
+  "visible": false, "children": [
+    { "picture": "ПредупреждениеКартинка" },
+    { "label": "ПредупреждениеНадпись", "title": "Текст", "maxWidth": 76, "autoMaxWidth": false }
+]}
+```
+
+### Popup-меню в командной панели
+
+Группировка связанных команд (печать, отправка) в одну кнопку с иконкой:
+
+```json
+{ "cmdBar": "КоманднаяПанель", "children": [
+    { "popup": "ПодменюПечать", "title": "Печать",
+      "picture": "StdPicture.Print", "representation": "Picture", "children": [
+        { "button": "ПечатьНакладная", "command": "Печать" },
+        { "button": "ПечатьСчёт", "command": "ПечатьСчёт" }
+    ]}
+]}
+```
+
+### Форма без стандартной командной панели
+
+Для модальных диалогов и мастеров:
+
+```json
+{ "properties": { "commandBarLocation": "None", "windowOpeningMode": "LockWholeInterface" } }
+```
+
+### Надпись-гиперссылка
+
+Вместо кнопки для открытия подформ (ЦеныИВалюта, УчётнаяПолитика):
+
+```json
+{ "labelField": "ЦеныИВалютаНадпись", "path": "ЦеныИВалюта", "hyperlink": true, "on": ["Click"] }
+```
+
+---
+
+## Пример: форма обработки (полный DSL)
+
+```json
+{
+  "title": "Загрузка данных из CSV",
+  "properties": { "autoTitle": false, "windowOpeningMode": "LockOwnerWindow" },
+  "events": { "OnCreateAtServer": "ПриСозданииНаСервере" },
+  "elements": [
+    { "group": "vertical", "name": "ГруппаПараметры", "children": [
+      { "input": "ФайлЗагрузки", "path": "ФайлЗагрузки", "title": "Файл", "clearButton": true, "horizontalStretch": true, "on": ["StartChoice"] },
+      { "input": "Кодировка", "path": "Кодировка" },
+      { "input": "Разделитель", "path": "Разделитель", "title": "Разделитель колонок" }
+    ]},
+    { "table": "Данные", "path": "Объект.Данные", "on": ["OnStartEdit"], "columns": [
+      { "input": "ДанныеНомерСтроки", "path": "Объект.Данные.LineNumber", "readOnly": true, "title": "№" },
+      { "input": "ДанныеНаименование", "path": "Объект.Данные.Наименование" },
+      { "input": "ДанныеКоличество", "path": "Объект.Данные.Количество", "on": ["OnChange"] },
+      { "input": "ДанныеСумма", "path": "Объект.Данные.Сумма", "readOnly": true }
+    ]},
+    { "group": "horizontal", "name": "ГруппаКнопок", "children": [
+      { "button": "Загрузить", "command": "Загрузить", "title": "Загрузить из файла", "defaultButton": true },
+      { "button": "Очистить", "command": "Очистить", "title": "Очистить таблицу" },
+      { "button": "Закрыть", "stdCommand": "Close" }
+    ]}
+  ],
+  "attributes": [
+    { "name": "Объект", "type": "ExternalDataProcessorObject.ЗагрузкаИзCSV", "main": true },
+    { "name": "ФайлЗагрузки", "type": "string" },
+    { "name": "Кодировка", "type": "string(20)" },
+    { "name": "Разделитель", "type": "string(5)" }
+  ],
+  "commands": [
+    { "name": "Загрузить", "action": "ЗагрузитьОбработка" },
+    { "name": "Очистить", "action": "ОчиститьОбработка" }
+  ]
+}
+```
@@ -0,0 +1,78 @@
+---
+name: form-validate
+description: Валидация структурной корректности управляемой формы 1С (Form.xml)
+argument-hint: <FormPath>
+allowed-tools:
+  - Bash
+  - Read
+  - Glob
+---
+
+# /form-validate — Валидатор формы
+
+Проверяет Form.xml управляемой формы на структурные ошибки: уникальность ID, наличие companion-элементов, корректность ссылок DataPath и команд.
+
+## Использование
+
+```
+/form-validate <FormPath>
+```
+
+## Параметры
+
+| Параметр  | Обязательный | По умолчанию | Описание                    |
+|-----------|:------------:|--------------|-----------------------------|
+| FormPath  | да           | —            | Путь к файлу Form.xml       |
+| MaxErrors | нет          | 30           | Остановиться после N ошибок |
+
+## Команда
+
+```powershell
+powershell.exe -NoProfile -File .claude\skills\form-validate\scripts\form-validate.ps1 -FormPath "<путь>"
+```
+
+## Выполняемые проверки
+
+| # | Проверка | Серьёзность |
+|---|---|---|
+| 1 | Корневой элемент `<Form>`, version="2.17" | ERROR / WARN |
+| 2 | `<AutoCommandBar>` присутствует, id="-1" | ERROR |
+| 3 | Уникальность ID элементов (отдельный пул) | ERROR |
+| 4 | Уникальность ID реквизитов (отдельный пул) | ERROR |
+| 5 | Уникальность ID команд (отдельный пул) | ERROR |
+| 6 | Companion-элементы (ContextMenu, ExtendedTooltip, и др.) | ERROR |
+| 7 | DataPath → ссылается на существующий реквизит | ERROR |
+| 8 | CommandName кнопок → ссылается на существующую команду | ERROR |
+| 9 | События имеют непустые имена обработчиков | ERROR |
+| 10 | Команды имеют Action (обработчик) | ERROR |
+| 11 | Не более одного MainAttribute | ERROR |
+
+## Вывод
+
+```
+=== Validation: ФормаДокумента ===
+
+[OK]    Root element: Form version=2.17
+[OK]    AutoCommandBar: name='ФормаКоманднаяПанель', id=-1
+[OK]    Unique element IDs: 96 elements
+[OK]    Unique attribute IDs: 38 entries
+[OK]    Unique command IDs: 5 entries
+[OK]    Companion elements: 86 elements checked
+[OK]    DataPath references: 53 paths checked
+[OK]    Command references: 2 buttons checked
+[OK]    Event handlers: 41 events checked
+[OK]    Command actions: 5 commands checked
+[OK]    MainAttribute: 1 main attribute
+
+---
+Total: 96 elements, 38 attributes, 5 commands
+All checks passed.
+```
+
+Код возврата: 0 = все проверки пройдены, 1 = есть ошибки.
+
+## Когда использовать
+
+- **После `/form-compile`**: проверить корректность сгенерированной формы
+- **После ручного редактирования Form.xml**: убедиться что ID уникальны, companions на месте, ссылки валидны
+- **При отладке**: выявить ошибки в структуре формы до сборки EPF
@@ -0,0 +1,500 @@
+param(
+	[Parameter(Mandatory)]
+	[string]$FormPath,
+
+	[int]$MaxErrors = 30
+)
+
+$ErrorActionPreference = "Stop"
+[Console]::OutputEncoding = [System.Text.Encoding]::UTF8
+
+# --- Load XML ---
+
+if (-not (Test-Path $FormPath)) {
+	Write-Error "File not found: $FormPath"
+	exit 1
+}
+
+$xmlDoc = New-Object System.Xml.XmlDocument
+$xmlDoc.PreserveWhitespace = $false
+try {
+	$xmlDoc.Load((Resolve-Path $FormPath).Path)
+} catch {
+	Write-Host "[ERROR] XML parse error: $($_.Exception.Message)"
+	Write-Host ""
+	Write-Host "---"
+	Write-Host "Errors: 1, Warnings: 0"
+	exit 1
+}
+
+$nsMgr = New-Object System.Xml.XmlNamespaceManager($xmlDoc.NameTable)
+$nsMgr.AddNamespace("f", "http://v8.1c.ru/8.3/xcf/logform")
+$nsMgr.AddNamespace("v8", "http://v8.1c.ru/8.1/data/core")
+
+$root = $xmlDoc.DocumentElement
+
+# --- Counters ---
+
+$errors = 0
+$warnings = 0
+$stopped = $false
+
+function Report-OK {
+	param([string]$msg)
+	Write-Host "[OK]    $msg"
+}
+
+function Report-Error {
+	param([string]$msg)
+	$script:errors++
+	Write-Host "[ERROR] $msg"
+	if ($script:errors -ge $MaxErrors) {
+		$script:stopped = $true
+	}
+}
+
+function Report-Warn {
+	param([string]$msg)
+	$script:warnings++
+	Write-Host "[WARN]  $msg"
+}
+
+# --- Form name from path ---
+
+$formName = [System.IO.Path]::GetFileNameWithoutExtension($FormPath)
+$parentDir = [System.IO.Path]::GetDirectoryName($FormPath)
+if ($parentDir) {
+	$extDir = [System.IO.Path]::GetFileName($parentDir)
+	if ($extDir -eq "Ext") {
+		$formDir = [System.IO.Path]::GetDirectoryName($parentDir)
+		if ($formDir) { $formName = [System.IO.Path]::GetFileName($formDir) }
+	}
+}
+
+Write-Host "=== Validation: $formName ==="
+Write-Host ""
+
+# --- Check 1: Root element and version ---
+
+if ($root.LocalName -ne "Form") {
+	Report-Error "Root element is '$($root.LocalName)', expected 'Form'"
+} else {
+	$version = $root.GetAttribute("version")
+	if ($version -eq "2.17") {
+		Report-OK "Root element: Form version=$version"
+	} elseif ($version) {
+		Report-Warn "Form version='$version' (expected 2.17)"
+	} else {
+		Report-Warn "Form version attribute missing"
+	}
+}
+
+# --- Check 2: AutoCommandBar ---
+
+if (-not $stopped) {
+	$acb = $root.SelectSingleNode("f:AutoCommandBar", $nsMgr)
+	if ($acb) {
+		$acbName = $acb.GetAttribute("name")
+		$acbId = $acb.GetAttribute("id")
+		if ($acbId -eq "-1") {
+			Report-OK "AutoCommandBar: name='$acbName', id=$acbId"
+		} else {
+			Report-Error "AutoCommandBar id='$acbId', expected '-1'"
+		}
+	} else {
+		Report-Error "AutoCommandBar element missing"
+	}
+}
+
+# --- Collect all elements with IDs ---
+
+$elementIds = @{}  # id -> name (element ID pool)
+$allElements = @() # @{Name; Tag; Id; ParentName; Node}
+
+function Collect-Elements {
+	param($node, [string]$parentName)
+
+	foreach ($child in $node.ChildNodes) {
+		if ($child.NodeType -ne 'Element') { continue }
+
+		$name = $child.GetAttribute("name")
+		$id = $child.GetAttribute("id")
+
+		if ($name -and $id) {
+			$tag = $child.LocalName
+
+			$script:allElements += @{
+				Name       = $name
+				Tag        = $tag
+				Id         = $id
+				ParentName = $parentName
+				Node       = $child
+			}
+
+			# Track element IDs (skip AutoCommandBar which has -1)
+			if ($id -ne "-1") {
+				if ($elementIds.ContainsKey($id)) {
+					Report-Error "Duplicate element id=${id}: '$name' and '$($elementIds[$id])'"
+				} else {
+					$elementIds[$id] = $name
+				}
+			}
+
+			# Recurse into ChildItems
+			$childItems = $child.SelectSingleNode("f:ChildItems", $nsMgr)
+			if ($childItems) {
+				Collect-Elements -node $childItems -parentName $name
+			}
+		}
+	}
+}
+
+# Collect from ChildItems
+$childItemsRoot = $root.SelectSingleNode("f:ChildItems", $nsMgr)
+if ($childItemsRoot) {
+	Collect-Elements -node $childItemsRoot -parentName "(root)"
+}
+
+# Also collect from AutoCommandBar's ChildItems
+$acb = $root.SelectSingleNode("f:AutoCommandBar", $nsMgr)
+if ($acb) {
+	$acbChildren = $acb.SelectSingleNode("f:ChildItems", $nsMgr)
+	if ($acbChildren) {
+		Collect-Elements -node $acbChildren -parentName "ФормаКоманднаяПанель"
+	}
+}
+
+# --- Check 3: Unique element IDs ---
+
+if (-not $stopped) {
+	$dupCount = ($allElements | Group-Object { $_.Id } | Where-Object { $_.Count -gt 1 -and $_.Name -ne "-1" }).Count
+	if ($dupCount -eq 0) {
+		Report-OK "Unique element IDs: $($elementIds.Count) elements"
+	}
+}
+
+# --- Collect attributes (separate ID pool) ---
+
+$attrMap = @{}    # name -> node
+$attrIds = @{}    # id -> name
+$attrNodes = $root.SelectNodes("f:Attributes/f:Attribute", $nsMgr)
+foreach ($attr in $attrNodes) {
+	$attrName = $attr.GetAttribute("name")
+	$attrId = $attr.GetAttribute("id")
+	if ($attrName) {
+		$attrMap[$attrName] = $attr
+	}
+	if ($attrId -and $attrId -ne "") {
+		if ($attrIds.ContainsKey($attrId)) {
+			Report-Error "Duplicate attribute id=${attrId}: '$attrName' and '$($attrIds[$attrId])'"
+		} else {
+			$attrIds[$attrId] = $attrName
+		}
+	}
+
+	# Column IDs are a separate sub-pool per attribute — check uniqueness within parent
+	$colIds = @{}
+	foreach ($col in $attr.SelectNodes("f:Columns/f:Column", $nsMgr)) {
+		$colId = $col.GetAttribute("id")
+		$colName = $col.GetAttribute("name")
+		if ($colId -and $colId -ne "") {
+			if ($colIds.ContainsKey($colId)) {
+				Report-Error "Duplicate column id=${colId} in '$attrName': '$colName' and '$($colIds[$colId])'"
+			} else {
+				$colIds[$colId] = $colName
+			}
+		}
+	}
+}
+
+if (-not $stopped) {
+	$attrDupCount = ($attrIds.GetEnumerator() | Group-Object Value | Where-Object { $_.Count -gt 1 }).Count
+	if ($attrDupCount -eq 0 -and $attrIds.Count -gt 0) {
+		Report-OK "Unique attribute IDs: $($attrIds.Count) entries"
+	}
+}
+
+# --- Collect commands (separate ID pool) ---
+
+$cmdMap = @{}   # name -> node
+$cmdIds = @{}   # id -> name
+$cmdNodes = $root.SelectNodes("f:Commands/f:Command", $nsMgr)
+foreach ($cmd in $cmdNodes) {
+	$cmdName = $cmd.GetAttribute("name")
+	$cmdId = $cmd.GetAttribute("id")
+	if ($cmdName) {
+		$cmdMap[$cmdName] = $cmd
+	}
+	if ($cmdId -and $cmdId -ne "") {
+		if ($cmdIds.ContainsKey($cmdId)) {
+			Report-Error "Duplicate command id=${cmdId}: '$cmdName' and '$($cmdIds[$cmdId])'"
+		} else {
+			$cmdIds[$cmdId] = $cmdName
+		}
+	}
+}
+
+if (-not $stopped) {
+	if ($cmdIds.Count -gt 0) {
+		$cmdDupCount = ($cmdIds.GetEnumerator() | Group-Object Value | Where-Object { $_.Count -gt 1 }).Count
+		if ($cmdDupCount -eq 0) {
+			Report-OK "Unique command IDs: $($cmdIds.Count) entries"
+		}
+	}
+}
+
+# --- Check 4: Companion elements ---
+
+# Define required companions per element type
+$companionRules = @{
+	"InputField"        = @("ContextMenu", "ExtendedTooltip")
+	"CheckBoxField"     = @("ContextMenu", "ExtendedTooltip")
+	"LabelDecoration"   = @("ContextMenu", "ExtendedTooltip")
+	"LabelField"        = @("ContextMenu", "ExtendedTooltip")
+	"PictureDecoration" = @("ContextMenu", "ExtendedTooltip")
+	"PictureField"      = @("ContextMenu", "ExtendedTooltip")
+	"CalendarField"     = @("ContextMenu", "ExtendedTooltip")
+	"UsualGroup"        = @("ExtendedTooltip")
+	"Pages"             = @("ExtendedTooltip")
+	"Page"              = @("ExtendedTooltip")
+	"Button"            = @("ExtendedTooltip")
+	"Table"             = @("ContextMenu", "AutoCommandBar", "SearchStringAddition", "ViewStatusAddition", "SearchControlAddition")
+}
+
+if (-not $stopped) {
+	$companionErrors = 0
+	$companionChecked = 0
+
+	foreach ($el in $allElements) {
+		if ($stopped) { break }
+		$tag = $el.Tag
+		$elName = $el.Name
+		$node = $el.Node
+
+		if (-not $companionRules.ContainsKey($tag)) { continue }
+
+		$required = $companionRules[$tag]
+		$companionChecked++
+
+		foreach ($compTag in $required) {
+			$compNode = $node.SelectSingleNode("f:$compTag", $nsMgr)
+			if (-not $compNode) {
+				Report-Error "[$tag] '$elName': missing companion <$compTag>"
+				$companionErrors++
+			}
+		}
+	}
+
+	if ($companionErrors -eq 0 -and $companionChecked -gt 0) {
+		Report-OK "Companion elements: $companionChecked elements checked"
+	}
+}
+
+# --- Check 5: DataPath -> Attribute references ---
+
+if (-not $stopped) {
+	$pathErrors = 0
+	$pathChecked = 0
+
+	foreach ($el in $allElements) {
+		if ($stopped) { break }
+		$tag = $el.Tag
+		$elName = $el.Name
+		$node = $el.Node
+
+		# Skip companion elements
+		if ($tag -in @("ContextMenu", "ExtendedTooltip", "AutoCommandBar", "SearchStringAddition", "ViewStatusAddition", "SearchControlAddition")) {
+			continue
+		}
+
+		$dpNode = $node.SelectSingleNode("f:DataPath", $nsMgr)
+		if (-not $dpNode) { continue }
+
+		$dataPath = $dpNode.InnerText.Trim()
+		if (-not $dataPath) { continue }
+
+		$pathChecked++
+
+		# Extract root segment of path, strip array indices like [0]
+		$cleanPath = $dataPath -replace '\[\d+\]', ''
+		$segments = $cleanPath -split '\.'
+		$rootAttr = $segments[0]
+
+		if (-not $attrMap.ContainsKey($rootAttr)) {
+			Report-Error "[$tag] '$elName': DataPath='$dataPath' — attribute '$rootAttr' not found"
+			$pathErrors++
+		}
+	}
+
+	if ($pathErrors -eq 0 -and $pathChecked -gt 0) {
+		Report-OK "DataPath references: $pathChecked paths checked"
+	} elseif ($pathChecked -eq 0) {
+		Report-OK "DataPath references: none"
+	}
+}
+
+# --- Check 6: Button command references ---
+
+if (-not $stopped) {
+	$cmdErrors = 0
+	$cmdChecked = 0
+
+	foreach ($el in $allElements) {
+		if ($stopped) { break }
+		$tag = $el.Tag
+		$elName = $el.Name
+		$node = $el.Node
+
+		if ($tag -ne "Button") { continue }
+
+		$cmdNode = $node.SelectSingleNode("f:CommandName", $nsMgr)
+		if (-not $cmdNode) { continue }
+
+		$cmdRef = $cmdNode.InnerText.Trim()
+		if (-not $cmdRef) { continue }
+
+		# Form.Command.XXX -> check command XXX exists
+		if ($cmdRef -match '^Form\.Command\.(.+)$') {
+			$cmdName = $Matches[1]
+			$cmdChecked++
+			if (-not $cmdMap.ContainsKey($cmdName)) {
+				Report-Error "[Button] '$elName': CommandName='$cmdRef' — command '$cmdName' not found in Commands"
+				$cmdErrors++
+			}
+		}
+		# Form.StandardCommand.XXX — skip, standard commands always exist
+	}
+
+	if ($cmdErrors -eq 0 -and $cmdChecked -gt 0) {
+		Report-OK "Command references: $cmdChecked buttons checked"
+	} elseif ($cmdChecked -eq 0) {
+		Report-OK "Command references: none"
+	}
+}
+
+# --- Check 7: Events have handler names ---
+
+if (-not $stopped) {
+	$eventErrors = 0
+	$eventChecked = 0
+
+	# Form-level events
+	$formEvents = $root.SelectSingleNode("f:Events", $nsMgr)
+	if ($formEvents) {
+		foreach ($evt in $formEvents.SelectNodes("f:Event", $nsMgr)) {
+			$evtName = $evt.GetAttribute("name")
+			$handler = $evt.InnerText.Trim()
+			$eventChecked++
+			if (-not $handler) {
+				Report-Error "Form event '$evtName': empty handler name"
+				$eventErrors++
+			}
+		}
+	}
+
+	# Element-level events
+	foreach ($el in $allElements) {
+		if ($stopped) { break }
+		$tag = $el.Tag
+		$elName = $el.Name
+		$node = $el.Node
+
+		$eventsNode = $node.SelectSingleNode("f:Events", $nsMgr)
+		if (-not $eventsNode) { continue }
+
+		foreach ($evt in $eventsNode.SelectNodes("f:Event", $nsMgr)) {
+			$evtName = $evt.GetAttribute("name")
+			$handler = $evt.InnerText.Trim()
+			$eventChecked++
+			if (-not $handler) {
+				Report-Error "[$tag] '$elName' event '$evtName': empty handler name"
+				$eventErrors++
+			}
+		}
+	}
+
+	if ($eventErrors -eq 0 -and $eventChecked -gt 0) {
+		Report-OK "Event handlers: $eventChecked events checked"
+	} elseif ($eventChecked -eq 0) {
+		Report-OK "Event handlers: none"
+	}
+}
+
+# --- Check 8: Command actions ---
+
+if (-not $stopped) {
+	$actionErrors = 0
+	$actionChecked = 0
+
+	foreach ($cmd in $cmdNodes) {
+		if ($stopped) { break }
+		$cmdName = $cmd.GetAttribute("name")
+		$actionNode = $cmd.SelectSingleNode("f:Action", $nsMgr)
+		$actionChecked++
+		if (-not $actionNode -or -not $actionNode.InnerText.Trim()) {
+			Report-Error "Command '$cmdName': missing or empty Action"
+			$actionErrors++
+		}
+	}
+
+	if ($actionErrors -eq 0 -and $actionChecked -gt 0) {
+		Report-OK "Command actions: $actionChecked commands checked"
+	} elseif ($actionChecked -eq 0) {
+		Report-OK "Command actions: none"
+	}
+}
+
+# --- Check 9: MainAttribute count ---
+
+if (-not $stopped) {
+	$mainCount = 0
+	foreach ($attr in $attrNodes) {
+		$mainNode = $attr.SelectSingleNode("f:MainAttribute", $nsMgr)
+		if ($mainNode -and $mainNode.InnerText -eq "true") {
+			$mainCount++
+		}
+	}
+
+	if ($mainCount -le 1) {
+		$mainInfo = if ($mainCount -eq 1) { "1 main attribute" } else { "no main attribute" }
+		Report-OK "MainAttribute: $mainInfo"
+	} else {
+		Report-Error "Multiple MainAttribute=true ($mainCount found, expected 0 or 1)"
+	}
+}
+
+# --- Check 10: Title must be multilingual XML (not plain text) ---
+
+if (-not $stopped) {
+	$titleNode = $root.SelectSingleNode("f:Title", $nsMgr)
+	if ($titleNode) {
+		$v8items = $titleNode.SelectNodes("v8:item", $nsMgr)
+		if ($v8items.Count -eq 0 -and $titleNode.InnerText.Trim() -ne "") {
+			Report-Error "Form Title is plain text ('$($titleNode.InnerText.Trim())') — must be multilingual XML (<v8:item>). Use top-level 'title' key in form-compile DSL."
+		} else {
+			Report-OK "Title: multilingual XML"
+		}
+	}
+}
+
+# --- Summary ---
+
+Write-Host ""
+Write-Host "---"
+Write-Host "Total: $($allElements.Count) elements, $($attrNodes.Count) attributes, $($cmdNodes.Count) commands"
+
+if ($stopped) {
+	Write-Host "Stopped after $MaxErrors errors. Fix and re-run."
+}
+
+if ($errors -eq 0 -and $warnings -eq 0) {
+	Write-Host "All checks passed."
+} else {
+	Write-Host "Errors: $errors, Warnings: $warnings"
+}
+
+if ($errors -gt 0) {
+	exit 1
+} else {
+	exit 0
+}
@@ -21,6 +21,7 @@
 |--------|--------|----------|------|
 | Внешние обработки (EPF) | 10 навыков `/epf-*` | Создание, модификация, сборка обработок из XML-исходников | [Подробнее](docs/epf-guide.md) |
 | Табличный документ (MXL) | 4 навыка `/mxl-*` | Анализ, создание, компиляция макетов печатных форм | [Подробнее](docs/mxl-guide.md) |
+| Управляемые формы (Form) | 4 навыка `/form-*` | Анализ, генерация, модификация, валидация управляемых форм | [Подробнее](docs/form-guide.md) |
 | Утилиты | `/img-grid` | Наложение сетки на изображение для определения пропорций колонок | — |

 ## Требования
@@ -36,6 +37,7 @@
 - [Сборка и разборка EPF](docs/build-spec.md) — команды `1cv8.exe`, параметры, коды возврата
 - [Табличный документ (MXL)](docs/1c-spreadsheet-spec.md) — XML-формат SpreadsheetDocument, совместимость версий
 - [MXL DSL](docs/mxl-dsl-spec.md) — JSON-формат описания макета для `/mxl-compile` и `/mxl-decompile`
+- [Form DSL](docs/form-dsl-spec.md) — JSON-формат описания формы для `/form-compile`

 ## Структура репозитория

@@ -55,14 +57,20 @@
 ├── mxl-validate/        # Валидация макета
 ├── mxl-compile/         # Компиляция макета из JSON
 ├── mxl-decompile/       # Декомпиляция макета в JSON
+├── form-info/           # Анализ структуры управляемой формы
+├── form-compile/        # Компиляция формы из JSON
+├── form-validate/       # Валидация формы
+├── form-add/            # Добавление элементов в форму
 └── img-grid/            # Сетка для анализа изображений
 docs/
 ├── epf-guide.md            # Гайд: внешние обработки
 ├── mxl-guide.md            # Гайд: табличный документ
+├── form-guide.md           # Гайд: управляемые формы
 ├── 1c-xml-format-spec.md   # Спецификация XML-формата
 ├── 1c-form-spec.md         # Спецификация управляемых форм
 ├── 1c-help-spec.md         # Спецификация встроенной справки
 ├── build-spec.md           # Спецификация сборки/разборки
 ├── 1c-spreadsheet-spec.md  # Спецификация табличного документа
-└── mxl-dsl-spec.md         # Спецификация MXL DSL
+├── mxl-dsl-spec.md         # Спецификация MXL DSL
+└── form-dsl-spec.md        # Спецификация Form DSL
 ```
@@ -0,0 +1,462 @@
+# Form DSL Specification
+
+Спецификация JSON-формата для `/form-compile` — компактного описания управляемых форм 1С:Предприятия 8.3.
+
+---
+
+## 1. Корневой объект
+
+```json
+{
+  "title": "Заголовок формы",
+  "properties": { ... },
+  "excludedCommands": [ ... ],
+  "events": { ... },
+  "elements": [ ... ],
+  "attributes": [ ... ],
+  "parameters": [ ... ],
+  "commands": [ ... ]
+}
+```
+
+| Поле | Тип | Описание |
+|------|-----|----------|
+| `title` | string | Заголовок формы (необязательный) |
+| `properties` | object | Свойства формы (необязательный) |
+| `excludedCommands` | string[] | Исключённые стандартные команды (необязательный) |
+| `events` | object | Обработчики событий формы (необязательный) |
+| `elements` | array | Дерево UI-элементов (необязательный) |
+| `attributes` | array | Реквизиты формы (необязательный) |
+| `parameters` | array | Параметры формы (необязательный) |
+| `commands` | array | Команды формы (необязательный) |
+
+---
+
+## 2. Properties — свойства формы
+
+Объект со свойствами в camelCase. Компилятор преобразует в PascalCase для XML.
+
+```json
+"properties": {
+  "autoTitle": false,
+  "windowOpeningMode": "LockOwnerWindow",
+  "commandBarLocation": "Bottom"
+}
+```
+
+### Поддерживаемые свойства
+
+| DSL ключ | XML элемент | Значения |
+|----------|-------------|----------|
+| `autoTitle` | `<AutoTitle>` | `true` / `false` |
+| `windowOpeningMode` | `<WindowOpeningMode>` | `LockOwnerWindow`, `Modeless` |
+| `commandBarLocation` | `<CommandBarLocation>` | `Top`, `Bottom`, `None` |
+| `saveDataInSettings` | `<SaveDataInSettings>` | `UseList`, `Use`, `DontUse` |
+| `autoSaveDataInSettings` | `<AutoSaveDataInSettings>` | `Use`, `DontUse` |
+| `autoTime` | `<AutoTime>` | `CurrentOrLast`, `Current`, `Last` |
+| `usePostingMode` | `<UsePostingMode>` | `Auto`, `Postings`, `Movements` |
+| `repostOnWrite` | `<RepostOnWrite>` | `true` / `false` |
+| `autoURL` | `<AutoURL>` | `true` / `false` |
+| `autoFillCheck` | `<AutoFillCheck>` | `true` / `false` |
+| `customizable` | `<Customizable>` | `true` / `false` |
+| `enterKeyBehavior` | `<EnterKeyBehavior>` | `DefaultButton`, `NewLine` |
+| `verticalScroll` | `<VerticalScroll>` | `useIfNecessary`, `Auto`, `AlwaysShow`, `Never` |
+| `width` | `<Width>` | число |
+| `height` | `<Height>` | число |
+| `group` | `<Group>` | `Vertical`, `Horizontal`, `AlwaysHorizontal`, `AlwaysVertical` |
+| `useForFoldersAndItems` | `<UseForFoldersAndItems>` | `Folders`, `Items`, `FoldersAndItems` |
+
+Нераспознанные ключи преобразуются с автоматическим PascalCase (первая буква в верхний регистр).
+
+---
+
+## 3. Events — обработчики событий формы
+
+```json
+"events": {
+  "OnCreateAtServer": "ПриСозданииНаСервере",
+  "OnOpen": "ПриОткрытии"
+}
+```
+
+Ключ — имя события, значение — имя процедуры-обработчика.
+
+### Доступные события
+
+| Событие | Описание |
+|---------|----------|
+| `OnCreateAtServer` | Создание формы на сервере |
+| `OnOpen` | Открытие формы |
+| `BeforeClose` | Перед закрытием |
+| `OnClose` | При закрытии |
+| `BeforeWrite` | Перед записью |
+| `BeforeWriteAtServer` | Перед записью на сервере |
+| `OnWriteAtServer` | При записи на сервере |
+| `AfterWriteAtServer` | После записи на сервере |
+| `AfterWrite` | После записи |
+| `OnReadAtServer` | При чтении объекта |
+| `NotificationProcessing` | Обработка оповещений |
+| `ChoiceProcessing` | Обработка выбора |
+| `FillCheckProcessingAtServer` | Проверка заполнения |
+
+---
+
+## 4. Elements — дерево UI-элементов
+
+Массив объектов. Тип элемента определяется ключом-идентификатором.
+
+### 4.1. Общие свойства всех элементов
+
+| Свойство | Тип | Описание |
+|----------|-----|----------|
+| `name` | string | Имя элемента (по умолчанию — из значения ключа типа) |
+| `title` | string | Заголовок |
+| `hidden` | bool | `true` → `<Visible>false</Visible>` |
+| `disabled` | bool | `true` → `<Enabled>false</Enabled>` |
+| `readOnly` | bool | `true` → `<ReadOnly>true</ReadOnly>` |
+| `on` | string[] | Массив имён событий |
+| `handlers` | object | Явные имена обработчиков: `{"OnChange": "МойОбработчик"}` |
+
+### 4.2. Автоименование обработчиков
+
+При указании `"on"` без `"handlers"` имя обработчика генерируется автоматически:
+
+```
+<ИмяЭлемента><РусскийСуффикс>
+```
+
+| Событие | Суффикс |
+|---------|---------|
+| `OnChange` | `ПриИзменении` |
+| `StartChoice` | `НачалоВыбора` |
+| `ChoiceProcessing` | `ОбработкаВыбора` |
+| `AutoComplete` | `АвтоПодбор` |
+| `Clearing` | `Очистка` |
+| `Opening` | `Открытие` |
+| `Click` | `Нажатие` |
+| `OnActivateRow` | `ПриАктивизацииСтроки` |
+| `BeforeAddRow` | `ПередНачаломДобавления` |
+| `BeforeDeleteRow` | `ПередУдалением` |
+| `BeforeRowChange` | `ПередНачаломИзменения` |
+| `OnStartEdit` | `ПриНачалеРедактирования` |
+| `OnEndEdit` | `ПриОкончанииРедактирования` |
+| `Selection` | `ВыборСтроки` |
+| `OnCurrentPageChange` | `ПриСменеСтраницы` |
+| `TextEditEnd` | `ОкончаниеВводаТекста` |
+
+Пример: элемент `Контрагент` + событие `OnChange` → обработчик `КонтрагентПриИзменении`.
+
+### 4.3. Типы элементов
+
+#### group — UsualGroup
+
+```json
+{ "group": "horizontal", "name": "ГруппаШапка", "children": [ ... ] }
+```
+
+| Свойство | Тип | Описание |
+|----------|-----|----------|
+| `group` | string | Ориентация: `horizontal`, `vertical`, `alwaysHorizontal`, `alwaysVertical`, `collapsible` |
+| `children` | array | Вложенные элементы |
+| `showTitle` | bool | Показывать заголовок группы |
+| `representation` | string | `none`, `normal`, `weak`, `strong` |
+| `united` | bool | Объединение |
+
+#### input — InputField
+
+```json
+{ "input": "Организация", "path": "Объект.Организация", "on": ["OnChange"] }
+```
+
+| Свойство | Тип | Описание |
+|----------|-----|----------|
+| `path` | string | DataPath |
+| `multiLine` | bool | Многострочный режим |
+| `passwordMode` | bool | Режим пароля |
+| `titleLocation` | string | `none`, `left`, `right`, `top`, `bottom` |
+| `choiceButton` | bool | Показывать кнопку выбора |
+| `clearButton` | bool | Показывать кнопку очистки |
+| `spinButton` | bool | Показывать кнопку прокрутки |
+| `dropListButton` | bool | Показывать кнопку раскрытия |
+| `markIncomplete` | bool | Автопометка незаполненных |
+| `skipOnInput` | bool | Пропускать при вводе |
+| `inputHint` | string | Подсказка ввода (placeholder) |
+| `width` | int | Ширина |
+| `height` | int | Высота |
+| `horizontalStretch` | bool | Растягивание по горизонтали |
+| `verticalStretch` | bool | Растягивание по вертикали |
+| `autoMaxWidth` | bool | Автомаксимальная ширина |
+| `autoMaxHeight` | bool | Автомаксимальная высота |
+
+#### check — CheckBoxField
+
+```json
+{ "check": "ФлагАктивности", "path": "Активен", "on": ["OnChange"] }
+```
+
+| Свойство | Тип | Описание |
+|----------|-----|----------|
+| `path` | string | DataPath |
+| `titleLocation` | string | Расположение заголовка |
+
+#### label — LabelDecoration
+
+```json
+{ "label": "Подсказка", "title": "Выберите параметры", "hyperlink": true }
+```
+
+| Свойство | Тип | Описание |
+|----------|-----|----------|
+| `title` | string | Текст надписи |
+| `hyperlink` | bool | Режим гиперссылки |
+| `width` | int | Ширина |
+| `height` | int | Высота |
+| `autoMaxWidth` | bool | Автомаксимальная ширина |
+| `autoMaxHeight` | bool | Автомаксимальная высота |
+
+#### labelField — LabelField
+
+```json
+{ "labelField": "СтатусОбработки", "path": "Статус" }
+```
+
+| Свойство | Тип | Описание |
+|----------|-----|----------|
+| `path` | string | DataPath |
+| `hyperlink` | bool | Режим гиперссылки |
+
+#### table — Table
+
+```json
+{
+  "table": "Товары", "path": "Объект.Товары",
+  "columns": [
+    { "input": "Номенклатура", "path": "Объект.Товары.Номенклатура" }
+  ]
+}
+```
+
+| Свойство | Тип | Описание |
+|----------|-----|----------|
+| `path` | string | DataPath |
+| `columns` | array | Колонки (элементы input/check/labelField/picField) |
+| `representation` | string | `List`, `Tree`, `HierarchicalList` |
+| `changeRowSet` | bool | Разрешить добавление/удаление строк |
+| `changeRowOrder` | bool | Разрешить перемещение строк |
+| `height` | int | Высота в строках таблицы |
+| `header` | bool | Показывать шапку |
+| `footer` | bool | Показывать подвал |
+| `commandBarLocation` | string | `None`, `Top`, `Bottom`, `Auto` |
+| `searchStringLocation` | string | `None`, `Top`, `Bottom`, `CommandBar`, `Auto` |
+
+#### pages / page — Pages / Page
+
+```json
+{
+  "pages": "Страницы", "children": [
+    { "page": "Основное", "children": [ ... ] },
+    { "page": "Дополнительно", "children": [ ... ] }
+  ]
+}
+```
+
+Page поддерживает `group` для задания ориентации содержимого и `children` для вложенных элементов.
+
+Pages поддерживает `pagesRepresentation`: `None`, `TabsOnTop`, `TabsOnBottom`, `TabsOnLeft`, `TabsOnRight`.
+
+#### button — Button
+
+```json
+{ "button": "Загрузить", "command": "Загрузить", "defaultButton": true }
+```
+
+| Свойство | Тип | Описание |
+|----------|-----|----------|
+| `command` | string | Имя команды формы (→ `Form.Command.<name>`) |
+| `stdCommand` | string | Стандартная команда (→ `Form.StandardCommand.<name>`) |
+| `type` | string | `usual`, `hyperlink`, `commandBar` |
+| `defaultButton` | bool | Кнопка по умолчанию |
+| `picture` | string | Ссылка на картинку (`StdPicture.Name`) |
+| `representation` | string | `Auto`, `Picture`, `Text`, `PictureAndText` |
+| `locationInCommandBar` | string | `InCommandBar`, `InAdditionalSubmenu` |
+
+#### picture — PictureDecoration
+
+```json
+{ "picture": "Логотип", "src": "CommonPicture.Логотип" }
+```
+
+| Свойство | Тип | Описание |
+|----------|-----|----------|
+| `src` или `picture` (как свойство) | string | Ссылка на картинку |
+| `hyperlink` | bool | Режим гиперссылки |
+| `width` | int | Ширина |
+| `height` | int | Высота |
+
+#### picField — PictureField
+
+```json
+{ "picField": "Фото", "path": "Фотография" }
+```
+
+#### calendar — CalendarField
+
+```json
+{ "calendar": "Дата", "path": "ДатаОтчета" }
+```
+
+#### cmdBar — CommandBar
+
+```json
+{ "cmdBar": "КоманднаяПанель", "children": [ ... ] }
+```
+
+#### popup — Popup
+
+```json
+{ "popup": "Печать", "picture": "StdPicture.Print", "children": [ ... ] }
+```
+
+---
+
+## 5. Attributes — реквизиты формы
+
+```json
+"attributes": [
+  { "name": "Объект", "type": "DocumentObject.Реализация", "main": true },
+  { "name": "Итого", "type": "decimal(15,2)" },
+  { "name": "Таблица", "type": "ValueTable", "columns": [
+    { "name": "Номенклатура", "type": "CatalogRef.Номенклатура" },
+    { "name": "Количество", "type": "decimal(10,3)" }
+  ]}
+]
+```
+
+| Свойство | Тип | Описание |
+|----------|-----|----------|
+| `name` | string | Имя реквизита (обязательно) |
+| `type` | string | Тип (shorthand) |
+| `main` | bool | Основной реквизит формы |
+| `title` | string | Заголовок |
+| `savedData` | bool | Сохраняемые данные |
+| `fillChecking` | string | `Show`, `DontShow` |
+| `columns` | array | Колонки для ValueTable/ValueTree |
+
+---
+
+## 6. Parameters — параметры формы
+
+```json
+"parameters": [
+  { "name": "Ключ", "type": "DocumentRef.Реализация", "key": true },
+  { "name": "Основание", "type": "DocumentRef.Реализация" }
+]
+```
+
+| Свойство | Тип | Описание |
+|----------|-----|----------|
+| `name` | string | Имя параметра (обязательно) |
+| `type` | string | Тип (shorthand) |
+| `key` | bool | Ключевой параметр |
+
+---
+
+## 7. Commands — команды формы
+
+```json
+"commands": [
+  { "name": "Печать", "action": "ПечатьОбработка", "shortcut": "Ctrl+P" },
+  { "name": "Обновить", "action": "ОбновитьОбработка", "picture": "StdPicture.Refresh" }
+]
+```
+
+| Свойство | Тип | Описание |
+|----------|-----|----------|
+| `name` | string | Имя команды (обязательно) |
+| `action` | string | Имя процедуры-обработчика |
+| `title` | string | Заголовок |
+| `shortcut` | string | Клавиатурное сочетание |
+| `picture` | string | Ссылка на картинку |
+| `representation` | string | `Auto`, `Picture`, `Text`, `PictureAndText` |
+
+---
+
+## 8. Система типов (shorthand)
+
+### Примитивные типы
+
+| DSL | XML |
+|-----|-----|
+| `"string"` | `xs:string` (неограниченная) |
+| `"string(100)"` | `xs:string` + Length=100 |
+| `"decimal(15,2)"` | `xs:decimal` + Digits=15, FractionDigits=2, AllowedSign=Any |
+| `"decimal(10,0,nonneg)"` | `xs:decimal` + AllowedSign=Nonnegative |
+| `"boolean"` | `xs:boolean` |
+| `"date"` | `xs:dateTime` + DateFractions=Date |
+| `"dateTime"` | `xs:dateTime` + DateFractions=DateTime |
+| `"time"` | `xs:dateTime` + DateFractions=Time |
+
+### Ссылочные типы
+
+| DSL | XML |
+|-----|-----|
+| `"CatalogRef.Организации"` | `cfg:CatalogRef.Организации` |
+| `"DocumentObject.Реализация"` | `cfg:DocumentObject.Реализация` |
+| `"EnumRef.СтавкиНДС"` | `cfg:EnumRef.СтавкиНДС` |
+| `"DataProcessorObject.ЗагрузкаДанных"` | `cfg:DataProcessorObject.ЗагрузкаДанных` |
+
+### Платформенные типы
+
+| DSL | XML |
+|-----|-----|
+| `"ValueTable"` | `v8:ValueTable` |
+| `"ValueTree"` | `v8:ValueTree` |
+| `"ValueList"` | `v8:ValueListType` |
+| `"FormattedString"` | `v8ui:FormattedString` |
+| `"Picture"` | `v8ui:Picture` |
+| `"DynamicList"` | `cfg:DynamicList` |
+
+### Составные типы
+
+Разделитель `" | "`:
+
+```json
+"type": "CatalogRef.Организации | CatalogRef.ИндивидуальныеПредприниматели"
+```
+
+---
+
+## 9. Автогенерация
+
+### Companion-элементы
+
+Для каждого элемента автоматически создаются служебные вложенные элементы:
+
+| Тип элемента | Companions |
+|---|---|
+| UsualGroup | ExtendedTooltip |
+| InputField | ContextMenu, ExtendedTooltip |
+| CheckBoxField | ContextMenu, ExtendedTooltip |
+| LabelDecoration | ContextMenu, ExtendedTooltip |
+| LabelField | ContextMenu, ExtendedTooltip |
+| PictureDecoration | ContextMenu, ExtendedTooltip |
+| PictureField | ContextMenu, ExtendedTooltip |
+| CalendarField | ContextMenu, ExtendedTooltip |
+| Table | ContextMenu, AutoCommandBar, SearchStringAddition, ViewStatusAddition, SearchControlAddition |
+| Pages | ExtendedTooltip |
+| Page | ExtendedTooltip |
+| Button | ExtendedTooltip |
+
+Именование: `<name>КонтекстноеМеню`, `<name>РасширеннаяПодсказка`, `<name>КоманднаяПанель`, `<name>СтрокаПоиска`, `<name>СостояниеПросмотра`, `<name>УправлениеПоиском`.
+
+### ID
+
+Последовательная нумерация начиная с 1. `AutoCommandBar` формы всегда имеет `id="-1"`.
+
+### Namespace
+
+Все 17 namespace-деклараций добавляются автоматически (version="2.17").
+
+### Кодировка
+
+UTF-8 с BOM (как в файлах конфигурации 1С).
@@ -0,0 +1,215 @@
+# Управляемые формы (Form)
+
+Навыки группы `/form-*` позволяют анализировать, генерировать и валидировать управляемые формы 1С:Предприятия 8.3 из XML-исходников, не читая тысячи строк XML.
+
+## Навыки
+
+| Навык | Параметры | Описание |
+|-------|-----------|----------|
+| `/form-info` | `<FormPath>` | Компактная сводка: дерево элементов, реквизиты, команды, события |
+| `/form-compile` | `<JsonPath> <OutputPath>` | Генерация Form.xml из компактного JSON-определения |
+| `/form-validate` | `<FormPath>` | Валидация: уникальность ID, companions, DataPath, команды |
+| `/form-add` | `<FormPath> <JsonPath>` | Добавление элементов, реквизитов, команд в существующую форму |
+| `/form-patterns` | (без параметров) | Справочник паттернов: архетипы, конвенции именования, продвинутые приёмы |
+
+## Сценарии использования
+
+### Анализ формы перед модификацией
+
+Файлы Form.xml содержат от сотен до десятков тысяч строк XML. 80% объёма — визуальный шум (цвета, шрифты, размеры, автогенерированные подсказки). `/form-info` извлекает суть.
+
+```
+> Покажи структуру формы документа РеализацияТоваровУслуг
+```
+
+Claude найдёт Form.xml и вызовет `/form-info`. Результат — компактная сводка (40–100 строк вместо тысяч):
+
+```
+=== Form: ФормаДокумента — "Реализация товаров и услуг" (Documents.РеализацияТоваровУслуг) ===
+
+Properties: AutoTitle=false, CommandBarLocation=None
+
+Events:
+  OnCreateAtServer -> ПриСозданииНаСервере
+  OnOpen -> ПриОткрытии
+
+Elements:
+  ├─ [Group:AH] ГруппаШапка
+  │ ├─ [Input] Организация -> Объект.Организация {OnChange}
+  │ └─ [Input] Контрагент -> Объект.Контрагент {OnChange, StartChoice}
+  ├─ [Table] Товары -> Объект.Товары
+  │ ├─ [Input] Номенклатура -> Объект.Товары.Номенклатура {OnChange}
+  │ └─ [Input] Сумма -> Объект.Товары.Сумма [ro]
+  └─ [Pages] Страницы
+     ├─ [Page] Основное (5 items)
+     └─ [Page] Печать (2 items)
+
+Attributes:
+  *Объект: DocumentObject.РеализацияТоваровУслуг (main)
+  Валюта: CatalogRef.Валюты
+  ...
+
+Commands:
+  Печать -> ПечатьДокумента [Ctrl+P]
+```
+
+### Добавление элементов в существующую форму
+
+`/form-add` добавляет элементы, реквизиты и команды в существующий Form.xml. Автоматически назначает ID, генерирует companion-элементы и обработчики событий.
+
+```
+> Добавь поле "Склад" в шапку формы после "Контрагент"
+```
+
+Claude вызовет `/form-info` для анализа структуры, создаст JSON и вызовет `/form-add`:
+
+```json
+{
+  "into": "ГруппаШапка",
+  "after": "Контрагент",
+  "elements": [
+    { "input": "Склад", "path": "Объект.Склад", "on": ["OnChange"] }
+  ],
+  "attributes": [
+    { "name": "Склад", "type": "CatalogRef.Склады" }
+  ]
+}
+```
+
+Позиционирование: `into` указывает группу-контейнер, `after` — элемент, после которого вставлять. Оба опциональны (по умолчанию — в конец корневого ChildItems).
+
+Один вызов может содержать элементы, реквизиты и команды одновременно. Группы поддерживают `children` для вложенных элементов.
+
+### Поиск обработчиков и привязок
+
+Из сводки видно, какие события подключены к каким элементам:
+
+```
+> Какие обработчики срабатывают при изменении контрагента?
+```
+
+Claude вызовет `/form-info` и найдёт: `[Input] Контрагент -> Объект.Контрагент {OnChange, StartChoice}` — далее откроет модуль формы и найдёт процедуры по именам событий.
+
+### Точечное погружение в детали
+
+Сводка — это карта. Для деталей по конкретному элементу достаточно grep по имени из сводки:
+
+```
+> Покажи все свойства элемента ДоговорКонтрагента
+```
+
+Claude сделает grep по Form.xml и найдёт полный XML-блок с ChoiceParameters, ChoiceFoldersAndItems, стилями и прочими свойствами.
+
+## Чтение вывода
+
+### Дерево элементов
+
+| Обозначение | Элемент |
+|---|---|
+| `[Group:V]` `[Group:H]` `[Group:AH]` `[Group:AV]` | Группа (Vertical / Horizontal / AlwaysHorizontal / AlwaysVertical) |
+| `[Input]` | Поле ввода |
+| `[Check]` | Флажок |
+| `[Label]` | Декоративная надпись |
+| `[LabelField]` | Поле надписи (привязанное к данным) |
+| `[Table]` | Таблица |
+| `[Pages]` / `[Page]` | Вкладки (страницы показывают количество элементов) |
+| `[Button]` | Кнопка |
+| `[CmdBar]` | Командная панель |
+| `[Popup]` | Выпадающее меню |
+| `[Picture]` | Декоративная картинка |
+| `[PicField]` | Поле картинки |
+| `[Calendar]` | Календарь |
+
+### Флаги
+
+Показываются только при отклонении от умолчания:
+- `[visible:false]` — элемент скрыт (Visible=false)
+- `[enabled:false]` — элемент недоступен (Enabled=false)
+- `[ro]` — только чтение (ReadOnly=true)
+- `,collapse` — сворачиваемая группа (Behavior=Collapsible)
+
+### Привязки и события
+
+- `-> Объект.Поле` — DataPath (привязка к данным)
+- `-> Имя [cmd]` — привязка к команде формы
+- `-> Close [std]` — привязка к стандартной команде
+- `{OnChange, StartChoice}` — имена подключённых событий
+- `[title:Текст]` — заголовок, если отличается от имени элемента
+
+### Реквизиты
+
+- `*Объект: DocumentObject.Реализация (main)` — основной реквизит формы
+- `Таблица: ValueTable [Кол1: тип, Кол2: тип]` — таблица значений с колонками
+- `Список: DynamicList -> Catalog.Пользователи` — динамический список с основной таблицей
+
+## Генерация формы с нуля
+
+`/form-compile` принимает компактное JSON-определение (20–50 строк) и генерирует полный Form.xml (100–500+ строк) с namespace-декларациями, companion-элементами и последовательными ID.
+
+```
+> Создай форму загрузки данных с полями Организация, Контрагент, таблицей Товары и кнопкой Загрузить
+```
+
+Claude создаст JSON-определение и вызовет `/form-compile`. Пример JSON:
+
+```json
+{
+  "properties": { "autoTitle": false },
+  "events": { "OnCreateAtServer": "ПриСозданииНаСервере" },
+  "elements": [
+    { "group": "horizontal", "name": "Шапка", "children": [
+      { "input": "Организация", "path": "Объект.Организация", "on": ["OnChange"] },
+      { "input": "Контрагент", "path": "Объект.Контрагент" }
+    ]},
+    { "table": "Товары", "path": "Объект.Товары", "columns": [
+      { "input": "Номенклатура", "path": "Объект.Товары.Номенклатура" },
+      { "input": "Сумма", "path": "Объект.Товары.Сумма", "readOnly": true }
+    ]},
+    { "button": "Загрузить", "command": "Загрузить" }
+  ],
+  "attributes": [
+    { "name": "Объект", "type": "DataProcessorObject.ЗагрузкаДанных", "main": true }
+  ],
+  "commands": [
+    { "name": "Загрузить", "action": "ЗагрузитьОбработка" }
+  ]
+}
+```
+
+### Верификация результата
+
+После компиляции используйте `/form-validate` и `/form-info` для проверки:
+
+```
+> /form-validate src/МояОбработка/Forms/Форма/Ext/Form.xml
+> /form-info src/МояОбработка/Forms/Форма/Ext/Form.xml
+```
+
+`/form-validate` проверит структурную корректность (ID, companions, ссылки), `/form-info` покажет результат в виде компактной сводки.
+
+## Примеры слеш-команд
+
+```
+> /form-info upload/acc_8.3.24/Documents/РеализацияТоваровУслуг/Forms/ФормаДокумента/Ext/Form.xml
+> /form-info src/МояОбработка/Forms/Форма/Ext/Form.xml
+> /form-compile src/form.json src/МояОбработка/Forms/Форма/Ext/Form.xml
+> /form-add src/МояОбработка/Forms/Форма/Ext/Form.xml src/additions.json
+> /form-validate src/МояОбработка/Forms/Форма/Ext/Form.xml
+```
+
+## Связь с EPF-навыками
+
+Навыки `/form-*` работают с формами из любых источников — конфигурации и внешних обработок. При работе с обработками:
+
+1. `/epf-add-form` — создать форму (каркас)
+2. `/form-compile` — сгенерировать Form.xml из JSON-определения
+3. `/form-add` — добавить элементы/реквизиты/команды в существующую форму
+4. `/form-validate` — проверить корректность
+5. `/form-info` — проанализировать результат
+6. `/epf-build` — собрать EPF
+
+## Спецификации
+
+- [Управляемая форма](1c-form-spec.md) — Form.xml, элементы, команды, реквизиты, система типов
+- [Form DSL](form-dsl-spec.md) — JSON-формат описания формы для `/form-compile` и `/form-add`
+- [Паттерны компоновки](form-patterns.md) — типовые архетипы форм, конвенции именования, примеры DSL
@@ -0,0 +1,337 @@
+# Паттерны компоновки управляемых форм
+
+Рекомендации по дизайну форм, извлечённые из типовых конфигураций 1С. Используйте при создании форм через `/form-compile`, когда требования пользователя не детализируют расположение элементов.
+
+## Архетипы форм
+
+### Форма документа
+
+```
+Шапка (horizontal, 2 колонки)
+├─ Левая (vertical): НомерДата (H: Номер + Дата "от"), Контрагент, Договор
+├─ Правая (vertical): Организация, Подразделение, ЦеныИВалюта (надпись-ссылка)
+Страницы (pages)
+├─ Товары: таблица Объект.Товары
+├─ Услуги: таблица Объект.Услуги (опционально)
+└─ Дополнительно: прочие реквизиты
+Подвал (vertical)
+├─ Итоги (horizontal): Всего, НДС, Скидка
+└─ КомментарийОтветственный (horizontal): Комментарий + Ответственный
+```
+
+**Типичные события:** OnCreateAtServer, OnReadAtServer, OnOpen, BeforeWriteAtServer, AfterWriteAtServer, AfterWrite, NotificationProcessing
+
+**Свойства:** autoTitle=false, командная панель со стандартными + глобальными командами
+
+### Форма обработки (DataProcessor)
+
+```
+Параметры (vertical)
+├─ Группа полей ввода (Организация, Период, режимы работы)
+├─ Информационные надписи (label, hyperlink)
+Рабочая область
+├─ Таблица данных или Pages с вкладками
+Кнопки действий
+├─ Выполнить / Применить (defaultButton)
+├─ Закрыть (stdCommand: Close)
+```
+
+**Типичные события:** OnCreateAtServer, OnOpen, NotificationProcessing
+
+**Свойства:** windowOpeningMode=LockOwnerWindow (если диалог), autoTitle=false
+
+### Форма списка
+
+```
+Отборы (group: alwaysHorizontal)
+├─ ГруппаОтбор[Поле] (H): Флажок + Поле ввода (для каждого фильтра)
+Список (table, DynamicList)
+├─ Колонки: labelField (не input — данные только для чтения)
+```
+
+**Типичные события:** OnCreateAtServer, OnOpen, NotificationProcessing, OnLoadDataFromSettingsAtServer
+
+**Свойства:** autoSaveDataInSettings=Use (запомнить отборы)
+
+**Фильтры:** пара реквизитов на каждый фильтр — `Отбор[Поле]` (значение) + `Отбор[Поле]Использование` (boolean, флажок вкл/выкл)
+
+### Форма элемента справочника
+
+**Простая:**
+```
+ГруппаРеквизитов (horizontal)
+├─ Наименование -> Объект.Description
+└─ Код -> Объект.Code (если нужен)
+```
+
+**Сложная:**
+```
+Главное (vertical)
+├─ Наименование -> Объект.Description
+├─ Параметры (horizontal, 2 колонки)
+│  ├─ Левая: основные реквизиты
+│  └─ Правая: дополнительные реквизиты
+└─ КонтактныеДанные / Дополнительно (vertical)
+```
+
+**Типичные события:** OnCreateAtServer, OnReadAtServer, BeforeWriteAtServer, NotificationProcessing
+
+### Мастер (Wizard)
+
+```
+Страницы (pages, OnCurrentPageChange)
+├─ Шаг1: описание + параметры
+├─ Шаг2: основная работа
+└─ Шаг3: результат
+Кнопки (horizontal)
+├─ Назад (command), Далее (command, defaultButton), Выполнить (command)
+└─ Закрыть (stdCommand: Close)
+```
+
+**Свойства:** windowOpeningMode=LockOwnerWindow
+
+## Конвенции именования
+
+### Группы
+
+| Назначение | Имя | Тип |
+|-----------|-----|-----|
+| Шапка | `ГруппаШапка` | horizontal |
+| Левая колонка | `ГруппаШапкаЛевая` | vertical |
+| Правая колонка | `ГруппаШапкаПравая` | vertical |
+| Номер+Дата | `ГруппаНомерДата` | horizontal |
+| Подвал | `ГруппаПодвал` | vertical |
+| Итоги | `ГруппаИтоги` | horizontal |
+| Кнопки | `ГруппаКнопок` | horizontal |
+| Страницы | `ГруппаСтраницы` / `Страницы` | pages |
+| Предупреждение | `ГруппаПредупреждение` | horizontal, visible:false |
+| Доп. секция | `ГруппаДополнительно` / `ГруппаПрочее` | vertical, collapse |
+
+### Элементы
+
+| Назначение | Имя | Суффикс |
+|-----------|-----|---------|
+| Поле в таблице | `[Таблица][Поле]` | — |
+| Итог | `Итоги[Поле]` | — |
+| Надпись-ссылка | `[Поле]Надпись` | — |
+| Фильтр | `Отбор[Поле]` | — |
+| Флажок фильтра | `Отбор[Поле]Использование` | — |
+| Кнопка команды | `[Команда]Кнопка` | — |
+| Баннер-картинка | `[Баннер]Картинка` | — |
+| Баннер-надпись | `[Баннер]Надпись` | — |
+| Подменю | `Подменю[Действие]` | — |
+
+### Обработчики событий
+
+Имя обработчика = имя элемента + суффикс события на русском:
+
+| Событие | Суффикс | Пример |
+|---------|---------|--------|
+| OnChange | ПриИзменении | `ОрганизацияПриИзменении` |
+| StartChoice | НачалоВыбора | `КонтрагентНачалоВыбора` |
+| Click | Нажатие | `ЦеныИВалютаНажатие` |
+| OnEditEnd | ПриОкончанииРедактирования | `ТоварыПриОкончанииРедактирования` |
+| OnStartEdit | ПриНачалеРедактирования | `ТоварыПриНачалеРедактирования` |
+
+Обработчики формы — стандартные имена: `ПриСозданииНаСервере`, `ПриОткрытии`, `ПередЗакрытием`, `ОбработкаОповещения`.
+
+## Принципы компоновки
+
+1. **Порядок чтения.** Сверху вниз, слева направо. Самое важное — вверху.
+2. **Двухколоночная шапка.** Основные реквизиты слева (контрагент, склад), организационные справа (организация, подразделение).
+3. **Кнопки действий внизу.** Главная кнопка — `defaultButton: true`. Закрыть — всегда последняя.
+4. **Таблицы — основная область.** Табличные части занимают большую часть формы, обычно на Pages.
+5. **Итоги рядом с таблицей.** В подвале, горизонтальная группа, все поля readOnly.
+6. **Фильтры — отдельная зона.** Над списком, горизонтальная группа (alwaysHorizontal), пара "флажок + поле" на каждый фильтр.
+7. **Скрытые элементы для состояний.** Баннеры, предупреждения — `visible: false` по умолчанию, показываются программно.
+8. **Надписи-ссылки для диалогов.** `labelField` с `hyperlink: true` и событием Click — для открытия подформ (ЦеныИВалюта, УчётнаяПолитика).
+
+## Продвинутые паттерны (ERP)
+
+Извлечены из конфигурации «Управление предприятием» (ERP 8.3.24). Применяйте в сложных формах.
+
+### Сворачиваемые группы (Collapsible)
+
+Для необязательных секций — «Подписи», «Дополнительно», «Прочее». Сворачиваются по умолчанию, экономят место.
+
+```
+ГруппаПодписи (vertical, collapse, collapsed)
+├─ Руководитель -> Объект.Руководитель
+└─ ГлавныйБухгалтер -> Объект.ГлавныйБухгалтер
+```
+
+DSL:
+```json
+{ "group": "vertical", "name": "ГруппаПодписи", "title": "Подписи",
+  "behavior": "Collapsible", "collapsed": true, "children": [
+    { "input": "Руководитель", "path": "Объект.Руководитель" },
+    { "input": "ГлавныйБухгалтер", "path": "Объект.ГлавныйБухгалтер" }
+]}
+```
+
+### Баннер-предупреждение (Status Banner)
+
+Группа «картинка + надпись» без заголовка, скрыта по умолчанию. Показывается программно при определённых условиях (просрочка, блокировка, информация).
+
+```
+ГруппаПредупреждение (horizontal, showTitle:false, visible:false)
+├─ [Picture] ПредупреждениеКартинка -> StdPicture.Information
+└─ [Label] ПредупреждениеНадпись (maxWidth:76, textColor:style:ПоясняющийТекст)
+```
+
+DSL:
+```json
+{ "group": "horizontal", "name": "ГруппаПредупреждение", "showTitle": false,
+  "visible": false, "children": [
+    { "picture": "ПредупреждениеКартинка" },
+    { "label": "ПредупреждениеНадпись", "title": "Текст предупреждения",
+      "maxWidth": 76, "autoMaxWidth": false }
+]}
+```
+
+### Выпадающее меню в командной панели (Popup)
+
+Группировка связанных команд (печать, отправка, выгрузка) в одну кнопку-меню с иконкой.
+
+```
+[CmdBar] КоманднаяПанель
+├─ [Popup] ПодменюПечать (picture: StdPicture.Print, representation: Picture)
+│  ├─ [Button] ПечатьНакладная -> Печать [cmd]
+│  └─ [Button] ПечатьСчёт -> ПечатьСчёт [cmd]
+└─ [Popup] ПодменюОтправить (picture: StdPicture.SendByEmail)
+   └─ [Button] ОтправитьПоПочте -> Отправить [cmd]
+```
+
+DSL:
+```json
+{ "cmdBar": "КоманднаяПанель", "children": [
+    { "popup": "ПодменюПечать", "title": "Печать",
+      "picture": "StdPicture.Print", "representation": "Picture", "children": [
+        { "button": "ПечатьНакладная", "command": "Печать" },
+        { "button": "ПечатьСчёт", "command": "ПечатьСчёт" }
+    ]},
+    { "popup": "ПодменюОтправить", "title": "Отправить",
+      "picture": "StdPicture.SendByEmail", "representation": "Picture", "children": [
+        { "button": "ОтправитьПоПочте", "command": "Отправить" }
+    ]}
+]}
+```
+
+### Форма без стандартной командной панели
+
+Для модальных диалогов и мастеров — отключение стандартной командной панели, полностью ручное управление кнопками.
+
+```
+properties: commandBarLocation=None, windowOpeningMode=LockWholeInterface
+Содержимое (vertical)
+├─ ... рабочая область ...
+ГруппаКнопок (horizontal)
+├─ Назад (command), Далее (command, defaultButton)
+└─ Закрыть (stdCommand: Close)
+```
+
+DSL:
+```json
+{
+  "properties": { "commandBarLocation": "None", "windowOpeningMode": "LockWholeInterface" },
+  "elements": [
+    { "group": "vertical", "name": "Содержимое", "children": [ "..." ] },
+    { "group": "horizontal", "name": "ГруппаКнопок", "children": [
+      { "button": "Назад", "command": "Назад" },
+      { "button": "Далее", "command": "Далее", "defaultButton": true },
+      { "button": "Закрыть", "stdCommand": "Close" }
+    ]}
+  ]
+}
+```
+
+### Надпись-гиперссылка для открытия подформ
+
+`labelField` с `hyperlink: true` и событием Click — вместо кнопки. Типичный приём для «ЦеныИВалюта», «УчётнаяПолитика» и подобных.
+
+```
+[LabelField] ЦеныИВалютаНадпись -> ЦеныИВалюта (hyperlink) {Click}
+```
+
+DSL:
+```json
+{ "labelField": "ЦеныИВалютаНадпись", "path": "ЦеныИВалюта",
+  "hyperlink": true, "on": ["Click"] }
+```
+
+## Примеры DSL
+
+### Типичная форма обработки
+
+```json
+{
+  "title": "Загрузка данных из CSV",
+  "properties": { "autoTitle": false, "windowOpeningMode": "LockOwnerWindow" },
+  "events": { "OnCreateAtServer": "ПриСозданииНаСервере" },
+  "elements": [
+    { "group": "vertical", "name": "ГруппаПараметры", "children": [
+      { "input": "ФайлЗагрузки", "path": "ФайлЗагрузки", "title": "Файл", "clearButton": true, "horizontalStretch": true, "on": ["StartChoice"] },
+      { "input": "Кодировка", "path": "Кодировка", "title": "Кодировка" },
+      { "input": "Разделитель", "path": "Разделитель", "title": "Разделитель колонок" }
+    ]},
+    { "table": "Данные", "path": "Объект.Данные", "on": ["OnStartEdit"], "columns": [
+      { "input": "ДанныеНомерСтроки", "path": "Объект.Данные.LineNumber", "readOnly": true, "title": "№" },
+      { "input": "ДанныеНаименование", "path": "Объект.Данные.Наименование" },
+      { "input": "ДанныеКоличество", "path": "Объект.Данные.Количество", "on": ["OnChange"] },
+      { "input": "ДанныеСумма", "path": "Объект.Данные.Сумма", "readOnly": true }
+    ]},
+    { "group": "horizontal", "name": "ГруппаКнопок", "children": [
+      { "button": "Загрузить", "command": "Загрузить", "title": "Загрузить из файла", "defaultButton": true },
+      { "button": "Очистить", "command": "Очистить", "title": "Очистить таблицу" },
+      { "button": "Закрыть", "stdCommand": "Close" }
+    ]}
+  ],
+  "attributes": [
+    { "name": "Объект", "type": "ExternalDataProcessorObject.ЗагрузкаИзCSV", "main": true },
+    { "name": "ФайлЗагрузки", "type": "string" },
+    { "name": "Кодировка", "type": "string(20)" },
+    { "name": "Разделитель", "type": "string(5)" }
+  ],
+  "commands": [
+    { "name": "Загрузить", "action": "ЗагрузитьОбработка" },
+    { "name": "Очистить", "action": "ОчиститьОбработка" }
+  ]
+}
+```
+
+### Типичная форма со списком и фильтрами
+
+```json
+{
+  "properties": { "autoTitle": false, "autoSaveDataInSettings": "Use" },
+  "events": {
+    "OnCreateAtServer": "ПриСозданииНаСервере",
+    "NotificationProcessing": "ОбработкаОповещения"
+  },
+  "elements": [
+    { "group": "alwaysHorizontal", "name": "ГруппаОтборы", "children": [
+      { "group": "horizontal", "name": "ГруппаОтборОрганизация", "children": [
+        { "check": "ОтборОрганизацияИспользование", "path": "ОтборОрганизацияИспользование", "titleLocation": "none", "on": ["OnChange"] },
+        { "input": "ОтборОрганизация", "path": "ОтборОрганизация", "title": "Организация", "on": ["OnChange"] }
+      ]},
+      { "group": "horizontal", "name": "ГруппаОтборКонтрагент", "children": [
+        { "check": "ОтборКонтрагентИспользование", "path": "ОтборКонтрагентИспользование", "titleLocation": "none", "on": ["OnChange"] },
+        { "input": "ОтборКонтрагент", "path": "ОтборКонтрагент", "title": "Контрагент", "on": ["OnChange"] }
+      ]}
+    ]},
+    { "table": "Список", "path": "Список", "on": ["Selection", "OnActivateRow"], "columns": [
+      { "labelField": "СписокДата", "path": "Список.Дата", "title": "Дата" },
+      { "labelField": "СписокНомер", "path": "Список.Номер", "title": "Номер" },
+      { "labelField": "СписокКонтрагент", "path": "Список.Контрагент" },
+      { "labelField": "СписокСумма", "path": "Список.Сумма" }
+    ]}
+  ],
+  "attributes": [
+    { "name": "Список", "type": "DynamicList", "mainTable": "Document.РеализацияТоваров" },
+    { "name": "ОтборОрганизация", "type": "CatalogRef.Организации" },
+    { "name": "ОтборОрганизацияИспользование", "type": "boolean" },
+    { "name": "ОтборКонтрагент", "type": "CatalogRef.Контрагенты" },
+    { "name": "ОтборКонтрагентИспользование", "type": "boolean" }
+  ]
+}
+```