monorepo-overview

GROWI monorepo structure, workspace organization, and architectural principles. Auto-invoked for all GROWI development work.

1. Skill aktywuje się automatycznie podczas pracy nad kodem GROWI — nie wymaga ręcznego wywoływania. Gdy zaczniesz pracę nad dowolnym komponentem lub aplikacją w monorepo, Claude automatycznie załaduje kontekst struktury projektu.

2. Zapoznaj się z mapą katalogów: aplikacje znajdują się w folderze apps/ (główna aplikacja, PDF converter, Slack proxy), a biblioteki współdzielone w packages/ (core, UI, editor, pluginkit, integracje Slack, wtyczki markdown).

3. Używaj pnpm workspace do zarządzania zależnościami między pakietami — referencje między projektami deklaruj za pomocą protokołu workspace:^ w pliku package.json, aby automatycznie rozwiązywały się do lokalnych wersji.

4. Uruchamiaj zadania za pośrednictwem Turborepo, które obsługuje cache'owanie i paralelizację: turbo run dev, turbo run test, turbo run lint, turbo run build. Możesz filtrować do konkretnego pakietu za pomocą flagi --filter, np. turbo run test --filter @growi/app.

5. Pamiętaj o kolejności buildów — zależności między pakietami są zarządzane przez Turborepo na podstawie deklaracji w turbo.json. Przed modyfikacją kodu upewnij się, że rozumiesz, które pakiety zależą od zmienianego modułu.

6. Sprawdzaj plik .changeset/ przy przygotowaniu zmian do wydania — monorepo używa changesetów do śledzenia wersji i generowania changelog'u dla każdego pakietu.