opc-architecture

OPC Architecture Understanding to zestaw rozszerzeń dla Claude Code CLI, który umożliwia orkiestrację wielu równoległych instancji agentów. Zamiast pojedynczego procesu, spawdzasz nowe procesy Claude'a jako zadania podrzędne, które komunikują się przez bazę danych koordynacyjną. Wykorzystujesz haki (hooks) do przechwytywania zdarzeń Claude Code, umiejętności (skills) do ładowania promptów, oraz skrypty do synchronizacji między agentami. Idealne dla złożonych przepływów pracy wymagających równoczesnego wykonania wielu zadań.

1. Zainstaluj strukturę katalogów OPC w swoim projekcie: utwórz foldery .claude/hooks/, .claude/skills/, .claude/cache/ oraz opc/scripts/. 2. Umieść pliki TypeScript haków w .claude/hooks/ — będą one automatycznie ładowane przez Claude Code i reagować na zdarzenia takie jak PreToolUse, PostToolUse czy SessionStart. 3. Dodaj pliki umiejętności (SKILL.md) w .claude/skills/ — Claude Code załaduje te prompty i udostępni je jako narzędzia. 4. Zarejestruj haki w pliku .claude/settings.json, aby Claude Code wiedział, które haki uruchomić i kiedy. 5. W haków lub umiejętności wywołaj skrypty Pythona z folderu opc/scripts/ za pomocą subprocess.Popen() — każdy spawdzony proces Claude'a będzie niezależnym agentem, który czyta i pisze do wspólnej bazy danych koordynacyjnej. 6. Monitoruj PIDs agentów w bazie danych — proces główny (Twój terminal) śledzi procesy podrzędne i koordynuje ich pracę poprzez zdarzenia i stan przechowywany w cache.