add-index

name	add-index
description	Rejestruje nową grę: dodaje kartę do index.html, wpis do README.md, aktualizuje status.md, wstawia back-link. Użyj gdy folder gry istnieje i trzeba go dopisać do menu.

Jesteś orkiestratorem rejestrowania nowej gry w projekcie twoznia/gry.

Folder gry już istnieje — Twoim zadaniem jest dopilnowanie, żeby gra pojawiła się w głównym menu (index.html), dokumentacji (README.md) i pliku statusu (status.md), oraz żeby miała standardowy przycisk powrotu.

Dane wejściowe

Użytkownik może podać:

• nazwę folderu gry (np. koloruj, moja-gra)
• albo nic — wtedy sam wykryj grę, której jeszcze nie ma w index.html

Krok 1 — Ustal, której gry dotyczy zadanie

Jeśli użytkownik podał nazwę folderu, użyj jej.

Jeśli nie podał, wywołaj skill detect-root-games, żeby uzyskać pełną listę folderów z index.html, a następnie porównaj ją z kartami w głównym index.html — szukasz folderu, który istnieje na dysku, ale nie ma jeszcze karty w <main class="game-container">.

Jeśli jest więcej niż jedna taka gra, zapytaj użytkownika, którą chce zarejestrować.

Krok 2 — Wyciągnij metadane gry

Wywołaj skill extract-game-metadata dla tego folderu.

Skill odczyta tytuł, emoji/ikonę i krótki opis z pliku <folder>/index.html.

Jeśli opis jest niedostępny lub zbyt techniczny, przeczytaj <folder>/index.html samodzielnie i zaproponuj krótki opis po polsku (1–2 zdania), który dobrze brzmi jako podpis karty w menu. Opis powinien opisywać, co robi gracz — nie co robi kod.

Ikona to emoji; jeśli gra jej nie ma, dobierz trafne na podstawie tematyki gry.

Krok 3 — Wstaw kartę do głównego index.html

Wywołaj skill sync-root-index-cards z metadanymi tej gry.

Karta zostanie dodana na końcu <main class="game-container"> w formacie:

<a href="./<folder>/" class="game-card">
    <span class="icon">🎮</span>
    <h2>Nazwa Gry</h2>
    <p style="color: #94a3b8; font-size: 0.9rem;">Krótki opis.</p>
    <div class="play-btn">Zagraj</div>
</a>

Krok 4 — Dodaj wpis do README.md

Wywołaj skill sync-root-readme-contents z tymi samymi metadanymi.

Wpis trafi do sekcji ## Zawartość w formacie:

- **[Nazwa Gry](./<folder>/)** 🎮 – Krótki opis.

Krok 5 — Dodaj przycisk ← Wróć

Wywołaj skill add-game-back-link dla tego folderu.

Skill sprawdzi, czy <a class="back-link" href="../">← Wróć</a> już istnieje i doda go jeśli brakuje, albo ujednolici istniejący wariant.

Krok 6 — Zaktualizuj status.md

Wywołaj skill sync-games-status-file z wynikiem z kroku 5 (czy back-link był już obecny, został dodany, czy ujednolicony).

Wynik dla użytkownika

Na końcu zgłoś krótkie podsumowanie:

• nazwa zarejestrowanej gry i jej folder
• czy karta była nowa czy zaktualizowana
• czy wpis w README był nowy czy zaktualizowany
• status back-link (obecny / dodany / ujednolicony)

Nie opisuj szczegółów technicznych kodu — wystarczy jednoliniowe potwierdzenie każdego kroku.