Initial commit

.template/development/modules/vscode-workspace.md

@@ -0,0 +1,34 @@
+# Модуль: Рабочая область VS Code
+
+**Ответственность**: синхронизирует воспроизводимую среду автора и предоставляет три понятные задачи.  
+**Расположение**: `.vscode/`, `.template/development/tools/`
+
+## Публичный интерфейс
+
+| Файл или задача | Назначение |
+|-----------------|------------|
+| `extensions.json` | Десять согласованных recommendations |
+| `settings.json` | Auto Save, spellcheck, TODO, скрытие служебных каталогов |
+| `Scientia: собрать PDF` | Компиляция текущего `main.typ` |
+| `Scientia: выбрать тип документа` | Backup и установка public example |
+| `Scientia: собрать учебный пример` | Компиляция выбранного исходника из `docs/examples/` |
+
+## Инварианты
+
+- `.vscode/` включён в Git, но скрыт в Explorer.
+- `docs/` никогда не скрыт.
+- Typewriter navigator содержит только `main.typ`.
+- Автосохранение не создаёт commit и не выполняет push.
+- Tasks не хранят приватные значения в tracked settings.
+- Одна build task собирает и public-, и private-режим согласно `main.typ`.
+- Внутренние VSIX не входят в репозиторий.
+
+## Намеренно НЕ обрабатывает
+
+- Установку VS Code, Git и Typst.
+- Авторизацию на Git-сервере.
+- Публикацию внутренних VSIX.
+
+## Заметки для агента
+
+> Не добавляйте отдельную build task для каждого режима: пользователь меняет `document-mode` в `main.typ`. Новая задача должна либо быть частой, либо существенно снижать риск потери данных.