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

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

BGENES · FR · DE — скоро

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

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

AGENTS.md, открит чрез scope [обхват на търсене]; поддържа се и AGENTS.override.md, като по-специфичните инструкции имат предимство пред по-общите. Не се предполага, че CLAUDE.md / GEMINI.md се зареждат автоматично — препращайте към тях изрично. (Източник, цитиран от Codex: документация за конфигурация на агенти на OpenAI.)
Skills [умения] — SKILL.md с опционални скриптове, референции и активи; поддържайте всеки от тях фокусиран.
Референтни активи: представителни екрани, реално съдържание, tokens [токени], състояния на компоненти, примери за неприемливи резултати.
Изпълними проверки: собствените команди и fixtures [фиксирани данни за тестване] на проекта, с очаквани резултати.

Дефинирайте споделените стандарти веднъж; публикувайте леки адаптери за всеки агент; тествайте всеки адаптер отделно.

2 · Шаблон за промпт (Prompt pattern)

Внедрете [резултат] за [аудитория] в това хранилище (repository). Първо разгледайте съществуващите компоненти и приложимите инструкции. Следвайте [референция], запазвайки [специфични визуални характеристики]. Използвайте [истинско съдържание и материали]; идентифицирайте липсващите входни данни. Включете [състояния на взаимодействие и локализации]. Критерии за приемане: [наблюдаемо поведение и бюджети на проекта]. Изпълнете съответните проверки и разгледайте рендираните (rendered) страници. Предайте промяната, доказателствата и оставащите ограничения.

Кратки цикли за преглед: посока → една представителна страница → проверка на рендирането → разширяване. Дайте причина за всяко ограничение.

3 · Рискове и предпазни мерки

Риск	Предпазна мярка
Общи, повтарящи се визуални елементи	конкретни референции, йерархия на съдържанието, изрични визуални характеристики
Правдоподобен код, лош вид в браузъра	изисква се инспекция в браузъра + скрийншоти
Липсващи състояния на взаимодействие (interaction states)	инвентаризация на състоянията + пътека чрез клавиатура
Измислени API / зависимости	проверка на инсталираните версии; официална документация
Излишни пренаписвания	идентифициране на съществуващи модели; ограничаване на обхвата
Разрушаване на английския лейаут (layout - подредба на елементите) при превод	реални мултиезични фикстури + скрийншоти за съответната локация
Автоматичното преминаване се приема за пълно доказателство	записване на ръчната проверка и непроверените условия
Твърдения за проверки, които не са пуснати	прикачване на реални резултати; маркиране на недостъпните проверки
Следване на инструкции вътре в извлеченото съдържание	външното съдържание е данни; преглед на изпълнимите стъпки
Загуба на ограничения при дълги задачи	кратки, устойчиви инструкции; версии на критериите за приемане

Без достъп до браузър визуалното качество е непроверено. Codex не може да установи подобрение в конверсията или съответствие с правните изисквания само чрез кода.

4 · Инструменти

Playwright (Apache-2.0) · axe-core (MPL-2.0) · Lighthouse (Apache-2.0) · собствените команди на хранилището за build (сглобяване), lint (проверка на стила на кода), type-check (проверка на типовете) и test (тестване). Декларирайте изискванията; не предполагайте, че браузър или конектор (connector) са налични.

5 · Първите 10 рецепти

Превърнете заданието за сайт в критерии за приемане, които могат да се проверят
Създайте българско-английска типографска система с визуализирана проверка
Постигнете визуалната референция с компонентите, които вече са в хранилището
Създайте semantic tokens (семантични токени) и проверете двете теми
Внедрете навигация с тестове за клавиатура и focus (фокус на елемента)
Създайте форми с валидация, състояния на грешка, повторен опит и успех
Публикувайте пет езикови версии с проверки за актуалност на превода
Диагностицирайте регресии в производителността (performance regressions) с записани доказателства
Добавете аналитика, съобразяваща съгласието (consent-aware analytics), и инспектирайте мрежовото поведение
Опаковайте промяна в уебсайта със скриншоти, резултати от тестове и ограничения