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

Модуль: Рабочая область 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. Новая задача должна либо быть частой, либо существенно снижать риск потери данных.