Refocus the VS Code setup on a web-first Copilot/MCP workflow

.github/copilot-instructions.md

@@ -0,0 +1,10 @@
+# Copilot instructions for this repository
+
+> Wersja dokumentu: gpt5.5-2026.05.19-0.3.1
+
+- Traktuj repo jako web-first setup dla VS Code i VS Code Insiders.
+- Preferuj rozwiązania dla aplikacji webowych, stron firmowych, web games i Android hybrid apps z web stacku.
+- Nie dodawaj ciężkich integracji ani silników spoza web stacku, jeśli nie dają jasnej korzyści dla tego repo.
+- Przy zmianach konfiguracji preferuj Copilot, prompt/instructions files, lokalne skille i zatwierdzone MCP serwery zamiast losowych dodatków.
+- Dbaj o accessibility, performance, security i czytelny minimalny zakres zmian.
+- Nie dodawaj ani nie konfiguruj zewnętrznych serwerów MCP bez sprawdzenia źródła i uprawnień.

AGENTS.md

@@ -0,0 +1,13 @@
+# AGENTS.md
+
+> Wersja dokumentu: gpt5.5-2026.05.19-0.3.1
+
+## Repository intent
+- To repo konfiguruje Windows + VS Code / VS Code Insiders pod web-first vibe coding.
+- Najważniejsze workflow to web apps, business websites, web games, backend/API/devops i Android hybrid apps z web stacku.
+
+## Agent rules
+- Preferuj rozwiązania, rozszerzenia i skille realnie przydatne dla aplikacji webowych.
+- Nie dodawaj ciężkich tooli spoza web stacku bez wyraźnej potrzeby.
+- Wykorzystuj `.github/copilot-instructions.md`, lokalne skille i zatwierdzone MCP serwery jako główny sposób rozszerzania możliwości Copilota.
+- Zawsze bierz pod uwagę security, minimal permissions i niezatwierdzone źródła integracji.

IMPLEMENTATION_PLAN.md

@@ -1,6 +1,6 @@
 # Plan wdrożenia vibe-coding environment
 
-> Wersja dokumentu: gpt5.5-2026.05.16-0.3.0
+> Wersja dokumentu: gpt5.5-2026.05.19-0.3.1
 
 Ten plik jest źródłem kontekstu dla kolejnych AI i ludzi kontynuujących pracę.
 Dokument musi być aktualizowany na bieżąco razem ze zmianami w repo i przy każdej zmianie musi dostać nową wersję w formacie `model-data-wersja`.
@@ -27,6 +27,8 @@ Zbudować potężny, automatyczny zestaw skryptów dla Windows 11, VS Code i VS
 - [x] Uruchomić końcową walidację składni/JSON.
 - [x] Uruchomić CodeQL checker.
 - [x] Follow-up review: poprawić weryfikację Capacitor CLI, aby akceptowała `cap` z `@capacitor/cli`.
+- [x] Final review: rozszerzyć realnie przydatny gamedev stack (Godot/Unity/Blender/C++/CMake), dodać brakujące skille i przepiąć domyślne modele na GPT-5.4/GPT-5.5.
+- [x] Follow-up review 2: zawęzić repo do web-first workflow i dopiąć ustawienia Copilot/MCP/AGENTS.md pod VS Code oraz VS Code Insiders.
 
 ## Architektura
 
@@ -36,7 +38,8 @@ Zbudować potężny, automatyczny zestaw skryptów dla Windows 11, VS Code i VS
 - `scripts/config/vscode-extensions.txt` zawiera rozszerzenia dla VS Code i Insiders.
 - `scripts/config/vscode-settings.json` zawiera bazowe ustawienia UX/productivity/Copilot.
 - `scripts/config/skills-manifest.json` wskazuje lokalne i opcjonalne zdalne skille.
-- `scripts/skills/` zawiera lokalne skille startowe.
+- `scripts/skills/` zawiera lokalne skille startowe dla web/business.
+- `.github/copilot-instructions.md` i `AGENTS.md` dopinają repo-wide context dla Copilota i agentów.
 - Wszystkie dokumenty Markdown w repo mają obowiązkowy nagłówek wersji `model-data-wersja` i muszą być utrzymywane równolegle do zmian w kodzie lub konfiguracji.
 
 ## Kolejne rekomendowane kroki
