Библиотека · BG

Библиотеката за Gemini

BGENES · FR · DE — скоро

v0.1 · 2026-10-19 · от Better Mechanics · ниво: общност (текст, без протокол от проверка)

Бележките за проверка на Claude са маркирани с [проверка].

1 · Какво чете Gemini

GEMINI.md (проектни конвенции [правила за стандартизация]) · AGENTS.md (споделен стандарт за multi-agent [многоагентни системи]) · системната инструкция · .cursorrules / .windsurfrules [проверка: твърдението на Gemini; не е потвърдено дали той анализира тези файлове].

2 · Шаблони за промптове (prompt patterns), които работят с Gemini

Разграничени блокове (Delimited blocks): <role_definition>, <context>, <technical_constraints>, <expected_output>.
Строги негативни ограничения (Strict negative constraints): „НЕ използвайте произволни стойности на Tailwind (напр. w-[243px]); използвайте токени.“ „НЕ добавяйте описателен текст (prose) около кода.“
Договори за схема / тип (Schema / type contracts) за изхода (TypeScript interface или JSON Schema).
Самопроверка преди извеждане: оценка спрямо контролен списък (контраст, 320 px overflow) преди генериране на кода. [проверка: самопроверката не е доказателство — рецептата все още изпълнява реалните инструменти.]

3 · Слабости и предпазни мерки

Слабост	Как изглежда	Предпазна мярка
Смесване на Tailwind v3/v4	`@tailwind base` до `@import "tailwindcss"`	посочете точната версия на Tailwind в договора на промпта (prompt contract)
Синдром на генеричен шаблон	центрирани заоблени карти, лилави/индигови акценти, сиви рамки	строг списък с бранд токени (brand tokens - дефинирани стилови променливи, напр. монохромни, рамки 3 px, radius 0)
Препълване (Overflow) при 320 px	фиксирана ширина, таблици без пречупване	`max-width:100%`, `minmax(min(…,100%),1fr)` + Playwright assertion (проверка за съответствие)
Най-новият CSS без fallback (резервен вариант)	`@starting-style`, `popover` без fallback	посочете целевите браузъри; изисквайте `@supports` fallbacks
Скок в кирилските метрики	шрифтове без кирилица → скок при fallback	`unicode-range` + fallback метрики (`size-adjust`, `ascent-override`); и проверена българска `locl` (локализация) във файла
[проверка] Прекалено уверени числа и правни твърдения	измислени бюджети (напр. "LCP < 1.8 s"), грешни препратки към закони (Impressum, приписан на TDDDG/TMG вместо на DDG § 5)	всяко число и закон в Gemini рецепта се проверяват спрямо източника преди публикуване

4 · Инструменти, с които работи Gemini

Vite (MIT) · Biome (MIT/Apache-2.0) · Playwright (Apache-2.0) · axe-core CLI (интерфейс за команден ред [CLI - Command Line Interface]; MPL-2.0) · Lighthouse CLI (Apache-2.0) · Stylelint (MIT) · Tailwind CLI (MIT). [проверка: лицензи, както са посочени от Gemini; проверете в хранилищата [repos], преди да ги отбележите като GREEN.]

5 · Първите 10 рецепти (заглавия на Gemini)

gemini-core-brutalist-tokens — монохромни токени (дизайн променливи) с нулев радиус и OKLCH alert цветове
gemini-cyrillic-latin-font-stack — вариативен шрифт с двойно писмено (кирилица и латиница), без изместване на макета при липса на поддръжка (fallback layout shift)
gemini-320px-unbreakable-grid — мрежа (grid), която преминава проверката за препълване (overflow assertion) при 320 px
gemini-apca-accessible-data-table — гъста таблица с данни с навигация чрез клавиатура
gemini-wcag-aaa-dialog-primitive — модален прозорец с възстановяване на фокуса, клавиш Escape и backdrop (затъмняване на фона)
gemini-perf-inp-form — многостъпкова форма без дълги задачи (long tasks)
gemini-schema-org-software-graph — JSON-LD, който свързва спецификация, автор и код
gemini-tailwind-v4-clean-migration — миграция от v3 към v4 чрез @theme
gemini-strict-csp-nginx-config — CSP (Content Security Policy) с nonces (еднократни идентификатори)
gemini-playwright-auto-qa-pipeline — axe + 320 px + LCP (Largest Contentful Paint) бюджет в CI (Continuous Integration)

[проверка] Целите "AAA" и "APCA" са амбицията на Gemini; нашият стандарт е WCAG 2.2 AA, освен ако в дадена рецепта не е посочено друго.