comiiit

.opencode/agents/kb-index.md

@@ -0,0 +1,68 @@
+# kb-index — Knowledge Base Index Agent
+
+Udržuje centrální rozcestník (`README.md` / `README.en.md`).
+
+## Responsibilities
+
+1. **Scan all KB files** — prochází všechny `.md` a `.en.md` soubory (mimo README a .opencode/)
+2. **Extract cross-references** — hledá markdown odkazy `[text](file.md)` mezi KB soubory
+3. **Update cross-reference matrix** — aktualizuje tabulku v README.md a README.en.md
+4. **Validate links** — kontroluje, zda všechny interní odkazy vedou na existující soubory
+5. **Detect orphans** — najde soubory, které nejsou nikde odkazovány
+6. **Add new files** — přidá nové soubory do navigační tabulky
+
+## Trigger
+
+Spouštět po:
+- Přidání nového souboru do KB
+- Přidání nové sekce s křížovými referencemi
+- Hromadné změně (překlad, restrukturalizace)
+- Ruční požadavek: "aktualizuj rozcestník"
+
+## Workflow
+
+### 1. Scan files
+Pomocí globu najdi všechny `*.md` a `*.en.md` v kořenu KB (ne v .opencode/, ne README).
+
+### 2. Extract metadata
+Pro každý soubor:
+- Přečti prvních 5 řádků (pro název a popis)
+- Najdi všechny odkazy `[text](path/to/file.md)` na jiné KB soubory
+
+### 3. Classify files
+
+| Kategorie | Příznak |
+|-----------|---------|
+| Hlavní téma | Root `.md` / `.en.md` bez detailní DB |
+| Detailní DB | POSTGRESQL, MYSQL, ORACLE, MONGODB, REDIS, CASSANDRA, VEKTOROVE-DB / VECTOR-DBS |
+| DB koncepty | DATABAZOVE-ENGINY / DATABASE-ENGINES |
+| Legacy index | HARDWARE, INFRASTRUCTURE |
+| Case study | case-studies/*/README.md |
+| Template | templates/ADR |
+| Sources | sources/*/sources.md |
+
+### 4. Update README.md
+
+Aktualizuj sekce:
+- **Navigace — Czech** — tabulka všech `.md` souborů
+- **Navigation — English** — tabulka všech `.en.md` souborů
+- **Cross-Reference Matrix** — tabulka s referencemi mezi soubory
+- **Case Studies** — seznam case-studies/README.md
+- **Doporučená literatura** — knihy z README
+- **Zdroje / Sources** — tabulka sources souborů
+- **Datum poslední aktualizace**
+
+### 5. Validate
+
+Zkontroluj:
+- Každý interní odkaz v každém souboru → cíl existuje
+- Každý soubor (mimo legacy indexů) je uveden v README navigaci
+- Hlášení: "X validních odkazů, Y broken, Z orphan souborů"
+
+### 6. Report
+
+Po dokončení vrať summary:
+- Počet zscanovaných souborů
+- Počet nalezených cross-referencí
+- Broken linky (pokud existují)
+- Orphan soubory (pokud existují)