diff --git a/.github/copilot-instructions.md b/.github/copilot-instructions.md new file mode 100644 index 0000000..b79b536 --- /dev/null +++ b/.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ń. diff --git a/AGENTS.md b/AGENTS.md new file mode 100644 index 0000000..1fa0142 --- /dev/null +++ b/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. diff --git a/IMPLEMENTATION_PLAN.md b/IMPLEMENTATION_PLAN.md index 6181a0d..e9e049b 100644 --- a/IMPLEMENTATION_PLAN.md +++ b/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. diff --git a/README.md b/README.md index 7b87bb1..6fd5163 100644 --- a/README.md +++ b/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. diff --git a/scripts/Verify-Setup.ps1 b/scripts/Verify-Setup.ps1 index 836dff3..983d60b 100644 --- a/scripts/Verify-Setup.ps1 +++ b/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) { diff --git a/scripts/config/skills-manifest.json b/scripts/config/skills-manifest.json index 77cf18c..e2d8fc1 100644 --- a/scripts/config/skills-manifest.json +++ b/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.", diff --git a/scripts/config/vscode-extensions.txt b/scripts/config/vscode-extensions.txt index b1687cb..bf947e1 100644 --- a/scripts/config/vscode-extensions.txt +++ b/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 diff --git a/scripts/config/vscode-settings.json b/scripts/config/vscode-settings.json index d49e46f..e546548 100644 --- a/scripts/config/vscode-settings.json +++ b/scripts/config/vscode-settings.json @@ -34,6 +34,12 @@ "**/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, @@ -41,6 +47,8 @@ "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, diff --git a/scripts/skills/business-websites-vibe-coding.md b/scripts/skills/business-websites-vibe-coding.md index 0ff8afb..974c514 100644 --- a/scripts/skills/business-websites-vibe-coding.md +++ b/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`. diff --git a/scripts/skills/web-app-vibe-coding.md b/scripts/skills/web-app-vibe-coding.md new file mode 100644 index 0000000..24807f6 --- /dev/null +++ b/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. diff --git a/scripts/skills/web-game-vibe-coding.md b/scripts/skills/web-game-vibe-coding.md index 2b3a01e..af85b2c 100644 --- a/scripts/skills/web-game-vibe-coding.md +++ b/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`.