obsidian-reference-architecture

Skill do projektowania wtyczek Obsidiana zgodnie ze sprawdzonymi wzorcami architektonicznymi. Zawiera rekomendowaną strukturę katalogów, separację odpowiedzialności (komendy, widoki, ustawienia, usługi), zarządzanie stanem i warstwę serwisową do operacji na sejfie. Użyj go przy tworzeniu nowych wtyczek, przeglądaniu struktury projektu lub ustalaniu standardów architektonicznych w zespole. Wymaga znajomości TypeScript i API Obsidiana.

1. Zainstaluj skill w swoim środowisku Claude Code, Codex lub OpenClaw. Upewnij się, że masz już przygotowany projekt wtyczki z plikami manifest.json, package.json i tsconfig.json.

2. Wyzwól skill frazami takimi jak "obsidian architecture", "obsidian project structure", "obsidian best practices" lub "organize obsidian plugin" w kontekście swojego projektu.

3. Skill zaproponuje strukturę katalogów: katalog src/ z podfolderami commands/, views/, settings/ i services/. Plik main.ts pełni rolę cienką orkiestratora, types.ts zawiera interfejsy, constants.ts przechowuje stałe.

4. Zaimplementuj rejestr komend w commands/index.ts i rejestr widoków w views/index.ts. Każda komenda i widok powinny mieć własny plik w odpowiednim podfolderze.

5. Utwórz warstwę usług w folderze services/: vault-service.ts do operacji na plikach, metadata-service.ts do frontmatter i cache, sync-service.ts do zadań w tle. Usługi obsługują logikę biznesową niezależnie od UI.

6. Dodaj settings.ts i settings-tab.ts do zarządzania konfiguracją wtyczki. Użyj styles.css do stylowania z prawidłowym scopingiem CSS. Skill pomoże ci utrzymać projekt modularny i łatwy do rozszerzania.