69 lines
2.4 KiB
Markdown
69 lines
2.4 KiB
Markdown
# 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í)
|