n8n-conventions

Quick reference for n8n patterns. Full docs /AGENTS.md

1. Zainstaluj umiejętność, dodając repozytorium n8n do swojego systemu promptów Claude'a lub Copilota. Umiejętność znajduje się w katalogu .claude/skills/n8n-conventions w głównym repozytorium n8n.

2. Wyzwól umiejętność, gdy pracujesz nad kodem n8n i potrzebujesz szybkiego przypomnienia o konwencjach. Możesz zapytać o konkretne wzorce, na przykład "Jak obsługiwać błędy w n8n?" lub "Jakie są reguły TypeScript w tym projekcie?".

3. Zapoznaj się z głównymi sekcjami: reguły TypeScript (nigdy nie używaj any, preferuj satisfies zamiast as), obsługę błędów (importuj UnexpectedError z n8n-workflow), konwencje frontendowe (Vue 3 Composition API, zmienne CSS, i18n dla tekstu).

4. Dla szczegółowych informacji o architekturze, frontendzie lub komendach odsyłaj się do pełnej dokumentacji w plikach /AGENTS.md w katalogu głównym oraz /packages/frontend/AGENTS.md dla sekcji frontendowej.

5. Przed zatwierdzeniem zmian uruchom komendy: pnpm typecheck i pnpm lint. Dla budowania zawsze przekierowuj output: pnpm build > build.log 2>&1.

6. Pamiętaj o kluczowych pakietach: packages/cli dla backendu, packages/frontend/editor-ui dla Vue 3, packages/@n8n/api-types dla typów współdzielonych oraz packages/@n8n/db dla encji TypeORM.