ADR-001: Struktura Obsidian Vault i zarządzanie przez Orwila
Data: 2026-03-05 Status: Accepted
Kontekst
Potrzebowaliśmy miejsca na długoterminową wiedzę zespołu — decyzje, architekturę, notatki z sesji. Alternatywy: Notion, Confluence, wiki GitLab, pliki w repo.
Decyzja
Używamy Obsidian Vault jako centralnego miejsca wiedzy zespołu.
- Repo:
https://git.cynarski.pl/Orwil/vault(prywatne) - Format: Markdown (
.md) — kompatybilny z Obsidian.md - Zarządza: Orwil — commituje i pushuje po każdej sesji
- Aleksander ma dostęp read/write przez Obsidian.md lokalnie
Struktura katalogów
vault/
├── ADR/ ← Decision Records (ten plik i kolejne)
├── architektura/ ← Diagramy i opisy systemów
├── sesje/ ← Notatki z sesji pracy
├── Home Assistant/ ← Konfiguracja HA
└── README.md
Uzasadnienie
- Markdown = git-friendly, diff-able, bez vendor lock-in
- Obsidian = dobre UI dla Aleksandra lokalnie
- Git = historia zmian, backup, synchronizacja
- Orwil jako zarządca = jeden punkt odpowiedzialności
Konsekwencje
- Orwil musi commitować vault po każdej sesji gdzie coś istotnego się wydarzyło
- Nie wrzucamy prywatnych danych (tokenów, haseł)
- ADR-y piszemy retroaktywnie gdy decyzja już zapadła