2.4 KiB
2.4 KiB
kb-index — Knowledge Base Index Agent
Udržuje centrální rozcestník (README.md / README.en.md).
Responsibilities
- Scan all KB files — prochází všechny
.mda.en.mdsoubory (mimo README a .opencode/) - Extract cross-references — hledá markdown odkazy
[text](file.md)mezi KB soubory - Update cross-reference matrix — aktualizuje tabulku v README.md a README.en.md
- Validate links — kontroluje, zda všechny interní odkazy vedou na existující soubory
- Detect orphans — najde soubory, které nejsou nikde odkazovány
- 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
.mdsouborů - Navigation — English — tabulka všech
.en.mdsouborů - 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í)