agentleFS
adrian-wulfadrian-wulf/vorarbeiter-gamedev/.claude/skills/kickoff/SKILL.md

kickoff

Skill0 starsChanged 50 days agoMITView on GitHub

Start nowej gry — prowadzi wywiad z użytkownikiem (pomysł, pierwsze 5 minut gracza, silnik Godot/Unity) i tworzy komplet dokumentów projektu jeden po drugim (AGENTS, GDD, ARCHITECTURE, ROADMAP, CODING_STYLE, ART_STYLE, GLOSSARY, DECISIONS, SYSTEMS), a na końcu konfiguruje wykonawcę. Używaj, gdy użytkownik wpisze /kickoff, chce zacząć nowy projekt gry albo AGENTS.md ma jeszcze placeholdery {{…}}. Wznawialny.

36 other projects use a version of this, 1 of them edited.

Adopted by

Most recently taken up by

Used with

Projects with it also use standup, grill and 7 more.

Other files people use alongside this one.

Files found in the same public projects as a version of this one, more often than they turn up anywhere else. Each project counts once, large collections count for less, and this file's own repository is left out.
  • AnthropicSkill

    standup

    Generate a standup update from recent activity. Use when preparing for daily standup, summarizing yesterday's commits and PRs and ticket moves, formatting work into yesterday/today/blockers, or structuring a few rough notes into a shareable update.

    Also in 4 projects that use this

  • renatorozasSkill

    grill

    Adversarial code review. Don't let me ship until the changes pass your scrutiny.

    Also in 4 projects that use this

  • JeffallanSkill

    prompt-engineer

    Writes, refactors, and evaluates prompts for LLMs — generating optimized prompt templates, structured output schemas, evaluation rubrics, and test suites. Use when designing prompts for new LLM applications, refactoring existing prompts for better accuracy or token efficiency, implementing chain-of-thought or few-shot learning, creating system prompts with personas and guardrails, building JSON/function-calling schemas, or developing prompt evaluation frameworks to measure and improve model performance.

    Also in 3 projects that use this

  • MicrosoftSkill

    handoff

    Compact the current conversation into a handoff document for another agent to pick up.

    Also in 7 projects that use this

  • AnthropicSkill

    status

    Case status summary by audience — client-facing (plain language), internal (for the professor), or court-ready (formal caption format per local rules). Same facts, different framing and depth. Use when a student needs to update the client, brief the professor, or prepare a court status report.

    Also in 3 projects that use this

  • SentrySkill

    review

    Fixture review skill.

    Also in 5 projects that use this

The file

Files
SKILL.md

/kickoff — od pomysłu do kompletu dokumentów

Prowadzisz rozmowę jak doświadczony game designer i tech lead w jednym. Cel: dokumenty, dzięki którym wykonawca (agy) może budować grę bez zgadywania, a Ty możesz go nadzorować. Dokumenty to jedyna pamięć projektu między sesjami — piszesz je dla agenta LLM, nie dla prezentacji.

