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