ttg-marketplace/plugins/ttg-ops/skills/ttg-update-docs/SKILL.md

name, description, allowed-tools

name	description	allowed-tools
ttg-update-docs	After a change has been made, update every place that documents it — the README of the repo that changed, the wiki page in wiki-pages, and the public site in teletypegames (Vue page plus both locale files). Finds the affected documents from the actual diff rather than guessing. Use after finishing a change ("frissítsd a doksit", "update docs", "vezesd át a dokumentációba").	Bash, Read, Edit, Write, Grep, Glob

ttg-update-docs

Egy elvégzett módosítás átvezetése a dokumentációba. Három célpont van, és nem mindig mind a három érintett — a skill első fele annak a kiderítése, melyik.

1. Mi változott

Ne emlékezetből dolgozz. Nézd meg a tényleges diffet:

git -C <repo> status --short
git -C <repo> diff --stat HEAD
git -C <repo> log --oneline -10

Ha több repót érintett a munka, mindegyikre. Írd össze konkrétan: mi lett más a felhasználó szemszögéből — új parancs, megváltozott útvonal, új konfigkulcs, átnevezett dolog, megszűnt lépés. Ami csak belső refaktor, azt ne dokumentáld.

2. README — abban a repóban, ahol a változás történt

A legközelebbi és leggyakrabban elfelejtett célpont. Nézd át:

• Telepítési és használati parancsok — ha útvonal vagy parancsnév változott, itt is változik.
• Konfigurációs táblázatok — új vagy átnevezett kulcs.
• Könyvtárszerkezet-ábrák.
• Repo-URL-ek, ha a repo költözött.

Ha a változás egy mintát érint, ami több repóban ismétlődik (pl. egy build/*-tools sablon vagy egy store-minta), nézd meg a testvéreket is — a minta és a példány ne csússzon szét.

3. Wiki — a wiki-pages repo

A wiki Grav CMS, a tartalom services/wiki-pages/pages/<útvonal>/default.md (a repo neve wiki-pages, a workspace-ben a services/ alatt). Az oldal nem CMS-ben, hanem fájlban él, tehát szerkeszthető.

Melyik oldal tartozik a repóhoz: a devarea/WIKI_CONNECTION.md táblázata mondja meg (Folder → Wiki file). Ha nincs benne, vagy grep -rl "<repo>" wiki-pages/pages/.

Amire figyelj:

• Frontmatter. A repo: mező URL-je is elavulhat. Az id egyedi legyen (grep -rh "^id:" pages/ | sort | uniq -d).
• Mindkét irány. Ha egy oldal átnevezésre vagy kettévágásra kerül, a config/sitenav.yaml bejegyzését is vezesd át, és a másik két célpontban lévő wiki-linkeket is (a publikus oldal CONFIG.wikiBase-re épülő URL-jét is beleértve).
• Nem csak pages/. A wiki-pages repóban van README.md, bbs/ (Gemfile is!), fetcher/ — ezekben is lehet érintett hivatkozás.
• Oldal áthelyezésekor vedd fel a config/site.yaml redirects: térképébe a régi útvonalat, hogy a kimenő linkek és a könyvjelzők ne törjenek el.
• Commit-konvenció. A wiki-pages repónak saját git-commit skillje van, és a konvenciója szerint nem kerül trailer az üzenetbe (se Co-Authored-By, se generált aláírás). Kövesd.

4. Publikus oldal — a teletypegames repo

A publikus oldal Vue 3 SPA, nem CMS. A tartalom három helyen van, és mindhármat együtt kell módosítani:

Mi	Hol
oldalszerkezet, linkek, kódrészletek	apps/frontend/src/page/<szekció>/<Név>Page.vue
minden megjelenő szöveg	apps/frontend/src/i18n/locales/en.ts és hu.ts
útvonal	apps/frontend/src/router/<szekció>.router.ts

A szövegek nem a .vue-ban vannak, hanem a locale fájlokban, t('szekció.kulcs') hivatkozással. Új szöveghez új kulcs kell mindkét nyelvben, azonos szerkezetben. Az en a fallback.

Ami tipikusan a .vue-ban marad hardkódolva, és ezért elavul: repo-URL-ek, telepítő egysorosok, CLI-részletek, külső linkek.

Ellenőrzés — ezt ne hagyd ki:

cd apps/frontend
npm run build      # vue-tsc típusellenőrzés + vite build
npm run lint
npm test

A lintben és a tesztekben lehetnek korábbról meglévő figyelmeztetések/hibák; ha ilyet látsz, git stash-sel ellenőrizd, hogy a te változtatásod okozta-e, és mondd meg a felhasználónak, melyik volt már ott.

5. Ami a három célponton kívül esik

Ha a változás a repo-állományt vagy az ökoszisztéma állapotát érinti, ezek is naplót kérnek:

• devarea/scripts/repos.list és devarea/WIKI_CONNECTION.md — új, átnevezett vagy áthelyezett repo.
• devarea/REPO_REFACT.md — org-struktúra változás.
• devarea/ECOSYSTEM_PLAN.md — ha egy hiányosság megszűnt vagy egy javasolt lépés elkészült, a státuszát vezesd át.

6. Zárás

Repónként külön commit, mindegyik a saját konvenciója szerint. A végén foglald össze a felhasználónak repónként, mi változott és mi maradt szándékosan érintetlenül — és ha valamit nem tudtál ellenőrizni (pl. böngészőben renderelni), azt mondd ki, ne hallgasd el.