ledger-live

Handle batches of Jira tickets through shared analysis, per-ticket feature-dev, Lumen UI guardrails, changesets, and draft PRs. Use when the user provides multiple Jira tickets or asks to deliver tickets one by one with PRs.

Trigger the on-demand production build workflows on LedgerHQ/ledger-live-build (Desktop, Android APK, iOS) for a ledger-live branch, then post a PR comment. Use when asked to "run builds", "produce a build", "build the app(s)", or "make an APK/iOS/desktop build" for a PR/branch.

Guided feature development with codebase understanding and architecture focus

Rules and layout for coin module packages under libs/coin-modules/. Read when adding or modifying a coin module.

Dead-code / unused-dependency detection is migrating from the legacy `unimported` tool to `knip`, which requires each package to expose an explicit, minimal `package.json#exports` (no `./*` wildcard). Read this when adding a new package or migrating an existing one.

Guidelines that must be followed when creating or updating docs in this repo. Applies to AGENTS.md, README.md, **/docs/**/*.md, skill and sub-agent files.

How to define and check error classes in Ledger Live. Read when adding a new error, creating an errors.ts file, or checking an error's type. Replaces the deprecated @ledgerhq/errors lib (createCustomErrorClass + serialize/deserialize).

Git workflow and commit conventions for Ledger Wallet

Official Ledger wallet-cli - USB-based CLI for Ledger hardware wallet flows (account discover, receive, balances, operations, send, swap quote/execute/status, genuine-check, assets token / token-by-id). Use for any wallet-cli command execution and for mapping informal requests to the right command.

Check, update, and RUN Earn E2E tests for Ledger Wallet Desktop (Playwright) and Mobile (Detox). Covers the Earn v2 dashboard, the native + redirect staking flows, and the delegate specs (owned by the Earn team). Use to run earn.v2 / delegate locally, adapt earn page objects/flows, and triage failures.

Trigger the on-demand E2E / Coin Tester CI workflows (Desktop E2E, Mobile E2E, Coin Tester) on a branch and post a PR comment. Use when asked to "run e2e", "trigger e2e on CI", or "run coin testers" for a PR/branch.

Repo-wide conventions for code comments. Read this when reviewing or adding code comments.

Create a pull request with proper description, changeset, and all required elements

Write unit and integration tests for Ledger Wallet apps. Use for Jest tests (Desktop/Mobile), MSW handlers and testing best practices. Applies to "*.test.*", "*.spec.*", "**/tests/**", "**/__tests__/**", "**/__integrations__/**", "**/jest-setup*"

Coin-specific families logic must live in families/. Generic UI uses the families contract only (no if (family === "evm") in shared code). Use this guidance for work in "**/families/**", "**/mvvm/**", "**/renderer/**" and "**/screens/**".

Prefer Set.has() over Array.includes() for constant allowlists/blocklists. Read this when reviewing or writing membership checks in TypeScript files.

Maintain CODEOWNERS file and team specific directories. Use when working with "**/team-*/**" file structure or to split an old file into team-specific parts

General React and React Native engineering rules for Ledger Live. Read when writing or reviewing any .ts/.tsx file.

Investigate native React Native crashes (Fabric/Hermes/iOS) in ledger-live-mobile when JS error logs are missing or unhelpful. Use when the app dies silently, throws an NSException on iOS, or shows only a native stack trace.

When typecheck finds an error importing from a lib in the monorepo, rebuild the lib

TypeScript + React typing conventions for Ledger Wallet. Read when writing or reviewing .ts and .tsx files.

Device Intent Executor (DIE) and Device Intents reference. Read when working with libs/device-intent/, DeviceIntentExecutor / DeviceIntentExecutorLWM, Intent definitions (IntentDefinition, IntentPlatformDefinition, Job, createIntent), deviceInitializationInput / buildDeviceInitializationInput, DmkCompatTransport, or migrating a Ledger Wallet device flow off connectApp / DeviceAction / withDevice.

Plan, review, and develop desktop and mobile app features following our MVVM architectural pattern. Applies to all new .ts and .tsx files within /apps/ledger-live-desktop or /apps/ledger-live-mobile

Interactive setup wizard for running desktop E2E (Playwright + Speculos) tests locally

Interactive setup wizard for running mobile E2E (Detox) tests locally

Migrate docs into our target structure. Use when asked to migrate or clean up existing docs – agentic and otherwise.

Add E2E tests for new coins or update existing Playwright tests for ledger-live-desktop. Use when the user wants to add send/receive e2e tests for a new cryptocurrency, update test configurations, or work with Speculos device simulator.

Run lint, format, and typecheck on modified files

Privacy-protected ID management with @ledgerhq/client-ids — DeviceId, UserId, DatadogId, export-rules.json

Global dialogs Redux slice pattern for MVVM dialog state management

Write or update Swap E2E tests for Ledger Live Desktop (Playwright) and Mobile (Detox). Use for swap spec updates, provider flows, multi-step approvals, page-object refactors, swap-history checks, KYC/validation banners, and review-driven cleanup.

Lumen UI React Native design system rules

LDLS UI React design system rules (@ledgerhq/lumen-ui-react)

Deep code review

Redux Toolkit createSlice best practices

RTK Query createApi best practices

Increase test coverage to 90% on a target zone with iterative writing and refactoring

Zod schema validation patterns for API types