@@ -45,3 +48,4 @@ Zbudować potężny, automatyczny zestaw skryptów dla Windows 11, VS Code i VS
 - [ ] Dodać opcjonalny manifest z firmowymi, zatwierdzonymi zdalnymi skillami po wskazaniu URL-i.
 - [ ] Dodać test uruchamiany na Windows runnerze, jeżeli repo dostanie CI.
 - [ ] Rozważyć pinning wersji narzędzi npm/pip w osobnych manifestach enterprise.
+- [ ] Rozważyć wersjonowany przykładowy `.vscode/mcp.json`, jeśli zespół wybierze konkretny zestaw zatwierdzonych serwerów MCP.

README.md

@@ -1,6 +1,6 @@
 # github-and-vscode-vibecoding-config
 
-> Wersja dokumentu: gpt5.5-2026.05.16-0.3.0
+> Wersja dokumentu: gpt5.5-2026.05.19-0.3.2
 
 Kompletny zestaw skryptów PowerShell do automatycznego przygotowania świeżego Windows 11 pod:
 - VS Code / VS Code Insiders,
@@ -26,11 +26,11 @@ Szczegółowy plan wdrożenia oraz lista TODO dla kolejnych AI znajduje się w:
 - Edytory: VS Code oraz opcjonalnie VS Code Insiders.
 - Copilot/GitHub: Copilot, Copilot Chat, GitHub PR, GitHub Actions, GitHub CLI.
 - Web/business: Node.js, pnpm, yarn, Vite, Next.js, Angular, Astro, Tailwind, ESLint, Prettier, Stylelint.
-- Game/web: Live Server, Godot tools, Markdown/Mermaid, CLI pod prototypowanie web games.
+- Web workflow: Live Server, Markdown/Mermaid, prompt/instructions workflow, MCP discovery/gallery i CLI pod prototypowanie web apps/web games.
 - Android hybrid: Android Studio, JDK, Ionic, Capacitor, native-run, Cordova.
 - Backend/devops: Docker, Dev Containers, Kubernetes, YAML, Terraform, Postman/Thunder Client.
 - Python/.NET/Go/Rust: runtime’y, rozszerzenia i podstawowe narzędzia.
-- Skille: lokalne workflow dla web games i profesjonalnych stron firmowych kopiowane do `~\.vibe-coding\skills`.
+- Skille: lokalne workflow dla web apps, web games i profesjonalnych stron firmowych kopiowane do `~\.vibe-coding\skills`.
 
 ## Struktura
 
@@ -40,7 +40,9 @@ Szczegółowy plan wdrożenia oraz lista TODO dla kolejnych AI znajduje się w:
 - `/scripts/config/vscode-extensions.txt` – pełna lista rozszerzeń.
 - `/scripts/config/vscode-settings.json` – szablon ustawień UI/UX i produktywności.
 - `/scripts/config/skills-manifest.json` – manifest lokalnych i opcjonalnych zdalnych skilli.
-- `/scripts/skills/` – lokalne skille startowe.
+- `/scripts/skills/` – lokalne skille startowe dla web/business.
+- `/.github/copilot-instructions.md` – repozytoryjne instrukcje dla GitHub Copilot.
+- `/AGENTS.md` – instrukcje agentowe dla VS Code/Copilot przy włączonym `chat.useAgentsMdFile`.
 
 ## Szybki start: pełny tryb z VS Code Insiders i Androidem
 
@@ -91,6 +93,18 @@ Skrypty są idempotentne i kontynuują pracę przy błędach pojedynczych pakiet
 - Niepoprawny istniejący `settings.json` jest backupowany przed nadpisaniem ustawień z szablonu.
 - Skille z manifestu mogą być lokalne albo zdalne; błędy pobierania nie blokują konfiguracji edytora.
 
