--- field-test: new-laptop-2026-05-06 host: tbd (нового ноута имя — спросить) os: Windows 11 director: existing Windows machine (vitya@.meeting-room) goal: пройти full L0a + L0b на голой Win11 машине, фиксируя каждую команду; превратить итог в bootstrap.ps1 --- # L0 install log — Win11 field-test 2026-05-06 Каждый шаг: что задумано → команда → фактический результат → пометки (что сработало не так / что неочевидно). Пометка `⏳` — запланировано, ещё не выполнено. Пометка `✅` — выполнено, результат записан. Пометка `❌` — выполнено, но упало; gap для L0a-скрипта. Пометка `🔄` — выполнено, но потребовало ручной правки. ## L0a — System bootstrap ### Шаг 1 — Verify winget ✅ Win11 поставляется с winget из коробки. Проверка наличия и обновление каталогов. ```powershell winget --version winget source update ``` **Ожидание:** версия `v1.x` или новее, source update без ошибок. **Факт (2026-05-06):** - Версия: `v1.28.240` - `source update` — три источника: `msstore` ✅, `winget` ✅, `winget-font` ✅ (третий нестандартный, видимо добавлен ранее — некритично). - Сессия запущена в `cmd.exe`, не в PowerShell. **Gap для bootstrap.ps1**: на чистой Win11 стартовая консоль у юзера часто = `cmd`. Скрипт надо либо запускать строго через `iwr … | iex` уже из PS, либо первой строкой проверять `$PSVersionTable` и вежливо просить перейти в PS. --- ### Шаг 2 — Установить core dev tools (git, gh, PS7) ✅ ```powershell winget install --id Git.Git -e --source winget --accept-package-agreements --accept-source-agreements winget install --id GitHub.cli -e --source winget --accept-package-agreements --accept-source-agreements winget install --id Microsoft.PowerShell -e --source winget --accept-package-agreements --accept-source-agreements ``` После установки — **открыть новый PowerShell 7**, чтобы PATH перечитался. Дальше работаем уже в PS7 (`pwsh`). **Ожидание:** `git --version`, `gh --version`, `pwsh --version` отвечают. **Факт (2026-05-06):** - Git 2.54.0 ✅ (Git Credential Manager входит в комплект) - GitHub CLI 2.92.0 ✅ — **но для приватного gitea (`git.kzntsv.site`) не работает.** Оставлен на случай GitHub.com mirror'ов; настоящий нативный CLI для gitea — `tea` (см. опциональный шаг). Альтернатива — простой HTTPS + Git Credential Manager. - PowerShell 7.6.1.0 ✅ - **Gap для bootstrap.ps1**: `gh` для приватного gitea бесполезен. На фабриках с private gitea вместо `GitHub.cli` ставить `gitea.tea` (или сделать оба опциональными). Решение принимать на основе `home.toml#git_host`. --- ### Шаг 3 — Установить mise 🔄 ```powershell winget install --id jdx.mise -e --source winget --accept-package-agreements --accept-source-agreements ``` Активировать в профиле PS7 (`$PROFILE` у PS5 и PS7 разные!): ```powershell if (-not (Test-Path $PROFILE)) { New-Item -ItemType File -Path $PROFILE -Force } Add-Content -Path $PROFILE -Value 'mise activate pwsh | Out-String | Invoke-Expression' # ⚠️ ОБЯЗАТЕЛЬНО закрыть pwsh и открыть заново — winget правит PATH, эффект только в новой сессии . $PROFILE mise doctor ``` **Ожидание:** `mise --version` отвечает, `mise doctor` без warning'ов. **Факт (2026-05-06):** - `winget install jdx.mise` нашёл в каталоге, поставил `2026.5.1 windows-x64`. Зависимость `Microsoft.VCRedist.2015+.x64` подтянулась автоматически. - Winget предупредил: **"Переменная среды пути изменена; перезапустите оболочку"**, но также создал app-execution-alias `mise` (виден глобально). Поэтому `mise --version` сразу сработал. - `. $PROFILE` (без перезапуска шелла) → `mise: The term 'mise' is not recognized` — alias работает только в свежей сессии. - **Решение:** закрыть pwsh, открыть заново — alias подхватывается нормально. - После рестарта `mise doctor` → ✅ "No problems found"; `MISE_SHELL=pwsh`, shims_on_path=no (нормально для PS — активация env-style, не shims). - На ноуте обнаружен предустановленный VS Code (в PATH `~\AppData\Local\Programs\Microsoft VS Code\bin`). Конфиг дефолтного терминала на pwsh — отдельный опциональный шаг. - **Gap для bootstrap.ps1**: после `winget install jdx.mise` обязательно перезапустить себя (re-exec) или сообщить пользователю и завершиться. Не пытаться сделать `. $PROFILE` в той же сессии. --- ### Шаг 4 — Установить runtime'ы через mise ✅ ```powershell mise use --global node@lts python@3.12 go@latest node --version python --version go version mise list ``` **Ожидание:** все три версии печатаются. **Факт (2026-05-06):** - `node@24.15.0` (LTS, npm 11.12.1), `python@3.12.13`, `go@1.26.2` — все три встали из mise mirror'ов. - Конфиг записан в `C:\Users\vitya\.config\mise\config.toml`. - ⚠️ Warning во время установки: `mise WARN gpg not found, skipping verification` — sha256 mise проверил, gpg-подпись — нет. На Win11 gpg не предустановлен. - **Gap для bootstrap.ps1**: либо ставить gpg как зависимость (`winget install GnuPG.Gpg4win` или `GnuPG.GnuPG`), либо явно сообщать "verification skipped — install gpg if you need it" и идти дальше. Не блокер, но решение надо принять. --- ### Шаг 5 — Configure git identity ✅ ```powershell git config --global user.name "<имя>" git config --global user.email "<почта>" git config --global init.defaultBranch master git config --global pull.ff only git config --global core.autocrlf input ``` **Ожидание:** настройки видны через `git config --global --list`. **Факт (2026-05-06):** - `user.name="Victor Kuznetsov"`, `user.email="vitya.kuznetsov@gmail.com"`, `init.defaultBranch=master`, `pull.ff=only`, `core.autocrlf=input` ✅ - Решено: gitea credentials через **PAT + Git Credential Manager (HTTPS)**, не SSH. Причина — Win11 ssh-agent капризный (службу `ssh-agent` надо включать вручную), а GCM встал с Git 2.54 из коробки. - PAT создаётся пользователем в браузере на `git.kzntsv.site/user/settings/applications` (scopes: `read:repository`, `write:repository`, `read:user`). Будет запрошен GCM'ом при первом `git push`. - **Gap для bootstrap.ps1**: PAT-creation шаг — не автоматизируется (требует браузера и MFA). Скрипт должен напечатать прямой URL и дождаться "press enter when token created", потом сохранить через `git credential approve` или просто положиться на GCM-prompt. --- ### Шаг 6 — Установить AI-клиент Claude Code 🔄 **Что было предложено (npm):** ```powershell npm install -g @anthropic-ai/claude-code claude --version claude doctor ``` **Что выяснилось:** Claude Code, поставленный через npm-global под mise, попадает в `AppData\Local\mise\installs\node\24.15.0\node_modules\...`. `claude doctor` блокирует auto-updates с warning'ом "Insufficient permissions for auto-updates" (эвристика "не sudo — не можем"). Юзер получит протухшего клиента через пару недель. **Решение** — переключиться на native installer: ```powershell claude install # native install в ~\.local\bin\claude.exe # native installer НЕ добавляет ~\.local\bin в PATH сам — нужен ручной фикс: $nativePath = "$env:USERPROFILE\.local\bin" $userPath = [Environment]::GetEnvironmentVariable("Path", "User") if ($userPath -notlike "*$nativePath*") { [Environment]::SetEnvironmentVariable("Path", "$nativePath;$userPath", "User") } $env:Path = "$nativePath;$env:Path" npm uninstall -g @anthropic-ai/claude-code # убрать зомби-копию claude --version where.exe claude # должно быть одно вхождение claude doctor # должно быть зелёное Update permissions ``` **Факт (2026-05-06):** - npm install ✅ → Claude Code 2.1.131 - `claude doctor` после npm-install: ⚠ "Insufficient permissions for auto-updates", "Failed to fetch versions" - `claude install` ✅ → native в `C:\Users\vitya\.local\bin\claude.exe` - ⚠ Native installer НЕ положил `~\.local\bin` в PATH автоматически. Anthropic просит сделать это руками через GUI. - Ручной фикс PATH через `[Environment]::SetEnvironmentVariable` — работает. - `npm uninstall -g @anthropic-ai/claude-code` — убрал зомби. - Финал: `where.exe claude` → одно вхождение `C:\Users\vitya\.local\bin\claude.exe`. `claude doctor` зелёный: `Currently running: native (2.1.131)`, `Auto-updates: enabled`, `Stable version: 2.1.119`, `Latest version: 2.1.131`. ✅ **Gaps для bootstrap.ps1 (критично):** - ❌ **НЕ ставить через npm-global под mise.** Auto-updates ломаются. - ✅ **Канонический путь** — официальный native installer от Anthropic: `irm https://claude.ai/install.ps1 | iex` (скрипт сам кладёт в `~\.local\bin` И, по идее, добавляет в PATH; в отличие от `claude install` из уже-стоящего клиента). - ✅ Если по какой-то причине идём через `claude install` — после него ОБЯЗАТЕЛЬНО править PATH из скрипта (см. блок выше). - ✅ Не забыть `npm uninstall -g @anthropic-ai/claude-code` если npm-копия была. --- ### Шаг 7 — Опциональные тулы (по диалогу) ⏳ С интерактивным выбором: | Тула | winget id | Зачем | |---|---|---| | VS Code | `Microsoft.VisualStudioCode` | редактор | | Cursor | `Anysphere.Cursor` | альтернативный AI-IDE | | Ollama | `Ollama.Ollama` | локальные LLM (для interns-mcp endpoint local) | | Docker Desktop | `Docker.DockerDesktop` | контейнеры (нужен для части проектов) | | Windows Terminal | `Microsoft.WindowsTerminal` | многотабовый терминал | **Факт:** ⏳ --- ## L0b — Factory bootstrap ### Шаг 8 — Выбрать projects_dir ✅ Дефолт: `C:\Users\\projects`. ```powershell $PROJECTS_DIR = "C:\Users\vitya\projects" New-Item -ItemType Directory -Force -Path $PROJECTS_DIR | Out-Null Set-Location $PROJECTS_DIR ``` **Факт (2026-05-06):** - `$PROJECTS_DIR = C:\Users\vitya\projects` ✅ (создан, cwd переключён). - Параллельно: создан пустой репо `git.kzntsv.site/OpeItcLoc03/factory` (private, без README — чтобы `git push` не упёрся в merge). - Локальный mapping: gitea-имя `factory` → локальная папка `.factory/`. --- ### Шаг 9 — Склонировать .factory ✅ **Pre-step (на директорской машине):** создать репо `git.kzntsv.site/OpeItcLoc03/factory` (private, без README), `git init -b master` в локальной `.factory/`, commit, `git push -u origin master`. Сделано 2026-05-06, root-commit `7e0c158`, 3 файла + папка L0. **На новом ноуте:** ```powershell git clone https://git.kzntsv.site/OpeItcLoc03/factory.git "$PROJECTS_DIR\.factory" ``` **Mapping**: gitea-имя репо = `factory` (без точки — gitea не любит точку в начале); локальная папка после клона = `.factory/` (с точкой, чтобы быть сиблингом `.common`/`.wiki`/etc). Это закреплённая конвенция для всех мета-репо. **Факт (2026-05-06):** - `git clone` прошёл без интерактивного запроса PAT — Windows Credential Vault уже знал `git.kzntsv.site` (либо через OAuth, либо PAT был сохранён GCM при предыдущей сессии). Удобно для этого ноута, но **gap** для свежей машины нового сотрудника. - `git log --oneline` → `7e0c158 Initial commit: factory skeleton + L0 install log (field-test 2026-05-06)` ✅ - `git remote -v` → origin корректный. - 3 файла + L0/ ✅ **Gap для bootstrap.ps1:** на голой машине нового сотрудника GCM ещё не знает gitea. Скрипт должен явно открыть `https://git.kzntsv.site/user/settings/applications` в браузере, попросить пользователя сгенерить PAT (scopes: `read:repository` + `write:repository` + `read:user`) и нажать Enter. Дальше первый `git clone` всплывёт с GCM-prompt — пользователь введёт username + PAT, GCM сохранит в Credential Vault. Все последующие clone/push молчаливые. --- ### Шаг 10 — Записать home.toml 🔄 ⚠ TOML strings с Windows-путями (backslashes) — должны быть **literal strings** (одинарные кавычки), иначе backslash интерпретируется как escape. **Первая попытка** — через here-string `@" ... "@` — провалилась: после copy-paste закрывающий `"@` оказался с leading whitespace, PowerShell не закрыл here-string и завис в `>>` continuation prompt. **Рабочая версия — без here-string, через array + Set-Content** (устойчиво к copy-paste): ```powershell $cfg = "$env:USERPROFILE\.config\factory" New-Item -ItemType Directory -Force -Path $cfg | Out-Null $now = Get-Date -Format 'yyyy-MM-ddTHH:mm:ssZ' $lines = @( "# factory home — single source of machine-level state", "# auto-generated by L0b bootstrap; safe to edit by hand", "", "projects_dir = '$PROJECTS_DIR'", "client = 'claude-code'", "installed_at = '$now'" ) $lines | Set-Content -Encoding utf8 "$cfg\home.toml" Get-Content "$cfg\home.toml" ``` **Факт (2026-05-06):** - Попытка 1 (here-string) — провалилась из-за whitespace перед `"@`. - Попытка 2 (array + Set-Content) — ✅. `home.toml` содержит: ```toml # factory home — single source of machine-level state # auto-generated by L0b bootstrap; safe to edit by hand projects_dir = 'C:\Users\vitya\projects' client = 'claude-code' installed_at = '2026-05-06T11:41:04Z' ``` - TOML literal strings корректно сохраняют backslashes Windows-пути. **Gap для bootstrap.ps1**: НЕ использовать here-strings (`@" ... "@`) — слишком хрупкие к whitespace-ошибкам при copy-paste. Писать конфиги через `Set-Content -Value $array` или `[System.IO.File]::WriteAllText(...)`. Если нужна BOM-free UTF-8, на PS5.1 `Set-Content -Encoding utf8` создаёт UTF-8 *с BOM* — для cross-version совместимости лучше `[System.IO.File]::WriteAllText($path, $content, [System.Text.UTF8Encoding]::new($false))`. --- ### Шаг 11 — Запустить L1 (`factory install`) — серия под-шагов L1 пока не существует (нет Go-бинаря). Вместо него — **manual run** через Claude Code, по под-шагам. #### Шаг 11a — клонировать claude-skills + установить скилы ✅ ```powershell cd $PROJECTS_DIR git clone https://git.kzntsv.site/OpeItcLoc03/claude-skills.git cd claude-skills pwsh scripts/install.ps1 Get-ChildItem -Path "$env:USERPROFILE\.claude\skills" -Directory | Select-Object Name ``` **Факт (2026-05-06):** - Клон claude-skills (698 объектов, 557 КБ) ✅ - В `claude-skills/scripts/` изначально не было `install.ps1` — только `install.sh`. Добавлен из директорской машины (commit `ef14594`, push в gitea), на ноуте `git pull --ff-only` подтянул. - `pwsh scripts/install.ps1` — **21 скилл** установлен в `C:\Users\vitya\.claude\skills\` (active-platform, caveman-*, find-skills, project-bootstrap, project-discipline, pulling-before-work, setup-context7, setup-interns, setup-projects-meta, setup-tasks, setup-wiki, using-context7, using-interns, using-markitdown, using-projects-meta, using-tasks, using-wiki) ✅ - Финальный `Get-ChildItem` — те же 21 имени, всё на месте. #### Шаг 11b — запустить claude, залогиниться, поставить плагины ✅ ```powershell cd $PROJECTS_DIR\.factory claude # в Claude: # /login — OAuth flow в браузере # /plugin install superpowers@claude-plugins-official # /plugin install context7@claude-plugins-official # /reload-plugins — применить # /exit ``` **Факт (2026-05-06):** - OAuth login прошёл через браузер ✅ - `/plugin install superpowers@claude-plugins-official` → ✅ установлен - `/plugin install context7@claude-plugins-official` → ✅ установлен - **Открытие**: `/plugin marketplace add claude-plugins-official` — **НЕ НУЖНО**. Маркетплейс `claude-plugins-official` уже предзарегистрирован в Claude Code. Команда `/plugin install @claude-plugins-official` работает сразу. Подтверждение — README репо `github.com/anthropics/claude-plugins-official`: "You do NOT need to register the marketplace separately". - `/active-platform` после reload — отрабатывает, Windows + PowerShell ✅ **Gaps для bootstrap.ps1:** - ✅ Не учить юзера `/plugin marketplace add claude-plugins-official` — это лишний шаг. Сразу `/plugin install @claude-plugins-official`. Предыдущая инструкция в наследии установок устарела. - ⚠ После выхода из `claude` и открытия **новой** PowerShell-сессии переменная `$PROJECTS_DIR` не видна (PS-переменные живут только внутри сессии; нужен `$env:PROJECTS_DIR` через `[Environment]::SetEnvironmentVariable(..., "User")` если хотим персистентности, или просто перезадать в новой сессии). bootstrap.ps1 должен после рестартов либо (а) читать `projects_dir` из `~\.config\factory\home.toml`, либо (б) экспортировать `$env:PROJECTS_DIR` на уровне User через `SetEnvironmentVariable`. Вариант (а) каноничнее — home.toml уже SoT. #### Шаг 11c — пройтись по setup-* скилам Порядок: `/setup-projects-meta` → `/setup-interns` → `/setup-tasks` → `/setup-wiki` → `/setup-context7` (последний может уже работать через установленный плагин). ##### 11c-1 — `/setup-projects-meta` 🔄 **Факт (2026-05-06):** - Phase 0/1 read-only checks ✅ (git/node/npm OK, gitea reachable HTTP 200) - Phase 1 нашёл: проектов-мета MCP не установлен, build отсутствует, .wiki не клонирована, токена нигде нет, `mcpServers` в `~\.claude.json` отсутствует. - Phase 2 спросил PAT — юзер вставил. - Phase 4 первая попытка `git clone https://...` без auth → ❌ `Failed to authenticate user`. **Скил автоматически переключился на `https://USER:TOKEN@host/...`** — клон прошёл, но **токен попал в `.git/config` обоих репо** (projects-meta-mcp + projects-wiki). Это утечка. - npm install + build ✅ (`dist/server.js` построен, tsc без ошибок). - Phase 5: `auth.toml` записан с токеном. - Phase 6: `mcpServers.projects-meta` добавлен в `~\.claude.json`. JSON валиден. Бэкап `.claude.json.bak-20260506-151111` сохранён. - Phase 7: `node dist/sync.js` → `synced 13 projects, 0 errors`. Кэш `~\.cache\projects-mcp\tasks.json` создан. - После рестарта Claude `/mcp` показал `projects-meta · ✓ connected · 14 tools` ✅ **Gaps для bootstrap.ps1 / для setup-projects-meta skill (критично):** - ❌ **Утечка токена в `.git/config`**: при первой неудаче без creds скил пересобирает URL с `https://USER:TOKEN@host/...`. Git сохраняет этот URL в `.git/config` клонированного репо — токен на диске. Канон: `git -c http.extraheader="Authorization: token $T" clone ` — per-invocation, не персистится. Открыть задачу в `claude-skills/.tasks/`: `setup-projects-meta-token-leak`. - ⚠ В Bash tool под Claude `git clone` без явного credential helper не поднимает GCM (non-interactive). На голой машине нужно либо явно использовать extraheader, либо предварительно настроить cred helper, либо клонировать ДО запуска скила (вручную, в интерактивной PS, чтобы GCM запросил и сохранил). - ⚠ После каждого `cd` Bash tool reset'ит cwd на исходную в следующем вызове — скил это компенсировал через `cd … && cmd`. Не блокер, но при пайплайнах лучше использовать `git -C` / `npm --prefix`. - ⚠ На голой Win11 у Claude в `~\.claude.json` нет ключа `mcpServers` вообще — все setup-* должны добавлять его идемпотентно (этот добавил корректно). **Решение по экспозиции токена:** PAT (`9e0f1f71...546d`) утёк в чат и в `.git/config` двух клонов. Юзер сознательно скипнул ротацию (private gitea на собственном сервере, риск приемлемый). Зафиксировано как факт; технический gap для скила setup-projects-meta — отдельная задача `setup-projects-meta-token-leak` в `claude-skills/.tasks/`. ##### 11c-2 — `/setup-interns` 🔄 **Pre-step (на ноуте):** клонировать `.common/` целиком, сохранив существующий sub-репо `lib/projects-meta-mcp/`: ```powershell $common = "$PROJECTS_DIR\.common" $tmp = "$PROJECTS_DIR\.common.bak-projects-meta-mcp" Move-Item "$common\lib\projects-meta-mcp" $tmp Remove-Item -Recurse -Force $common git clone https://git.kzntsv.site/OpeItcLoc03/common.git $common New-Item -ItemType Directory -Force -Path "$common\lib" | Out-Null Move-Item $tmp "$common\lib\projects-meta-mcp" ``` Verify: `Test-Path "$common\lib\interns-mcp\pyproject.toml"`, `Test-Path "$common\config\interns\config.yaml"`, `Test-Path "$common\lib\projects-meta-mcp\dist\server.js"` — все True. **Факт первого запуска (2026-05-06):** - Phase 0 ✅ (Python 3.12.13 в mise, Node 24.15.0) - Phase 1 ❌ STOP: ".common/lib/interns-mcp/ not found" - **Причина:** скил `setup-interns` ищет `/.common/...` **относительно cwd**. На ноуте `claude` был запущен из `C:\Windows\System32` — там нет `.common/`. - Сравнение: `setup-projects-meta` SKILL.md уже исправлен на абсолютный `~/projects/.common/...` (через done-задачу `using-projects-meta-fix-paths`). У `setup-interns` тот же баг — task `setup-interns-fix-paths` открыт в `claude-skills/.tasks/STATUS.md`. **Workaround для field-test:** `cd $PROJECTS_DIR` перед `claude`. Тогда cwd содержит `.common/` как ребёнка, скил его находит. **Факт второго запуска (2026-05-06, после `cd $PROJECTS_DIR` + claude restart):** - Phase 0 ✅ Python 3.12.13 (mise), Node 24.15.0 - Phase 1 ✅ source найден в `.common/lib/interns-mcp/`, config в `.common/config/interns/config.yaml`, endpoints: `ollama_cloud`. Module не importable (ожидаемо). Missing key: `OLLAMA_CLOUD_API_KEY`. - Phase 2 plan: backup → .gitignore add → pip install -e → secrets/interns.env → mcpServers.interns. Юзер дал ключ. - Phase 3 ✅ backup `~/.claude.json.bak-20260506-153537` - Phase 4 ✅ `pip install -e .common/lib/interns-mcp/` под mise-Python - Phase 5 ✅ `.gitignore` (см. gap ниже) + `.common/secrets/interns.env` - Phase 6 ✅ `mcpServers.interns` добавлен в `~\.claude.json` с абсолютным путём к mise-Python и `cwd: C:/Users/vitya/projects` - Phase 7/8 — оборваны лимитом Anthropic, но фактически делать было нечего: JSON валиден (проверил `Get-Content … | ConvertFrom-Json`), restart Claude дал `/mcp` → `interns · √ connected · 2 tools`. ✅ - **2 tools** = `bulk_text_read` + `transcript_distill`. `repo_read` пока отсутствует в `.common/lib/interns-mcp/interns_mcp/interns/` (impl-задача `common#interns-repo-read-impl` ещё не landed; skill-edits зашли вперёд per `claude-skills` task `interns-repo-read-skill-updates`). Это ожидаемое состояние, не gap. **Gap для bootstrap.ps1 / setup-interns skill:** - ⚠ Phase 5 пишет `.gitignore` в `/.gitignore` — на этой машине это `C:\Users\vitya\projects\.gitignore`, а `~/projects/` НЕ git-репо. Файл инертен (ничего не игнорит). Реальная защита secrets — `.common/.gitignore` (там `secrets/`). Не утечка, но скил создаёт мусор. Канон: проверять `git -C rev-parse --is-inside-work-tree` ДО создания .gitignore; если не репо — пропускать (защита делегируется в `.common/.gitignore`). ✅ **11c-2 закрыт.** ##### 11c-3 — `/setup-tasks`, 11c-4 — `/setup-wiki`, 11c-5 — `/setup-context7` ⏳ (в очереди) --- ## Gaps / questions surfaced during field-test (заполняется по ходу) - **2026-05-06 шаг 1**: стартовая консоль на чистой Win11 — `cmd`, не PowerShell. bootstrap.ps1 должен или (а) запускаться явно через `powershell -c "iwr … | iex"`, или (б) при старте проверить `$PSVersionTable` и подсказать. На голой Win11 у нового сотрудника `cmd` будет дефолтом. - **2026-05-06 шаг 2**: `gh` (GitHub CLI) не работает с приватным gitea — лишний пакет. Заменить в bootstrap.ps1 на `gitea.tea` либо сделать выбор по `home.toml#git_host`. - **2026-05-06 шаг 3**: после `winget install Microsoft.PowerShell` юзер всё ещё может запустить **Windows PowerShell 5.1** вместо PS7 (две разные программы в Start menu, похожие иконки). bootstrap.ps1 должен или явно вызвать `pwsh.exe`, или громко проверить `$PSVersionTable.PSVersion.Major -ge 7` и переоткрыть себя в pwsh. Профили (`$PROFILE`) у 5.1 и 7 разные — путаница приведёт к "mise активирован, но не работает". - **2026-05-06 conv**: в gitea репо называются БЕЗ точки (`factory`, не `.factory`). Локальная папка — С точкой (`.factory/`). Закрепить mapping `gitea_repo → local_path` в L1 manifest (вероятно как поле `target_dir` отдельно от `source.url`). - **2026-05-06 шаг 3**: после `winget install jdx.mise` PATH обновлён только для НОВЫХ сессий. App-execution-alias делает `mise --version` рабочим сразу, но команды из `mise activate pwsh` (которые туда не попадают) — нет. bootstrap.ps1 должен после установки mise самозавершиться с инструкцией "открой новую pwsh и запусти `bootstrap.ps1 --resume`" — НЕ пытаться `. $PROFILE` в той же сессии. - **2026-05-06 VS Code**: на чистой машине VS Code по дефолту цепляет Windows PowerShell 5.1, а не PS7 — даже если PS7 установлен. Нужно явно прописать в `settings.json`: `"terminal.integrated.defaultProfile.windows": "PowerShell"` + профиль с `path: "pwsh.exe"`. Кандидат на L0a опциональный шаг "configure VS Code" (если установлен). - **2026-05-06 шаг 11a**: в `claude-skills/scripts/` есть только `install.sh` (bash) — `install.ps1` отсутствует. На Windows-машине нативный путь — pwsh, а не git-bash. Нужно добавить `install.ps1` в `claude-skills` (PR в репо), сейчас обходимся inline-PS-блоком. - **2026-05-06 шаг 11b**: маркетплейс `claude-plugins-official` уже **предзарегистрирован** в Claude Code — `/plugin marketplace add claude-plugins-official` лишний. Сразу `/plugin install @claude-plugins-official`. Любые наследуемые from-the-internet инструкции с `marketplace add` — устарели. - **2026-05-06 шаг 11b**: `$PROJECTS_DIR` (PS-переменная сессии) **не переживает рестарт shell** — после выхода из `claude` и открытия новой PS она пуста. bootstrap.ps1 должен полагаться на `~\.config\factory\home.toml#projects_dir` (уже SoT) или через `[Environment]::SetEnvironmentVariable("PROJECTS_DIR", $val, "User")` экспортировать на User-уровень. Канон — читать из home.toml в каждой новой сессии. - **2026-05-06 шаг 11c-1 / setup-projects-meta**: при first-clone без creds скил fallback'ается на `https://USER:TOKEN@host/...` → токен пишется в `.git/config` клонированного репо. Это утечка. Канон в скиле: `git -c http.extraheader="Authorization: token $T" clone …` (per-invocation, не персистит). Создать задачу `setup-projects-meta-token-leak` в `claude-skills/.tasks/`. - **2026-05-06 шаг 11c-1**: `~\.claude.json` после первого `claude login` — без ключа `mcpServers`. Все setup-* должны идемпотентно добавлять корневой ключ. setup-projects-meta это сделал правильно — ок. - **2026-05-06 шаг 11c-1 — security**: PAT, выданный юзером в чат, оказался в (a) транскрипте Claude / телеметрии, (b) `.git/config` двух клонов, (c) `auth.toml`. Юзер скипнул ротацию (private gitea, low-stakes). **Канон для bootstrap.ps1 (на будущее, для public hosts)**: токен запрашивать через `Read-Host -AsSecureString` в shell-промпте до запуска `claude`, не через чат. Для приватных gitea — на усмотрение администратора. - **2026-05-06 шаг 11c-2 — cwd**: setup-* скилы расходятся в способе адресации `.common/`. `setup-projects-meta` использует абсолютный `~/projects/.common/...` (исправлено в done-задаче `using-projects-meta-fix-paths`). `setup-interns` всё ещё юзает cwd-относительный `/.common/...`. На голой Win11 у юзера cwd при первом `claude` часто `C:\Windows\System32` (он не делает `cd`) — `setup-interns` падает в Phase 1. **Канон для bootstrap.ps1**: явно `Set-Location $PROJECTS_DIR` ДО запуска claude. Долгосрочно: фабрикa-aware скилы должны читать `projects_dir` из `~/.config/factory/home.toml`. Открыта задача `setup-interns-fix-paths` в `claude-skills/.tasks/`. - **2026-05-06 шаг 11c-2 — `.common` clone**: `setup-projects-meta` создаёт только `.common/lib/projects-meta-mcp/` (через `mkdir -p ~/projects/.common/lib && git clone …`), но НЕ клонирует сам репо `.common`. В результате на новой машине после setup-projects-meta существует псевдо-`.common/` без `CLAUDE.md`, `config/`, `prompts/`, `scripts/`, `lib/interns-mcp/` — это ломает `setup-interns` и любой следующий setup-* в цепочке. **Канон для bootstrap.ps1 / для L1 manifest**: `dot-common` — отдельный компонент с `source: { type: git, url: "{gitea}/common" }, target: "{projects_dir}/.common"`, ставится ДО projects-meta-mcp. В текущем field-test'е сделан pre-step вручную (move projects-meta-mcp aside → clone .common → restore). ## Resume point — 2026-05-06 (перерыв) **Состояние field-test'а на момент паузы:** | Слой | Шаг | Статус | |---|---|---| | L0a | 1. Verify winget | ✅ | | L0a | 2. Core dev tools (git/gh/PS7) | ✅ | | L0a | 3. mise install | 🔄 (нужен restart, прошло) | | L0a | 4. node/python/go через mise | ✅ | | L0a | 5. git identity | ✅ | | L0a | 6. Claude Code (npm → native) | 🔄 (npm-зомби убран, native ОК) | | L0a | 7. Опциональные тулзы | ⏭ skipped (VS Code уже стоял; остальное докатим позже) | | L0b | 8. projects_dir | ✅ `C:\Users\vitya\projects` | | L0b | 9. Clone factory | ✅ root-commit `7e0c158` | | L0b | 10. home.toml | 🔄 (попытка 1 here-string подвисла; попытка 2 array+Set-Content ✅) | | L1-manual | 11a. claude-skills + 21 skill в `~\.claude\skills\` | ✅ commit `ef14594` (добавил install.ps1) | | L1-manual | 11b. claude login + плагины superpowers/context7 | ✅ оба плагина встали; `/plugin marketplace add` — не нужен | | L1-manual | 11c-1. /setup-projects-meta | ✅ 13 projects synced, 14 tools | | L1-manual | 11c-2. clone .common + /setup-interns | ✅ 2 tools (bulk_text_read + transcript_distill); repo_read pending impl | | L1-manual | 11c-3. /setup-tasks | ⏳ ждём reset лимита (19:20 МСК) | | L1-manual | 11c-4. /setup-wiki | ⏳ | | L1-manual | 11c-5. /setup-context7 | ⏳ (плагин уже встал в 11b — может быть no-op) | **Что юзер делает в перерыве:** под-шаг 11b — `claude` в `$PROJECTS_DIR\.factory`, OAuth login, `/plugin marketplace add claude-plugins-official`, `/plugin install superpowers@claude-plugins-official`, `/plugin install context7@claude-plugins-official`. После этого `/exit`. **Первое действие после возвращения:** 1. Спросить юзера: "Чем закончился 11b? Залогинился? Какие плагины встали? Видны `/setup-projects-meta`, `/active-platform` в slash-меню?" 2. Если ОК — переходим к 11c: `/setup-projects-meta` (первый, потому что от него зависят interns и shared wiki). У этого скила интерактивный flow с preview/confirm — нужен PAT в `~/.config/projects-mcp/auth.toml`. Юзер уже в курсе, как генерить PAT. 3. Дальше по списку: `/setup-interns` → `/setup-tasks` → `/setup-wiki` → `/setup-context7` (последний — может уже стоять, если плагин context7 поставился через `/plugin install` в 11b). **Открытые design-вопросы** (в `.meeting-room/.brainstorm/factory-bootstrap.md`, секция "Открытые"): Q2 (где живёт factory.yaml), Q3 (slash-bridge для L2), Q4 (версионирование manifest'а), Q5 (secrets unification). **Где смотреть после возвращения:** - Этот файл — пошаговый лог. - `.meeting-room/.brainstorm/factory-bootstrap.md` — design-буфер. - `git.kzntsv.site/OpeItcLoc03/factory` — если работаешь с другой машины, `git pull` сюда даст актуальный лог. ## Diff plan: log → bootstrap.ps1 После заполнения всех ✅ — пройти список и для каждого шага: 1. Выкинуть всё что было ручной правкой / интерактивным выбором → перенести в `bootstrap.ps1` как функцию с параметрами. 2. Шаги, отмеченные `❌`/`🔄`, сделать первоочередными — там реальные gap'ы native experience. 3. PS-скрипт должен запускаться от user-scope (без admin), кроме шагов где winget сам поднимет UAC. 4. Все интерактивные диалоги — через `Read-Host` или `Select-Object` (ASCII-меню).