Software Development Skills

Konvence pro psaní a editaci článků v Astro monorepu orlojWeb (hodinarium-eu, horologie-cz). Aktivuje se při editaci .md/.mdx v content/hodinarium-eu/ nebo content/horologie-cz/, při tvorbě/úpravě komponent v apps//src/components/, při psaní frontmatteru (perex/tldr, author, references), při vkládání obrázků s creditem, při formátování odkazů (wiki, mapy, PDF), při řešení layoutu článku (hero, float images, mezititulky, single ) a při kontrole deploymentu na Cloudflare Pages.

Pravidla pro pole tldr (perex / krátké shrnutí) ve frontmatteru článků hodinarium-eu. Aktivuje se při tvorbě nebo úpravě tldr: v content/hodinarium-eu/.{md,mdx} a content/kroky/.{md,mdx}, při auto-importu legacy textů, při SEO review (meta description, Twitter Card, Google snippet), při code review článků. Pravidla: (1) tldr doplňuje titulek, neopakuje ho; (2) 1–2 věty, max ~200 znaků; (3) aktivní hlas, konkrétní fakta; (4) nikdy „Stručně:", „V tomto článku", „Tento článek pojednává"; (5) nikdy utnuté výpustkou „..."; (6) bez markdown formátování (renderuje se i jako meta description); (7) nekončí pouhým názvem předmětu/místa, který je už v titulku; (8) aplikuj skill cestina na výstup (správná čeština, žádné AI tells, česká typografie). Skript node scripts/audit-tldr.mjs flagne porušení.

Konvence pro psaní a editaci stránek v Astro projektu horologie-cz (web Českého spolku horologického, sesterský k hodinarium-eu). Aktivuje se při editaci .astro v apps/horologie-cz/src/pages/, při tvorbě/úpravě komponent v apps/horologie-cz/src/components/, při psaní akce/spolky/dokumenty data v src/data/, při řešení layoutu (logo, brand, perex full-width, akce mapa, /akce/[slug] detaily), při favicon/manifest úpravách, při odkazech na hodinarium-eu nebo orloj.eu sister sites.

Konvence pro tvorbu schematických SVG animací hodinových kroků (escapements) v rubrice /kroky/ na hodinarium-eu. Aktivuje se při zakládání nové animace pro některý z 25+ kroků v apps/hodinarium-eu/public/img/kroky/ -animace.svg, při úpravě existující animace, při řešení vizuální nebo didaktické konzistence napříč pilotů (Graham, Robert, kotvový, vretenový, magnetický, atd.), při debug Chrome cache/rendering, nebo když uživatel chce další krok ve stejném stylu jako Graham pilot. Triggery: "animace kroku", "SVG pro krok X", "udělej Robert/kotvový/vretenový krok animovaně", "nová karta krok v /kroky/", "stejný styl jako Graham". Pokrývá: barevnou paletu, geometrii (viewBox, pivot, helper arcs), SMIL animace (tick, oscillation, palet highlight, fázový text), Photo komponentu embed přes , cache-bust query, speed control v article template, atribuci PD/CC, didaktické fáze lock/release/impulse/drop podle Airy 1826.

Pravidla pro zobrazování obrázků, fotek, diagramů, skenů a galerií v Astro monorepu orlojWeb (hodinarium-eu, horologie-cz). Aktivuje se při vkládání obrázků do .md/.mdx článků, při tvorbě nové komponenty pracující s obrázky, při řešení atribuce/copyrightu/licence fotek, při tvorbě galerií nebo fotoreportů, při work with foto[] pole v frontmatteru sbírky/soupisu/medailonů, při řešení lightboxu/zoom/náhledů, při migraci obrázků (R2, formáty AVIF/WebP), při psaní alt textů pro a11y. Pokrývá: výběr způsobu vložení (markdown vs direktiva vs schema), atribuci dle licencí (NPÚ CC BY-NC-ND, Wikimedia CC BY-SA, vlastní), build pipeline imgindex:build + imgvariants:build, Photo.astro komponentu + ::photo direktivu, Highslide phase-out, R2 plán.