symfonia-ai-tools 1.0.0

package/README.md

@@ -0,0 +1,489 @@
+# symfonia-ai-tools
+
+Interaktywny konfigurator AI toolingu dla projektow. Jeden `npx` — kompletna konfiguracja Claude Code, GitHub Copilot, Cursor, Gemini, Junie i GSD.
+
+## Instalacja
+
+```bash
+npx symfonia-ai-tools
+```
+
+Konfigurator przeprowadzi Cie przez:
+1. Wybor typu projektu, opis, tech stack
+2. Wybor pakietow instrukcji i skilli (checkboxy)
+3. Narzedzia AI do skonfigurowania (checkboxy)
+4. Wybor skilli do zainstalowania (checkboxy — bazowe + z wybranych pakietow)
+5. Sciezki, komendy, CI pipeline, prefix JIRA
+6. Serwery MCP (checkboxy + tokeny)
+7. Instalacje CLI (checkboxy)
+
+Caly konfigurator uzywa nawigacji strzalkami — zero wpisywania cyferek.
+
+Na koniec automatycznie uruchamia GSD:
+- **Nowy projekt** → `/gsd:new-project`
+- **Istniejacy projekt** → `/gsd:map-codebase` → `/gsd:new-project`
+
+### Tryby instalacji (istniejacy projekt)
+
+| Tryb | Opis |
+|------|------|
+| **Nadpisz wszystko** | Pelna reinstalacja — nadpisuje istniejace pliki |
+| **Tylko nowe pliki** | Dodaje brakujace pliki, nie rusza istniejacych |
+| **Tylko MCP** | Konfiguruje serwery MCP bez ruszania reszty |
+
+---
+
+## Architektura: Single Source of Truth
+
+Wszystkie narzedzia AI czytaja te same zasady z jednego miejsca:
+
+```
+.ai/guidelines.md              ← JEDYNE ZRODLO PRAWDY
+ │
+ ├── CLAUDE.md                      (referencja)
+ ├── .github/copilot-instructions.md (pointer)
+ ├── .cursor/rules/global.mdc       (pointer)
+ ├── .gemini/settings.json          (referencja)
+ └── .junie/guidelines.md           (pointer)
+```
+
+Zmien `.ai/guidelines.md` — wszystkie agenty to zobacza.
+
+---
+
+## Pakiety (packs)
+
+Zamiast wybierania jednego stacka, wybierasz dowolne pakiety instrukcji i skilli — checkboxami. Kazdy pakiet deklaruje swoje instrukcje, skille i wymagane placeholdery w `pack.json`.
+
+### Dostepne pakiety
+
+| Pakiet | Zawartosc | Domyslny |
+|--------|-----------|----------|
+| **Vue 3 + TypeScript** | 6 instrukcji, 3 skille | Tak |
+| **Vitest** | 1 instrukcja | Tak |
+| **Storybook** | 1 instrukcja | Nie |
+| **Laravel + PHP** | 4 instrukcje, 7 skilli | Nie |
+| **Playwright** | 1 instrukcja, 3 skille | Nie |
+| **Docker** | 1 instrukcja | Nie |
+
+Pakiety sa niezalezne — mozesz laczyc np. Vue 3 + Playwright + Docker.
+
+---
+
+## Co instaluje
+
+### Pliki per narzedzie
+
+| Narzedzie | Pliki |
+|-----------|-------|
+| **Claude Code** | `CLAUDE.md`, `.claude/settings.local.json` (permissions + deny rules) |
+| **GitHub Copilot** | `.github/copilot-instructions.md`, `.github/pull_request_template.md`, `.github/instructions/`, `.github/prompts/`, `.github/skills/` |
+| **Cursor IDE** | `.cursor/rules/global.mdc`, `.cursor/mcp.json` |
+| **Gemini** | `.gemini/settings.json` |
+| **JetBrains Junie** | `.junie/guidelines.md` |
+
+### Pliki wspolne
+
+| Plik | Opis |
+|------|------|
+| `.ai/guidelines.md` | Glowne zasady projektu (source of truth) |
+| `.ai/instructions/` | Instrukcje kontekstowe per typ pliku |
+| `.ai/prompts/` | Reusable prompty AI |
+| `.ai/skills/` | Skille — krok-po-krok workflow |
+| `.ai/context/` | Kontekst projektowy (architektura, API spec, slownik) |
+| `commit-instructions.md` | Commit conventions + branch naming |
+| `.gitignore` | Pre-konfigurowany (AI tokeny, .env, IDE) |
+| `.editorconfig` | Konsystentne formatowanie (utf-8, lf, spaces) |
+
+---
+
+## Instructions (kontekstowe instrukcje)
+
+Instructions to pliki z zasadami, ktore AI stosuje automatycznie gdy pracuje z pasujacymi plikami. Kazda instrukcja ma frontmatter `applyTo` z glob pattern.
+
+### Jak dzialaja
+
+```yaml
+---
+applyTo: "**/*.vue"
+---
+# Vue Component Instructions
+...
+```
+
+Gdy AI otwiera/edytuje plik pasujacy do `applyTo`, automatycznie laduje te instrukcje jako kontekst.
+
+### Vue 3 + TypeScript (6 instrukcji)
+
+| Instrukcja | applyTo | Czego uczy AI |
+|-----------|---------|---------------|
+| `vue.instructions.md` | `**/*.vue` | Composition API, defineProps, withDefaults, template order |
+| `store.instructions.md` | `**/*.store.ts, **/stores/**` | Pinia setup syntax, ref/computed, akcje async |
+| `api.instructions.md` | `**/*Service*.ts, **/api/**` | useApi singleton, interceptory, error handling |
+| `coding-conventions.instructions.md` | `**/*.vue, **/*.ts, **/*.scss` | Naming (camelCase/PascalCase), I/E/T prefixy, CSS single-dash |
+| `composables.instructions.md` | `**/composables/**, **/use*.ts` | useAsyncDataLoader, form composable, filter composable |
+| `forms.instructions.md` | `**/*Form*.vue, **/validation*` | ValidationBuilder, computed validation, 422 handling |
+
+### Vitest (1 instrukcja)
+
+| Instrukcja | applyTo | Czego uczy AI |
+|-----------|---------|---------------|
+| `vitest.instructions.md` | `**/*.test.ts, **/*.spec.ts` | mount, shallowMount, mocking, data-testid selektory |
+
+### Storybook (1 instrukcja)
+
+| Instrukcja | applyTo | Czego uczy AI |
+|-----------|---------|---------------|
+| `storybook.instructions.md` | `**/*.stories.ts` | Meta + StoryObj, autodocs, argTypes, warianty |
+
+### Laravel + PHP (4 instrukcje)
+
+| Instrukcja | applyTo | Czego uczy AI |
+|-----------|---------|---------------|
+| `module.instructions.md` | `**/Modules/**` | Struktura modulu, module.json, ServiceProvider |
+| `service-repository.instructions.md` | `**/*Service*.php, **/*Repository*.php` | CQRS (Command/Query repos), readonly services, DTO |
+| `api-resource.instructions.md` | `**/*Resource*.php, **/*Request*.php` | Resources z whenLoaded(), Form Requests, Policies |
+| `testing.instructions.md` | `**/*Test*.php, **/tests/**` | PHPUnit, data providers, factories, Laravel fakes |
+
+### Playwright (1 instrukcja)
+
+| Instrukcja | applyTo | Czego uczy AI |
+|-----------|---------|---------------|
+| `playwright.instructions.md` | `**/*.spec.ts (e2e)` | Page Object Model, selektory, czekanie na elementy |
+
+### Docker (1 instrukcja)
+
+| Instrukcja | applyTo | Czego uczy AI |
+|-----------|---------|---------------|
+| `docker.instructions.md` | `**/Dockerfile, **/docker-compose*` | Artisan w kontenerze, multi-stage build |
+
+### Dodawanie wlasnej instrukcji
+
+1. Utworz plik w `.ai/instructions/`:
+   ```markdown
+   ---
+   applyTo: "**/*.graphql"
+   ---
+   # GraphQL Instructions
+   Zasady specyficzne dla plikow GraphQL...
+   ```
+2. Mirror do `.github/instructions/` dzieje sie automatycznie jesli Copilot jest wybrany
+
+---
+
+## Guidelines — co zawiera
+
+Plik `.ai/guidelines.md` jest skladany automatycznie z:
+1. **Header** — project overview, tech stack, komendy, CI, commit rules, branch naming, sekcja Forbidden, testing strategy
+2. **Sekcje pakietow** — kazdy wybrany pack dolacza swoja sekcje (np. Vue 3 architecture, Laravel conventions)
+
+### Sekcje w guidelines
+
+| Sekcja | Co zawiera |
+|--------|-----------|
+| Project Overview | Nazwa, opis, tech stack |
+| Commands | test, build, lint, CI |
+| Commits & Branches | Format commitow, branch naming convention |
+| CI Pipeline | Komenda ktora musi przejsc przed PR |
+| Forbidden | Czego AI NIE wolno robic bez zgody |
+| Testing Strategy | Kiedy unit, integration, E2E, regression |
+| Skills | Pointer do `.ai/skills/` |
+| Instructions | Pointer do `.ai/instructions/` |
+| Context | Pointer do `.ai/context/` |
+
+---
+
+## Skills (krok-po-krok workflow)
+
+Skills to gotowe procedury, ktore AI wykonuje krok po kroku. Kazdy skill ma trigger, input, steps i verification checklist.
+
+### Jak uzywac
+
+Powiedz AI:
+
+```
+"Uzywajac skilla new-module, stworz modul uzytkownicy"
+"Wykonaj skilla debug dla bledu TypeError w UserService"
+"Postepuj wedlug skilla pr-prepare"
+```
+
+AI przeczyta `SKILL.md` i wykona kroki po kolei.
+
+### Skills bazowe (wszystkie pakiety)
+
+| Skill | Cel | Kiedy uzywac |
+|-------|-----|-------------|
+| `debug` | Systematyczne debugowanie | Bug, blad, nieoczekiwane zachowanie |
+| `refactor` | Bezpieczny refactoring | Wydzielanie, upraszczanie, przenoszenie kodu |
+| `write-tests` | Dodanie testow | Istniejacy kod bez pokrycia testami |
+| `pr-prepare` | Przygotowanie PR | Przed push — self-review, cleanup, opis |
+| `hotfix` | Szybka poprawka produkcji | Branch z main, minimalny fix, regression test |
+| `babysit-prs` | Monitoring PRow do review | Cykliczne sprawdzanie nowych PRow (GitHub + Bitbucket) |
+| `my-prs` | Status wlasnych PRow | Sprawdzenie approvals, komentarzy, brakujacych review |
+| `pr-dashboard` | Dashboard PRow | Combo babysit-prs + my-prs z opcjonalnym loopem |
+| `fill-worklogs` | Wypelnianie worklogow Jira | Automatyczne uzupelnianie godzin na bazie commitow git |
+| `jira-task` | Pelny workflow Jira | Ticket → branch → implementacja → PR → aktualizacja Jira |
+
+### Skills Vue 3 + TypeScript
+
+| Skill | Cel | Kiedy uzywac |
+|-------|-----|-------------|
+| `new-module` | Nowy modul od zera | types → service → store → composables → views → routes → testy |
+| `new-component` | Nowy komponent | Komponent + story + test + data-testid |
+| `api-integration` | Podlaczenie do API | types + mapper → service → store → composable → widok |
+
+### Skills Laravel + PHP
+
+| Skill | Cel | Kiedy uzywac |
+|-------|-----|-------------|
+| `new-module` | Nowy modul od zera | model → migration → CQRS repos → service → DTO → controller → testy |
+| `new-endpoint` | Nowy endpoint API | request → controller → DTO → service → resource → policy → route → testy |
+| `migration` | Migracja DB | create/modify table → rollback test → model update → factory |
+| `queued-job` | Job / Event / Listener | Job class → retry/backoff → failed handler → idempotentnosc → testy |
+| `testing-feature` | Testy feature (HTTP/DB) | Konwencje testow feature, delta pattern, data resilience |
+| `testing-unit` | Testy jednostkowe | Izolowane testy bez DB, PHPUnit mocks, data providers |
+| `testing-manual` | Testy manualne HTTP | JetBrains HTTP Client — pliki `.http` do interaktywnego testowania API |
+
+### Skills Playwright
+
+| Skill | Cel | Kiedy uzywac |
+|-------|-----|-------------|
+| `playwright` | Nowy test E2E | Page Object → scenariusz → asercje |
+| `playwright-record` | Nagrywanie testu | codegen → cleanup → Page Object |
+| `playwright-codereview` | Review testu E2E | Checklist jakosci testu Playwright |
+
+### Tworzenie wlasnego skilla
+
+1. Utworz katalog w `.ai/skills/nazwa-skilla/`
+2. Skopiuj szablon: `cp .ai/skills/TEMPLATE.md .ai/skills/nazwa-skilla/SKILL.md`
+3. Wypelnij sekcje: Trigger, Input, Steps, Verification checklist
+4. Jesli uzywasz Copilot, skopiuj do `.github/skills/`
+
+---
+
+## Prompts (reusable prompty)
+
+Prompty to gotowe polecenia dla AI do wykonania zlozonych zadan jednym wywolaniem.
+
+### Dostepne prompty
+
+| Prompt | Cel | Jak uzyc |
+|--------|-----|----------|
+| `codereview.prompt.md` | Kompleksowy code review brancha | "Wykonaj code review wg `.ai/prompts/codereview.prompt.md`" |
+| `security-review.prompt.md` | Audyt bezpieczenstwa (OWASP Top 10) | "Wykonaj security review wg `.ai/prompts/security-review.prompt.md`" |
+| `figma-analysis.prompt.md` | Analiza komponentu Figma (wymaga MCP Figma) | "Przeanalizuj ten komponent Figma wg promptu figma-analysis" |
+| `duplicate-code-analysis.prompt.md` | Wykrywanie duplikatow kodu | "Znajdz duplikaty wg `.ai/prompts/duplicate-code-analysis.prompt.md`" |
+
+### Uzycie w roznych narzedziach
+
+**Claude Code:**
+```
+Przeczytaj .ai/prompts/codereview.prompt.md i wykonaj review tego brancha
+```
+
+**GitHub Copilot Chat:**
+```
+@workspace Wykonaj code review zgodnie z .github/prompts/codereview.prompt.md
+```
+
+---
+
+## Serwery MCP
+
+MCP (Model Context Protocol) pozwala AI na komunikacje z zewnetrznymi systemami.
+
+| Serwer | Do czego | Wymaga tokena |
+|--------|----------|---------------|
+| **Jira Cloud** | Pobieranie ticketow do kontekstu AI | Tak |
+| **Bitbucket Cloud** | Integracja z repozytorium | Tak |
+| **Figma** | Analiza mockupow UI | Tak |
+| **Context7** | Dokumentacja bibliotek | Nie |
+
+### Gdzie wygenerowac tokeny
+
+| Serwis | Link |
+|--------|------|
+| Jira API Token | https://id.atlassian.com/manage-profile/security/api-tokens |
+| Bitbucket App Password | https://bitbucket.org/account/settings/app-passwords/ |
+| Figma Access Token | Figma → Settings → Personal access tokens |
+
+### Konfiguracja automatyczna
+
+Instalator automatycznie:
+- Zapisuje config do `.claude/settings.local.json` i `.cursor/mcp.json`
+- Rejestruje serwery w Claude CLI (`claude mcp add -s project`)
+- Weryfikacja: `claude mcp list`
+
+---
+
+## GSD (Get Shit Done)
+
+GSD to system do strukturyzacji pracy z AI — planowanie, wykonanie i weryfikacja w powtarzalnym procesie.
+
+### Dlaczego wymagany
+
+- Zapobiega **context rot** (degradacji jakosci AI po dlugiej sesji)
+- Strukturyzuje prace w fazy z checkpointami
+- Automatycznie mapuje codebase w istniejacych projektach
+
+### Instalacja
+
+```bash
+npx get-shit-done-cc@latest
+```
+
+### Kluczowe komendy
+
+| Komenda | Cel |
+|---------|-----|
+| `/gsd:new-project` | Inicjalizacja projektu |
+| `/gsd:plan-phase` | Planowanie fazy |
+| `/gsd:execute-phase` | Wykonanie |
+| `/gsd:verify-work` | Weryfikacja UAT |
+| `/gsd:progress` | Status i nastepne kroki |
+| `/gsd:debug` | Systematyczny debugging |
+| `/gsd:map-codebase` | Mapowanie istniejacego kodu |
+
+---
+
+## Struktura zainstalowanych plikow
+
+```
+projekt/
+├── .ai/
+│   ├── guidelines.md                 # Source of truth (header + wybrane pakiety)
+│   ├── instructions/                 # Kontekstowe instrukcje (applyTo)
+│   │   ├── vue.instructions.md
+│   │   └── ...
+│   ├── prompts/                      # Reusable prompty
+│   │   ├── codereview.prompt.md
+│   │   ├── security-review.prompt.md
+│   │   ├── figma-analysis.prompt.md
+│   │   └── duplicate-code-analysis.prompt.md
+│   ├── skills/                       # Workflow skille
+│   │   ├── debug/SKILL.md
+│   │   ├── refactor/SKILL.md
+│   │   ├── write-tests/SKILL.md
+│   │   ├── pr-prepare/SKILL.md
+│   │   ├── hotfix/SKILL.md
+│   │   ├── babysit-prs/SKILL.md
+│   │   ├── my-prs/SKILL.md
+│   │   ├── pr-dashboard/SKILL.md
+│   │   ├── fill-worklogs/SKILL.md
+│   │   ├── jira-task/SKILL.md
+│   │   └── [pack-specific]/SKILL.md
+│   └── context/                      # Kontekst projektowy
+│       └── README.md                 # (tu dodaj architecture.md, api-spec.md, etc.)
+├── .claude/
+│   └── settings.local.json           # Permissions (allow/deny) + MCP servers
+├── .github/
+│   ├── copilot-instructions.md       # Pointer → .ai/guidelines.md
+│   ├── pull_request_template.md      # Szablon PR
+│   ├── instructions/                 # Mirror z .ai/instructions/
+│   ├── prompts/                      # Mirror z .ai/prompts/
+│   └── skills/                       # Mirror z .ai/skills/
+├── .cursor/
+│   ├── rules/global.mdc              # Pointer → .ai/guidelines.md
+│   └── mcp.json                      # MCP servers
+├── .gemini/
+│   └── settings.json                 # Pointer → .ai/guidelines.md
+├── .junie/
+│   └── guidelines.md                 # Pointer → .ai/guidelines.md
+├── .editorconfig                     # Formatowanie (utf-8, lf, spaces)
+├── .gitignore                        # Pre-konfigurowany (AI tokeny, .env)
+├── CLAUDE.md                         # Claude Code entry point
+└── commit-instructions.md            # Commit conventions + branch naming
+```
+
+> **Mirror**: `.ai/instructions/`, `.ai/prompts/` i `.ai/skills/` sa automatycznie kopiowane do `.github/` jesli wybrany jest GitHub Copilot.
+
+---
+
+## Rozwoj pakietu
+
+### Dodanie nowego packa
+
+1. Utworz `templates/packs/nazwa-packa/`
+2. Dodaj `pack.json`:
+   ```json
+   {
+     "name": "Nazwa Packa",
+     "description": "Opis co zawiera",
+     "default": false,
+     "placeholders": {
+       "MY_PLACEHOLDER": {
+         "question": "Pytanie wyswietlane uzytkownikowi",
+         "default": "wartosc domyslna"
+       }
+     }
+   }
+   ```
+3. Dodaj instrukcje w `_ai/instructions/` (z frontmatter `applyTo`)
+4. Dodaj skille w `_ai/skills/`
+5. Opcjonalnie dodaj `_guidelines.md` — sekcja dolaczana do guidelines.md
+
+### Dodanie nowego skilla
+
+1. Utworz `templates/[base|packs/pack]/_ai/skills/nazwa/SKILL.md`
+2. Uzyj struktury: Trigger → Input → Steps → Verification checklist
+3. Uzywaj `{{PLACEHOLDER}}` dla wartosci zastepowanych podczas instalacji
+
+### Dostepne placeholdery
+
+| Placeholder | Opis |
+|-------------|------|
+| `{{PROJECT_NAME}}` | Nazwa projektu |
+| `{{PROJECT_DESCRIPTION}}` | Krotki opis projektu |
+| `{{TECH_STACK}}` | Tech stack (wolny tekst) |
+| `{{CI_COMMAND}}` | Komenda CI (wszystkie checki) |
+| `{{MODULE_PATH}}` | Sciezka do modulow |
+| `{{COMPONENT_LIB_PATH}}` | Sciezka do komponentow UI |
+| `{{COMPONENT_LIB_IMPORT}}` | Import komponentow |
+| `{{API_BASE_URL}}` | Bazowy URL API |
+| `{{TEST_COMMAND}}` | Komenda testow |
+| `{{BUILD_COMMAND}}` | Komenda builda |
+| `{{LINT_COMMAND}}` | Komenda lintera |
+| `{{DOCKER_CONTAINER}}` | Nazwa kontenera Docker |
+| `{{JIRA_PREFIX}}` | Prefix taskow JIRA |
+| `{{PLAYWRIGHT_DIR}}` | Katalog Playwright |
+| `{{BASE_URL}}` | Base URL aplikacji |
+
+### Struktura templates
+
+```
+templates/
+├── base/                        # Wspolne dla wszystkich pakietow
+│   ├── CLAUDE.md
+│   ├── commit-instructions.md
+│   ├── _gitignore               # → .gitignore
+│   ├── _editorconfig            # → .editorconfig
+│   ├── _ai/                     # → .ai/
+│   │   ├── _guidelines_header.md  # Naglowek guidelines
+│   │   ├── context/             # Kontekst projektowy
+│   │   ├── prompts/             # codereview, security-review, figma, duplicates
+│   │   └── skills/              # 10 skilli bazowych
+│   ├── _claude/                 # → .claude/ (permissions + deny)
+│   ├── _github/                 # → .github/ (copilot pointer + PR template)
+│   ├── _cursor/                 # → .cursor/
+│   ├── _gemini/                 # → .gemini/
+│   └── _junie/                  # → .junie/
+└── packs/
+    ├── vue3/                    # 6 instr. · 3 skille
+    │   ├── pack.json
+    │   ├── _guidelines.md       # Sekcja dolaczana do guidelines
+    │   └── _ai/instructions/
+    ├── vitest/                  # 1 instr.
+    ├── storybook/               # 1 instr.
+    ├── laravel/                 # 4 instr. · 7 skilli
+    ├── playwright/              # 1 instr. · 3 skille
+    └── docker/                  # 1 instr.
+```
+
+> Katalogi z prefixem `_` sa zamieniane na `.` podczas instalacji.
+> Katalogi per narzedzie (`_claude/`, `_github/`, etc.) sa kopiowane tylko jesli to narzedzie zostalo wybrane.
+
+---
+
+## Licencja
+
+MIT

