homelab-codex-ws/kb/subsystems/repo-operating-contract.md

35 lines
1.3 KiB
Markdown
Raw Normal View History

---
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 nodeow, 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).