Šablona záznamu

import { Aside } from ‘@astrojs/starlight/components’;

Každý bug = jeden .md soubor v src/content/docs/<kategorie>/. Frontmatter slouží člověku (badge, filtr) i stroji (JSON feed, llms.txt).

Kostra k zkopírování

---
title: Krátký výstižný název bugu
description: Jedna věta — symptom + root cause v kostce (jde do meta description i llms.txt).
category: frontend           # deploy|payments|auth|database|frontend|monitoring|integrations|performance|security|ai-agents
tags: [forms, validation, ux]
severity: medium             # low | medium | high | critical
status: resolved             # active | resolved | mitigated | wontfix
stack: [astro, vanilla-js]   # obecné technologie, ne verze konkrétního projektu
date: 2026-05-25
prevention: Jednou větou jak se tomu vyhnout (zobrazí se jako tip box nahoře).
---

import { Aside } from '@astrojs/starlight/components';

<Aside type="tip" title="Prevence">Sem zopakuj prevention větu.</Aside>

## Symptom
Co uživatel/vývojář vidí. 2–4 věty.

## Root cause
Technicky proč. Code snippet, ukázka URL/SQL/configu. ŽÁDNÁ citlivá data.

## Fix
Konkrétní řešení. Před/po snippet. Co se změnilo a proč to funguje.

## Jak se tomu vyvarovat v jiných systémech
- **Detection:** jak to najít preemptivně (grep pattern, code review otázka).
- **Anti-pattern:** jaký vzor v kódu na to ukazuje.
- **Lepší přístup:** co dělat místo toho.

## Sister bugs / související
Odkazy na související záznamy nebo popis příbuzných pastí.

Pole frontmatteru

Pole	Povinné	Hodnoty
`title`	ano	krátký název
`description`	ano	1 věta (SEO + llms.txt)
`category`	ano	jedna z 10 kategorií
`tags`	doporučeno	pole klíčových slov
`severity`	ano	low / medium / high / critical
`status`	ano	active / resolved / mitigated / wontfix
`stack`	doporučeno	obecné technologie
`date`	ano	YYYY-MM-DD
`prevention`	ano	1 věta prevence

Provozuje aiarchitekt.cz