diff --git a/AGENTS.md b/AGENTS.md
new file mode 100644
index 0000000000000..533184b4597ad
--- /dev/null
+++ b/AGENTS.md
@@ -0,0 +1,158 @@
+# AGENTS.md
+
+This file provides guidance to Claude Code (claude.ai/code) when working with
+code in the n8n repository.
+
+## Project Overview
+
+n8n is a workflow automation platform written in TypeScript, using a monorepo
+structure managed by pnpm workspaces. It consists of a Node.js backend, Vue.js
+frontend, and extensible node-based workflow engine.
+
+## General Guidelines
+
+- Always use pnpm
+- We use Linear as a ticket tracking system
+- We use Posthog for feature flags
+- When starting to work on a new ticket – create a new branch from fresh
+  master with the name specified in Linear ticket
+- When creating a new branch for a ticket in Linear - use the branch name
+  suggested by linear
+- Use mermaid diagrams in MD files when you need to visualise something
+
+## Essential Commands
+
+### Building
+Use `pnpm build` to build all packages. ALWAYS redirect the output of the
+build command to a file:
+
+```bash
+pnpm build > build.log 2>&1
+```
+
+You can inspect the last few lines of the build log file to check for errors:
+```bash
+tail -n 20 build.log
+```
+
+### Testing
+- `pnpm test` - Run all tests
+- `pnpm test:affected` - Runs tests based on what has changed since the last
+  commit
+
+Running a particular test file requires going to the directory of that test
+and running: `pnpm test <test-file>`.
+
+When changing directories, use `pushd` to navigate into the directory and
+`popd` to return to the previous directory. When in doubt, use `pwd` to check
+your current directory.
+
+### Code Quality
+- `pnpm lint` - Lint code
+- `pnpm typecheck` - Run type checks
+
+Always run lint and typecheck before committing code to ensure quality.
+Execute these commands from within the specific package directory you're
+working on (e.g., `cd packages/cli && pnpm lint`). Run the full repository
+check only when preparing the final PR. When your changes affect type
+definitions, interfaces in `@n8n/api-types`, or cross-package dependencies,
+build the system before running lint and typecheck.
+
+## Architecture Overview
+
+**Monorepo Structure:** pnpm workspaces with Turbo build orchestration
+
+### Package Structure
+
+The monorepo is organized into these key packages:
+
+- **`packages/@n8n/api-types`**: Shared TypeScript interfaces between frontend and backend
+- **`packages/workflow`**: Core workflow interfaces and types
+- **`packages/core`**: Workflow execution engine
+- **`packages/cli`**: Express server, REST API, and CLI commands
+- **`packages/editor-ui`**: Vue 3 frontend application
+- **`packages/@n8n/i18n`**: Internationalization for UI text
+- **`packages/nodes-base`**: Built-in nodes for integrations
+- **`packages/@n8n/nodes-langchain`**: AI/LangChain nodes
+- **`@n8n/design-system`**: Vue component library for UI consistency
+- **`@n8n/config`**: Centralized configuration management
+
+## Technology Stack
+
+- **Frontend:** Vue 3 + TypeScript + Vite + Pinia + Storybook UI Library
+- **Backend:** Node.js + TypeScript + Express + TypeORM
+- **Testing:** Jest (unit) + Playwright (E2E)
+- **Database:** TypeORM with SQLite/PostgreSQL/MySQL support
+- **Code Quality:** Biome (for formatting) + ESLint + lefthook git hooks
+
+### Key Architectural Patterns
+
+1. **Dependency Injection**: Uses `@n8n/di` for IoC container
+2. **Controller-Service-Repository**: Backend follows MVC-like pattern
+3. **Event-Driven**: Internal event bus for decoupled communication
+4. **Context-Based Execution**: Different contexts for different node types
+5. **State Management**: Frontend uses Pinia stores
+6. **Design System**: Reusable components and design tokens are centralized in
+   `@n8n/design-system`, where all pure Vue components should be placed to
+   ensure consistency and reusability
+
+## Key Development Patterns
+
+- Each package has isolated build configuration and can be developed independently
+- Hot reload works across the full stack during development
+- Node development uses dedicated `node-dev` CLI tool
+- Workflow tests are JSON-based for integration testing
+- AI features have dedicated development workflow (`pnpm dev:ai`)
+
+### TypeScript Best Practices
+- **NEVER use `any` type** - use proper types or `unknown`
+- **Avoid type casting with `as`** - use type guards or type predicates instead
+- **Define shared interfaces in `@n8n/api-types`** package for FE/BE communication
+
+### Error Handling
+- Don't use `ApplicationError` class in CLI and nodes for throwing errors,
+  because it's deprecated. Use `UnexpectedError`, `OperationalError` or
+  `UserError` instead.
+- Import from appropriate error classes in each package
+
+### Frontend Development
+- **All UI text must use i18n** - add translations to `@n8n/i18n` package
+- **Use CSS variables directly** - never hardcode spacing as px values
+- **data-test-id must be a single value** (no spaces or multiple values)
+
+When implementing CSS, refer to @packages/frontend/CLAUDE.md for guidelines on
+CSS variables and styling conventions.
+
+### Testing Guidelines
+- **Always work from within the package directory** when running tests
+- **Mock all external dependencies** in unit tests
+- **Confirm test cases with user** before writing unit tests
+- **Typecheck is critical before committing** - always run `pnpm typecheck`
+- **When modifying pinia stores**, check for unused computed properties
+
+What we use for testing and writing tests:
+- For testing nodes and other backend components, we use Jest for unit tests. Examples can be found in `packages/nodes-base/nodes/**/*test*`.
+- We use `nock` for server mocking
+- For frontend we use `vitest`
+- For E2E tests we use Playwright. Run with `pnpm --filter=n8n-playwright test:local`.
+  See `packages/testing/playwright/README.md` for details.
+
+### Common Development Tasks
+
+When implementing features:
+1. Define API types in `packages/@n8n/api-types`
+2. Implement backend logic in `packages/cli` module, follow
+   `@packages/cli/scripts/backend-module/backend-module-guide.md`
+3. Add API endpoints via controllers
+4. Update frontend in `packages/editor-ui` with i18n support
+5. Write tests with proper mocks
+6. Run `pnpm typecheck` to verify types
+
+## Github Guidelines
+- When creating a PR, use the conventions in
+  `.github/pull_request_template.md` and
+  `.github/pull_request_title_conventions.md`.
+- Use `gh pr create --draft` to create draft PRs.
+- Always reference the Linear ticket in the PR description,
+  use `https://linear.app/n8n/issue/[TICKET-ID]`
+- always link to the github issue if mentioned in the linear ticket.
diff --git a/CLAUDE.md b/CLAUDE.md
index f7b66facb0fb7..43c994c2d3617 100644
--- a/CLAUDE.md
+++ b/CLAUDE.md
@@ -1,158 +1 @@
-# CLAUDE.md
-
-This file provides guidance to Claude Code (claude.ai/code) when working with
-code in the n8n repository.
-
-## Project Overview
-
-n8n is a workflow automation platform written in TypeScript, using a monorepo
-structure managed by pnpm workspaces. It consists of a Node.js backend, Vue.js
-frontend, and extensible node-based workflow engine.
-
-## General Guidelines
-
-- Always use pnpm
-- We use Linear as a ticket tracking system
-- We use Posthog for feature flags
-- When starting to work on a new ticket – create a new branch from fresh
-  master with the name specified in Linear ticket
-- When creating a new branch for a ticket in Linear - use the branch name
-  suggested by linear
-- Use mermaid diagrams in MD files when you need to visualise something
-
-## Essential Commands
-
-### Building
-Use `pnpm build` to build all packages. ALWAYS redirect the output of the
-build command to a file:
-
-```bash
-pnpm build > build.log 2>&1
-```
-
-You can inspect the last few lines of the build log file to check for errors:
-```bash
-tail -n 20 build.log
-```
-
-### Testing
-- `pnpm test` - Run all tests
-- `pnpm test:affected` - Runs tests based on what has changed since the last
-  commit
-
-Running a particular test file requires going to the directory of that test
-and running: `pnpm test <test-file>`.
-
-When changing directories, use `pushd` to navigate into the directory and
-`popd` to return to the previous directory. When in doubt, use `pwd` to check
-your current directory.
-
-### Code Quality
-- `pnpm lint` - Lint code
-- `pnpm typecheck` - Run type checks
-
-Always run lint and typecheck before committing code to ensure quality.
-Execute these commands from within the specific package directory you're
-working on (e.g., `cd packages/cli && pnpm lint`). Run the full repository
-check only when preparing the final PR. When your changes affect type
-definitions, interfaces in `@n8n/api-types`, or cross-package dependencies,
-build the system before running lint and typecheck.
-
-## Architecture Overview
-
-**Monorepo Structure:** pnpm workspaces with Turbo build orchestration
-
-### Package Structure
-
-The monorepo is organized into these key packages:
-
-- **`packages/@n8n/api-types`**: Shared TypeScript interfaces between frontend and backend
-- **`packages/workflow`**: Core workflow interfaces and types
-- **`packages/core`**: Workflow execution engine
-- **`packages/cli`**: Express server, REST API, and CLI commands
-- **`packages/editor-ui`**: Vue 3 frontend application
-- **`packages/@n8n/i18n`**: Internationalization for UI text
-- **`packages/nodes-base`**: Built-in nodes for integrations
-- **`packages/@n8n/nodes-langchain`**: AI/LangChain nodes
-- **`@n8n/design-system`**: Vue component library for UI consistency
-- **`@n8n/config`**: Centralized configuration management
-
-## Technology Stack
-
-- **Frontend:** Vue 3 + TypeScript + Vite + Pinia + Storybook UI Library
-- **Backend:** Node.js + TypeScript + Express + TypeORM
-- **Testing:** Jest (unit) + Playwright (E2E)
-- **Database:** TypeORM with SQLite/PostgreSQL/MySQL support
-- **Code Quality:** Biome (for formatting) + ESLint + lefthook git hooks
-
-### Key Architectural Patterns
-
-1. **Dependency Injection**: Uses `@n8n/di` for IoC container
-2. **Controller-Service-Repository**: Backend follows MVC-like pattern
-3. **Event-Driven**: Internal event bus for decoupled communication
-4. **Context-Based Execution**: Different contexts for different node types
-5. **State Management**: Frontend uses Pinia stores
-6. **Design System**: Reusable components and design tokens are centralized in
-   `@n8n/design-system`, where all pure Vue components should be placed to
-   ensure consistency and reusability
-
-## Key Development Patterns
-
-- Each package has isolated build configuration and can be developed independently
-- Hot reload works across the full stack during development
-- Node development uses dedicated `node-dev` CLI tool
-- Workflow tests are JSON-based for integration testing
-- AI features have dedicated development workflow (`pnpm dev:ai`)
-
-### TypeScript Best Practices
-- **NEVER use `any` type** - use proper types or `unknown`
-- **Avoid type casting with `as`** - use type guards or type predicates instead
-- **Define shared interfaces in `@n8n/api-types`** package for FE/BE communication
-
-### Error Handling
-- Don't use `ApplicationError` class in CLI and nodes for throwing errors,
-  because it's deprecated. Use `UnexpectedError`, `OperationalError` or
-  `UserError` instead.
-- Import from appropriate error classes in each package
-
-### Frontend Development
-- **All UI text must use i18n** - add translations to `@n8n/i18n` package
-- **Use CSS variables directly** - never hardcode spacing as px values
-- **data-test-id must be a single value** (no spaces or multiple values)
-
-When implementing CSS, refer to @packages/frontend/CLAUDE.md for guidelines on
-CSS variables and styling conventions.
-
-### Testing Guidelines
-- **Always work from within the package directory** when running tests
-- **Mock all external dependencies** in unit tests
-- **Confirm test cases with user** before writing unit tests
-- **Typecheck is critical before committing** - always run `pnpm typecheck`
-- **When modifying pinia stores**, check for unused computed properties
-
-What we use for testing and writing tests:
-- For testing nodes and other backend components, we use Jest for unit tests. Examples can be found in `packages/nodes-base/nodes/**/*test*`.
-- We use `nock` for server mocking
-- For frontend we use `vitest`
-- For E2E tests we use Playwright. Run with `pnpm --filter=n8n-playwright test:local`.
-  See `packages/testing/playwright/README.md` for details.
-
-### Common Development Tasks
-
-When implementing features:
-1. Define API types in `packages/@n8n/api-types`
-2. Implement backend logic in `packages/cli` module, follow
-   `@packages/cli/scripts/backend-module/backend-module.guide.md`
-3. Add API endpoints via controllers
-4. Update frontend in `packages/editor-ui` with i18n support
-5. Write tests with proper mocks
-6. Run `pnpm typecheck` to verify types
-
-## Github Guidelines
-- When creating a PR, use the conventions in
-  `.github/pull_request_template.md` and
-  `.github/pull_request_title_conventions.md`.
-- Use `gh pr create --draft` to create draft PRs.
-- Always reference the Linear ticket in the PR description,
-  use `https://linear.app/n8n/issue/[TICKET-ID]`
-- always link to the github issue if mentioned in the linear ticket.
+@AGENTS.md
diff --git a/packages/frontend/AGENTS.md b/packages/frontend/AGENTS.md
new file mode 100644
index 0000000000000..8f8069ca3874c
--- /dev/null
+++ b/packages/frontend/AGENTS.md
@@ -0,0 +1,116 @@
+# AGENTS.md
+
+Extra information, specific to the frontend codebase.
+
+### CSS Variables Reference
+
+Use the following CSS variables to maintain consistency across the
+application. These variables cover colors, spacing, typography, and borders.
+
+#### Colors
+```css
+/* Primary Colors */
+--color--primary--shade-1
+--color--primary
+--color--primary--tint-1
+--color--primary--tint-2
+--color--primary--tint-3
+
+/* Secondary Colors */
+--color--secondary--shade-1
+--color--secondary
+--color--secondary--tint-1
+--color--secondary--tint-2
+
+/* Success Colors */
+--color--success--shade-1
+--color--success
+--color--success--tint-1
+--color--success--tint-2
+--color--success--tint-3
+--color--success--tint-4
+
+/* Warning Colors */
+--color--warning--shade-1
+--color--warning
+--color--warning--tint-1
+--color--warning--tint-2
+
+/* Danger Colors */
+--color--danger--shade-1
+--color--danger
+--color--danger--tint-3
+--color--danger--tint-4
+
+/* Text Colors */
+--color--text--shade-1
+--color--text
+--color--text--tint-1
+--color--text--tint-2
+--color--text--tint-3
+--color--text--danger
+
+/* Foreground Colors */
+--color--foreground--shade-2
+--color--foreground--shade-1
+--color--foreground
+--color--foreground--tint-1
+--color--foreground--tint-2
+
+/* Background Colors */
+--color--background--shade-2
+--color--background--shade-1
+--color--background
+--color--background--light-2
+--color--background--light-3
+```
+
+#### Spacing
+```css
+--spacing--5xs: 2px
+--spacing--4xs: 4px
+--spacing--3xs: 6px
+--spacing--2xs: 8px
+--spacing--xs: 12px
+--spacing--sm: 16px
+--spacing--md: 20px
+--spacing--lg: 24px
+--spacing--xl: 32px
+--spacing--2xl: 48px
+--spacing--3xl: 64px
+--spacing--4xl: 128px
+--spacing--5xl: 256px
+```
+
+#### Typography
+```css
+--font-size--3xs: 10px
+--font-size--2xs: 12px
+--font-size--xs: 13px
+--font-size--sm: 14px
+--font-size--md: 16px
+--font-size--lg: 18px
+--font-size--xl: 20px
+--font-size--2xl: 28px
+
+--line-height--sm: 1.25
+--line-height--md: 1.3
+--line-height--lg: 1.35
+--line-height--xl: 1.5
+
+--font-weight--regular: 400
+--font-weight--bold: 600
+--font-family: InterVariable, sans-serif
+```
+
+#### Borders
+```css
+--radius--sm: 2px
+--radius: 4px
+--radius--lg: 8px
+--radius--xl: 12px
+
+--border-width: 1px
+--border-style: solid
+--border: var(--border-width) var(--border-style) var(--color--foreground)
+```
diff --git a/packages/frontend/CLAUDE.md b/packages/frontend/CLAUDE.md
index 83292a3632209..43c994c2d3617 100644
--- a/packages/frontend/CLAUDE.md
+++ b/packages/frontend/CLAUDE.md
@@ -1,117 +1 @@
-# CLAUDE.md
-
-Extra information, specific to the frontend codebase.
-
-### CSS Variables Reference
-
-Use the following CSS variables to maintain consistency across the
-application. These variables cover colors, spacing, typography, and borders.
-
-#### Colors
-```css
-/* Primary Colors */
---color--primary--shade-1
---color--primary
---color--primary--tint-1
---color--primary--tint-2
---color--primary--tint-3
-
-/* Secondary Colors */
---color--secondary--shade-1
---color--secondary
---color--secondary--tint-1
---color--secondary--tint-2
-
-/* Success Colors */
---color--success--shade-1
---color--success
---color--success--tint-1
---color--success--tint-2
---color--success--tint-3
---color--success--tint-4
-
-/* Warning Colors */
---color--warning--shade-1
---color--warning
---color--warning--tint-1
---color--warning--tint-2
-
-/* Danger Colors */
---color--danger--shade-1
---color--danger
---color--danger--tint-3
---color--danger--tint-4
-
-/* Text Colors */
---color--text--shade-1
---color--text
---color--text--tint-1
---color--text--tint-2
---color--text--tint-3
---color--text--danger
-
-/* Foreground Colors */
---color--foreground--shade-2
---color--foreground--shade-1
---color--foreground
---color--foreground--tint-1
---color--foreground--tint-2
-
-/* Background Colors */
---color--background--shade-2
---color--background--shade-1
---color--background
---color--background--light-2
---color--background--light-3
-```
-
-#### Spacing
-```css
---spacing--5xs: 2px
---spacing--4xs: 4px
---spacing--3xs: 6px
---spacing--2xs: 8px
---spacing--xs: 12px
---spacing--sm: 16px
---spacing--md: 20px
---spacing--lg: 24px
---spacing--xl: 32px
---spacing--2xl: 48px
---spacing--3xl: 64px
---spacing--4xl: 128px
---spacing--5xl: 256px
-```
-
-#### Typography
-```css
---font-size--3xs: 10px
---font-size--2xs: 12px
---font-size--xs: 13px
---font-size--sm: 14px
---font-size--md: 16px
---font-size--lg: 18px
---font-size--xl: 20px
---font-size--2xl: 28px
-
---line-height--sm: 1.25
---line-height--md: 1.3
---line-height--lg: 1.35
---line-height--xl: 1.5
-
---font-weight--regular: 400
---font-weight--bold: 600
---font-family: InterVariable, sans-serif
-```
-
-#### Borders
-```css
---radius--sm: 2px
---radius: 4px
---radius--lg: 8px
---radius--xl: 12px
-
---border-width: 1px
---border-style: solid
---border: var(--border-width) var(--border-style) var(--color--foreground)
-```
-
+@AGENTS.md
diff --git a/packages/testing/playwright/AGENTS.md b/packages/testing/playwright/AGENTS.md
new file mode 100644
index 0000000000000..e3643c440deb6
--- /dev/null
+++ b/packages/testing/playwright/AGENTS.md
@@ -0,0 +1,11 @@
+# AGENTS.md
+
+## Commands
+
+- Use `pnpm test:local -- --reporter=line --grep="..."` to execute tests.
+
+
+## Code Styles
+
+- In writing locators, use specialized methods when available.
+  For example, prefer `page.getByRole('button')` over `page.locator('[role=button]')`.
diff --git a/packages/testing/playwright/CLAUDE.md b/packages/testing/playwright/CLAUDE.md
index 41ce0c61d440d..43c994c2d3617 100644
--- a/packages/testing/playwright/CLAUDE.md
+++ b/packages/testing/playwright/CLAUDE.md
@@ -1,11 +1 @@
-# CLAUDE.md
-
-## Commands
-
-- Use `pnpm test:local --reporter=line --grep="..."` to execute tests.
-
-
-## Code Styles
-
-- In writing locators, use specialized methods when available.
-  For example, prefer `page.getByRole('button')` over `page.locator('[role=button]')`.
\ No newline at end of file
+@AGENTS.md