package/bin/cli.mjs

@@ -0,0 +1,35 @@
+#!/usr/bin/env node
+
+import { fileURLToPath } from 'node:url';
+import { dirname, join } from 'node:path';
+import { askQuestions } from '../lib/questions.mjs';
+import { install } from '../lib/installer.mjs';
+import { box, boldCyan, boldMagenta, cyan, dim, red, yellow } from '../lib/ui.mjs';
+
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+const ROOT = join(__dirname, '..');
+
+console.log('');
+box([
+  boldMagenta('♫  SymfoniaAITools'),
+  '',
+  cyan('  Claude Code  ·  GitHub Copilot  ·  Cursor'),
+  cyan('  Gemini  ·  Junie  ·  GSD'),
+  '',
+  dim('  Jeden konfigurator — wszystkie agenty gotowe'),
+]);
+console.log('');
+
+try {
+  const packsDir = join(ROOT, 'templates', 'packs');
+  const answers = await askQuestions(packsDir);
+  await install(ROOT, answers);
+} catch (err) {
+  if (err.message === 'USER_ABORT') {
+    console.log(`\n  ${yellow('Przerwano.')}\n`);
+    process.exit(0);
+  }
+  console.error(`\n  ${red('Blad:')} ${err.message}\n`);
+  process.exit(1);
+}