oskar/homelab-codex-ws
1
0
Fork 0
Code Issues Pull requests Actions Packages Projects Releases Wiki Activity
homelab-codex-ws/kb/subsystems/repo-operating-contract.md
oskar 28df42cbee feat(kb): stuby dla katalogow z kodem bez README (8 plikow) 
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>
2026-08-04 16:58:04 +02:00

1.3 KiB
Raw Blame History

okf type visibility status updated stub links contradicts
0.1 subsystem private active 2026-08-03 true
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).