Zasady rozmowy (obowiązują w KAŻDEJ fazie)

  1. Pytania zadajesz narzędziem AskUserQuestion — w paczkach po 2–3 pytania, każde z 2–4 opcjami jednokrotnego wyboru. (Jeśli narzędzie jest niedostępne — zadaj te same pytania tekstem z opcjami A/B/C/D.)
  2. Ostatnia opcja każdego pytania to zawsze „Nie wiem, zaproponuj”. Użytkownik nie musi znać odpowiedzi — Ty jesteś ekspertem.
  3. Przy „Nie wiem, zaproponuj”: podajesz jedną rekomendację + 1–2 zdania uzasadnienia (dlaczego pasuje do TEJ gry, jej filarów i grupy docelowej) i od razu dopisujesz wpis do DECISIONS.md:
    **Decyzja:** …
    **Uzasadnienie:** …
    **Odrzucone alternatywy:** …
    Tak samo zapisujesz każdą istotną decyzję użytkownika.
  4. Bramka przed każdym dokumentem — AskUserQuestion: „Mam komplet do <X>.md?” → opcje „Tak, pisz” / „Jeszcze doprecyzujmy”. Przy „doprecyzujmy” zadajesz kolejną paczkę pytań i wracasz do bramki.
  5. Po zapisaniu dokumentu: 3–5 zdań podsumowania najważniejszych ustaleń
    • pytanie „Kontynuować do <Y>.md?”. Aktualizujesz ## Kickoff w ORCHESTRATION_STATE.md i tabelę statusu w AGENTS.md. 5a. Po każdej paczce odpowiedzi dopisujesz ustalenia (jedna linia na ustalenie) do ### Ustalenia pod ## Kickoff w ORCHESTRATION_STATE.md — także w fazach 1–3, zanim powstanie jakikolwiek dokument. To jedyne, co ratuje rozmowę przerwaną w połowie.
  6. Jeden dokument naraz. Nie piszesz kilku dokumentów w jednej turze.
  7. Dokumenty tworzysz z szablonów w docs-templates/ (CODING_STYLE — z profilu silnika). Zastępujesz wszystkie {{…}} i usuwasz komentarze <!-- kickoff: … -->. Sekcja, do której nie ma danych, trafia do „Otwarte pytania / do ustalenia później” — nigdy nie zostaje pusta.
  8. Pytaj o to, co zmienia grę, nie o oczywistości. Jeśli odpowiedź wynika z wcześniejszych ustaleń — nie pytaj, zapisz.
  9. Rozmawiasz po polsku, konkretnie, bez lania wody.

Start

Najpierw sprawdź command -v jq — bez jq hook ochronny blokuje każdą edycję; poproś wtedy o instalację jq, zanim zaczniesz. Następnie utwórz DECISIONS.md z docs-templates/DECISIONS.md (zostaw tylko nagłówek i wstęp) — wpisy decyzji dopisujesz w nim od pierwszej paczki pytań.

Wznawianie

Na starcie przeczytaj ## Kickoff (w tym ### Ustalenia) w ORCHESTRATION_STATE.md. Jeśli faza lub któryś dokument są już zrobione — powiedz krótko, na czym skończyliście, i kontynuuj od pierwszego ⬜. Nie powtarzaj pytań, na które są już odpowiedzi w dokumentach.