+## Domyślne modele Copilot
+
+- Inline completions są pinowane w konfiguracji na `GPT-5.4`.
+- Dla chat/agent workflow w skillach repo przyjmuje `GPT-5.5` jako domyślny wybór roboczy.
+- Obecnie wybór modelu chat w VS Code nadal robi się z pickera w sesji, więc repo ustawia to przez konwencję w skillach, a nie przez twardy globalny klucz settings.
+
+## Copilot / MCP / agent workflow w VS Code i Insiders
+
+- Wspólne ustawienia aktywują agent mode, `AGENTS.md`, MCP discovery/gallery, Copilot code actions, code search i next edit suggestions.
+- Repo nie pinuje zewnętrznych serwerów MCP na sztywno, żeby nie dodawać niezatwierdzonych integracji; zamiast tego przygotowuje VS Code/Insiders do ich wykrywania i bezpiecznego dodania.
+- Najlepsze praktyki na 2026 w tym repo to: repo-wide instructions w `.github/copilot-instructions.md`, root `AGENTS.md`, lokalne skille w `~\.vibe-coding\skills` oraz ręczne dodawanie tylko potrzebnych serwerów MCP z zaufanych źródeł.
+
 ## Po instalacji
 
 1. Uruchom VS Code / VS Code Insiders.
@@ -103,4 +117,5 @@ Skrypty są idempotentne i kontynuują pracę przy błędach pojedynczych pakiet
 
 - Nie commituj sekretów, tokenów ani plików `.env` z danymi produkcyjnymi.
 - Zdalne skille dodawaj do `skills-manifest.json` tylko z zatwierdzonych źródeł.
+- Zewnętrzne MCP serwery dodawaj tylko z zatwierdzonych źródeł i z minimalnym zakresem uprawnień.
 - Dla firmowych projektów rozważ pinning wersji narzędzi w osobnych manifestach.

scripts/Verify-Setup.ps1

@@ -54,6 +54,28 @@ function Test-OptionalCommandAny {
     Write-Result -Label $Label -Status $(if ($ok) { "OK" } else { "WARN" }) -Message $(if ($ok) { "" } else { "- opcjonalne, sprawdź fallback w README" })
 }
 
+function Get-ConfiguredExtensions {
+    param([Parameter(Mandatory = $true)][string]$ExtensionListPath)
+
+    if (-not (Test-Path $ExtensionListPath)) {
+        throw "Nie znaleziono listy rozszerzeń: $ExtensionListPath"
+    }
+
+    return Get-Content -Path $ExtensionListPath | ForEach-Object { $_.Trim() } | Where-Object {
+        $_ -and -not $_.StartsWith("#")
+    }
+}
+
+function Get-SkillsManifest {
+    param([Parameter(Mandatory = $true)][string]$ManifestPath)
+
+    if (-not (Test-Path $ManifestPath)) {
+        throw "Nie znaleziono manifestu skilli: $ManifestPath"
+    }
+
+    return Get-Content -Path $ManifestPath -Raw | ConvertFrom-Json
+}
+
 Write-Host "Weryfikacja narzędzi bazowych:`n"
 @("git", "gh", "node", "npm", "python", "dotnet") | ForEach-Object { Test-RequiredCommand -Name $_ }
 
