28df42cbee
Rozstrzygniecie 5: katalogi z kodem, ktore nie mialy README, dostaja stub (frontmatter + stub: true + opis jednozdaniowy). NIE pisana pelna dokumentacja. kb/services/: control-plane, node-agent, brain-watchdog, node-exporter, job-gmail-bulk-import, pkg-kb-mail, pkg-kb-retrieval. Kazdy stub podaje zrodlo opisu (service.yaml / docstring / CLAUDE.md / pyproject.toml). Dla gmail-bulk-import i kb-retrieval zrodla brak — stub mowi o tym wprost zamiast zmyslac opis. Dodatkowo kb/subsystems/repo-operating-contract.md — wskaznik na CLAUDE.md (rozstrzygniecie 4). CLAUDE.md zostaje w korzeniu jako zywa konfiguracja narzedzia; kb-doc niesie pole contradicts: brak katalogow services/joplin, services/outline, services/ai-cluster deklarowanych w sekcji "Repo-managed services on VPS". Kontekst PR2 feat/vps-service-migration, swiadomie nienaprawiane. Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
35 lines
1.3 KiB
Markdown
35 lines
1.3 KiB
Markdown
---
|
||
okf: "0.1"
|
||
type: subsystem
|
||
visibility: private
|
||
status: active
|
||
updated: 2026-08-03
|
||
stub: true
|
||
links: []
|
||
contradicts:
|
||
- CLAUDE.md "Repo-managed services on VPS" wymienia services/joplin/ — katalog nie istnieje
|
||
- CLAUDE.md "Repo-managed services on VPS" wymienia services/outline/ — katalog nie istnieje
|
||
- CLAUDE.md "Repo-managed services on VPS" wymienia services/ai-cluster/ — katalog nie istnieje
|
||
---
|
||
|
||
# Kontrakt operacyjny repo (CLAUDE.md)
|
||
|
||
Zrodlo prawdy o rolach node’ow, ukladzie serwisow, architekturze agentowej,
|
||
konwencjach runtime i regulach VPS-a lezy w `CLAUDE.md` w korzeniu repo.
|
||
|
||
> **Stub / wskaznik.** `CLAUDE.md` jest zywa konfiguracja narzedzia (czyta ja
|
||
> Claude Code przy kazdej sesji) i **zostaje w korzeniu repo** — nie jest
|
||
> kopiowana do KB, zeby nie powstala druga, rozjezdzajaca sie wersja.
|
||
> Ten dokument istnieje po to, zeby kontrakt byl adresowalny z poziomu KB
|
||
> i zeby powiesic na nim pole `contradicts`.
|
||
|
||
**Zrodlo:** `../../CLAUDE.md`
|
||
|
||
## Znana sprzecznosc: sekcja „Repo-managed services on VPS”
|
||
|
||
`CLAUDE.md` deklaruje trzy stacki jako GitOps-managed pod `services/<name>/`:
|
||
`joplin`, `outline`, `ai-cluster`. **Zadny z tych katalogow nie istnieje w repo.**
|
||
|
||
Znany kontekst PR2 `feat/vps-service-migration` — **nie naprawiane w etapie 2**
|
||
(migracja do KB jest mechaniczna, bez redakcji tresci).
|