Faza 1 — Pomysł

  1. Zapytaj (paczka): jakie gry lubi / czym inspiracja (gatunki, tytuły), dla kogo gra (np. streamerzy/let's play, casual, hardcore), jaki ton (poważny, komediowy, memiczny, mroczny…), czy ma już temat.
  2. Jeśli nie ma tematu: zaproponuj 4–6 konceptów. Dla każdego: nazwa robocza, 2–3 zdania o co chodzi, co w nim świeżego (czego jeszcze nie było), dlaczego zadziała dla tej grupy docelowej, jaki jest rdzeń pętli. Zapytaj o wybór — z opcją „Żaden — szukajmy dalej” (wtedy nowa runda w innym kierunku, dopytaj, co nie pasowało).
  3. Ustal zakres: tryby gry (np. z celem / sandbox), singleplayer/co-op, platforma docelowa.

Faza 2 — Pierwsze 5 minut gracza

Opisz minuta po minucie, jak wygląda start nowego gracza (co widzi, co robi, czego się uczy, co go ma „złapać”), plus kamera/widok i sterowanie. To test, czy koncept „klika”. Zapytaj, co zmienić. Ten opis trafi do GDD.md (sekcja „Pierwsze 5 minut”).

Faza 3 — Silnik

Paczka pytań: silnik (Godot / Unity / „Nie wiem, zaproponuj”), język (Godot: GDScript/C#; Unity: C#), wersja (najnowsza stabilna / LTS), 2D czy 3D. Rekomendując, bierz pod uwagę: typ gry, doświadczenie użytkownika, darmowość, wsparcie MCP dla agenta, wielkość projektu.

Po wyborze silnika <s> (godot albo unity):

cp profiles/<s>/verify.sh executor/verify.sh && chmod +x executor/verify.sh
cp profiles/<s>/rules.md executor/rules.profile.md
cat profiles/<s>/gitignore >> .gitignore
cat profiles/<s>/gitattributes >> .gitattributes

profiles/<s>/CODING_STYLE.md będzie szablonem CODING_STYLE. profiles/<s>/SETUP.md i profiles/<s>/ui-check.md wykorzystasz w fazie 5 i w ARCHITECTURE.md. Profil drugiego silnika zostanie usunięty na końcu.

Faza 4 — Dokumenty (po kolei)

DECISIONS.md już istnieje (założony na starcie, z wpisami z faz 1–3). Kolejność pozostałych:

#DokumentSzablonO co pytać (przykłady)
1AGENTS.mdten w roociewypełnij placeholdery z faz 1–3
2GDD.mddocs-templates/GDD.mdfilary, pętla, warunki wygranej/porażki, progresja, meta, zagrożenia, mapa (proceduralna/ręczna), śmierć/permadeath, poziom złożoności MVP
3ARCHITECTURE.mddocs-templates/ARCHITECTURE.mdstruktura folderów, dane (Resources/ScriptableObject/JSON), save/load, stały tick czy klatka, grid czy swobodnie, komunikacja systemów (sygnały/event bus), encje (węzły/komponenty), AI, testy
4ROADMAP.mddocs-templates/ROADMAP.mdco jest M0 (najmniejsza grywalna pętla), kolejność kolejnych, czy daty (domyślnie nie), co świadomie poza MVP
5CODING_STYLE.mdprofiles/<s>/CODING_STYLE.mdtypizacja, nazewnictwo, komentarze/docstringi, testy
6ART_STYLE.mddocs-templates/ART_STYLE.mdskąd assety (licencje!), rozmiar kafli/perspektywa, paleta, nazewnictwo plików, kierunek audio
7GLOSSARY.mddocs-templates/GLOSSARY.mdkonwencja językowa, nazwy własne mechanik, zasobów, jednostek, UI
8SYSTEMS/README.mddocs-templates/SYSTEMS_README.mdnic — tylko utwórz; pliki systemów powstają przy pracy nad nimi

W ARCHITECTURE.md sekcja „Jak uruchomić / testować” musi zawierać dokładne komendy (uruchomienie gry, pojedynczy test, wszystkie testy = bash executor/verify.sh), a sekcja „Środowisko agenta” — najważniejsze informacje z profiles/<s>/SETUP.md i profiles/<s>/ui-check.md (bo profile zostaną usunięte).

Faza 5 — Setup wykonawcy

  1. Pokaż użytkownikowi kroki z profiles/<s>/SETUP.md (MCP silnika dla wykonawcy, skille dla agy). Te, które wymagają jego terminala lub logowania — poproś, żeby wykonał je sam (! <komenda> w Claude Code).
  2. bash executor/preflight.sh — wynik wpisz do ## Wykonawca w ORCHESTRATION_STATE.md (wykonawca, wersja, model, data). Jeśli NIEGOTOWE — powiedz dokładnie, co naprawić, i poczekaj.
  3. Licencja projektu — zapytaj (AskUserQuestion): „Na jakiej licencji ma być projekt?” → „Zamknięty (bez licencji)” / „MIT na moje nazwisko” / „Inna — podam”. LICENSE szablonu dotyczy szablonu, nie gry.
  4. Sprzątanie szablonu (pliki szablonu nie mogą zostać w projekcie):
    git rm -r -q profiles/ docs-templates/ tests/ README.en.md LICENSE
    • README.md zastąp krótkim README projektu (tytuł, pitch z GDD, jak uruchomić z ARCHITECTURE, stopka „Projekt prowadzony metodą Vorarbeiter — Claude Code nadzoruje, agy koduje” z linkiem do szablonu). Bez odznak wsparcia, Impressum i danych autora szablonu.
    • LICENSE — nowy wg odpowiedzi z kroku 3 (albo brak pliku).
    • NOTICE zostaje (atrybucja skilla antigravity-agents).
  5. Commit: docs: kickoff — komplet dokumentów projektu.
  6. Ustaw ## Kickoff → „Faza: zakończony”. Uprzedź, że executor/verify.sh jest czerwony, dopóki w projekcie nie ma pierwszego testu — pierwsze zadanie M0 musi go dodać. Zaproponuj /plan-milestone dla M0.

Download now (ZIP)

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

No reviews yet

People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.

  • It worked
  • Partly
  • It didn't
What did you use it for? e.g. Reviewing pull requests in a Rails app

Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.