@@ -78,6 +100,8 @@ if ($InstallAndroidTooling) {
 
 Write-Host "`nWeryfikacja VS Code:`n"
 $codeCmd = if ($UseInsiders) { "code-insiders" } else { "code" }
+$extensionListPath = Join-Path $PSScriptRoot "config\vscode-extensions.txt"
+$skillsManifestPath = Join-Path $PSScriptRoot "config\skills-manifest.json"
 if (-not (Test-Command -Name $codeCmd) -and $UseInsiders -and (Test-Command -Name "code")) {
     Write-Result -Label "code-insiders" -Status "WARN" -Message "- fallback do stable VS Code dostępny jako code"
     $codeCmd = "code"
@@ -86,23 +110,9 @@ else {
     Test-RequiredCommand -Name $codeCmd
 }
 
-$expectedExtensions = @(
-    "GitHub.copilot",
-    "GitHub.copilot-chat",
-    "GitHub.vscode-pull-request-github",
-    "dbaeumer.vscode-eslint",
-    "esbenp.prettier-vscode",
-    "bradlc.vscode-tailwindcss",
-    "ms-vscode.vscode-typescript-next",
-    "ms-azuretools.vscode-docker",
-    "ms-vscode-remote.remote-containers",
-    "ms-python.python",
-    "ms-vscode.powershell",
-    "geequlim.godot-tools"
-)
-
 try {
     if (Test-Command -Name $codeCmd) {
+        $expectedExtensions = Get-ConfiguredExtensions -ExtensionListPath $extensionListPath
         $installedExtensions = & $codeCmd --list-extensions
         foreach ($ext in $expectedExtensions) {
             $ok = $installedExtensions -contains $ext
@@ -115,10 +125,19 @@ catch {
 }
 
 Write-Host "`nWeryfikacja lokalnych skilli:`n"
-$skillsPath = Join-Path $HOME ".vibe-coding\skills"
-foreach ($skill in @("web-game-vibe-coding.md", "business-websites-vibe-coding.md")) {
-    $path = Join-Path $skillsPath $skill
-    Write-Result -Label $skill -Status $(if (Test-Path $path) { "OK" } else { "WARN" }) -Message $(if (Test-Path $path) { "" } else { "- uruchom Configure-VSCode.ps1" })
+try {
+    $skillsManifest = Get-SkillsManifest -ManifestPath $skillsManifestPath
+    $installRootName = if ($skillsManifest.installRootName) { [string]$skillsManifest.installRootName } else { ".vibe-coding\skills" }
+    $skillsPath = Join-Path $HOME $installRootName
+
+    foreach ($item in $skillsManifest.items) {
+        $skillFileName = "$([string]$item.name).md"
+        $path = Join-Path $skillsPath $skillFileName
+        Write-Result -Label $skillFileName -Status $(if (Test-Path $path) { "OK" } else { "WARN" }) -Message $(if (Test-Path $path) { "" } else { "- uruchom Configure-VSCode.ps1" })
+    }
+}
+catch {
+    Write-Result -Label "skills manifest" -Status "ERR" -Message $_.Exception.Message
 }
 
 if ($script:Failed) {

scripts/config/skills-manifest.json

@@ -1,6 +1,12 @@
 {
   "installRootName": ".vibe-coding\\skills",
   "items": [
+    {
+      "name": "web-app-vibe-coding",
+      "description": "Workflow dla nowoczesnych aplikacji webowych: frontend, API, auth, jakość, performance i deployment.",
+      "source": "local",
+      "path": "scripts\\skills\\web-app-vibe-coding.md"
+    },
     {
       "name": "web-game-vibe-coding",
       "description": "Workflow dla web games, pixel-art, Phaser/Pixi/Three/Babylon i buildów Android przez Capacitor.",

scripts/config/vscode-extensions.txt

@@ -14,12 +14,14 @@ streetsidesoftware.code-spell-checker
 ms-vscode.hexeditor
 ritwickdey.LiveServer
 EditorConfig.EditorConfig
+yzhang.markdown-all-in-one
 
 # Frontend / web / business sites
 dbaeumer.vscode-eslint
 esbenp.prettier-vscode
 bradlc.vscode-tailwindcss
 formulahendry.auto-rename-tag
+formulahendry.auto-close-tag
 ecmel.vscode-html-css
 ms-vscode.vscode-typescript-next
 Vue.volar
@@ -61,8 +63,7 @@ tamasfe.even-better-toml
 # PowerShell / Windows automation
 ms-vscode.powershell
 
-# Pixel-art / game / docs
-geequlim.godot-tools
+# Web docs / diagrams
 bierner.markdown-mermaid
 shd101wyy.markdown-preview-enhanced
 jebbs.plantuml

scripts/config/vscode-settings.json

@@ -34,13 +34,21 @@
     "**/build": true
   },
   "git.autofetch": true,
+  "chat.agent.enabled": true,
+  "chat.useAgentsMdFile": true,
+  "chat.mcp.discovery.enabled": true,
+  "chat.mcp.gallery.enabled": true,
+  "github.copilot.selectedCompletionModel": "GPT-5.4",
+  "github.copilot.editor.enableCodeActions": true,
   "github.copilot.enable": {
     "*": true,
     "plaintext": false,
     "markdown": true,
     "scminput": true
   },
   "github.copilot.chat.localeOverride": "pl",
+  "github.copilot.chat.codesearch.enabled": true,
+  "github.copilot.nextEditSuggestions.enabled": true,
   "chat.commandCenter.enabled": true,
   "extensions.ignoreRecommendations": false,
   "css.validate": true,

scripts/skills/business-websites-vibe-coding.md

@@ -1,10 +1,13 @@
 # Business Websites Vibe Coding Skill
 
-> Wersja dokumentu: gpt5.5-2026.05.16-0.3.0
+> Wersja dokumentu: gpt5.5-2026.05.19-0.3.1
 
 ## Cel
 Tworzenie profesjonalnych, zarządzanych stron firmowych z dobrym SEO, accessibility i deploymentem.
 
+## Preferowane modele
+- Chat/agent: GPT-5.5
+- Completions/inline suggestions: GPT-5.4
 ## Zasada dokumentacji
 - Każda zmiana workflow, stacku albo checklisty wymaga natychmiastowej aktualizacji tego dokumentu.
 - Przy każdej zmianie trzeba też podnieść oznaczenie wersji w formacie `model-data-wersja`.

scripts/skills/web-app-vibe-coding.md

@@ -0,0 +1,26 @@
+# Web App Vibe Coding Skill
+
+> Wersja dokumentu: gpt5.5-2026.05.19-0.3.1
+
+## Cel
+Tworzenie nowoczesnych aplikacji webowych z naciskiem na szybkie iteracje, dobrą strukturę domeny, jakość UX i bezpieczny deployment.
+
+## Preferowane modele
+- Chat/agent: GPT-5.5
+- Completions/inline suggestions: GPT-5.4
+
+## Zasada dokumentacji
+- Każda zmiana workflow, stacku albo checklisty wymaga natychmiastowej aktualizacji tego dokumentu.
+- Przy każdej zmianie trzeba też podnieść oznaczenie wersji w formacie `model-data-wersja`.
+
+## Stack
+- Next.js, Astro albo Vite + React/Vue/Svelte zależnie od potrzeb projektu.
+- TypeScript jako domyślny język aplikacji.
+- ESLint, Prettier, Lighthouse i axe jako stała kontrola jakości.
+- Docker/Dev Containers, GitHub Actions i zatwierdzone MCP serwery tylko wtedy, gdy faktycznie upraszczają pracę.
+
+## Workflow
+- Zaczynaj od małego vertical slice: routing, UI, dane i deploy path.
+- Rozdzielaj UI, logikę domenową, integracje i konfigurację środowiska.
+- Projektuj pod accessibility, performance i mobile-first od pierwszej iteracji.
+- Sekrety trzymaj poza repo, a każde nowe MCP/integrację dodawaj dopiero po ocenie uprawnień i realnej korzyści.

scripts/skills/web-game-vibe-coding.md

@@ -1,10 +1,13 @@
 # Web Game Vibe Coding Skill
 
-> Wersja dokumentu: gpt5.5-2026.05.16-0.3.0
+> Wersja dokumentu: gpt5.5-2026.05.19-0.3.1
 
 ## Cel
 Tworzenie webowych gier 2D/3D i przygotowanie ich do dystrybucji jako aplikacje Android.
 
+## Preferowane modele
+- Chat/agent: GPT-5.5
+- Completions/inline suggestions: GPT-5.4
 ## Zasada dokumentacji
 - Każda zmiana workflow, stacku albo checklisty wymaga natychmiastowej aktualizacji tego dokumentu.
 - Przy każdej zmianie trzeba też podnieść oznaczenie wersji w formacie `model-data-wersja`.