LedgerHQ/ledger-live

analytics

Read when adding or changing product analytics events. Import track from @shared/analytics and React adapters from @shared/analytics-react.

Idioma del texto original: inglés

batch-feature-dev

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.

Idioma del texto original: inglés

ci-runners

Pick a self-hosted runner for a GitHub Actions job. Read before adding or changing any `runs-on` (or a runner label passed as an input or matrix value) in `.github/workflows/**`.

Idioma del texto original: inglés

ci-workflow-refs

Root workflows run at the triggering commit but call reusable workflows and composite actions pinned `@develop`, so on release/hotfix/main the child YAML is newer than the code it checks out. Read before changing any reusable workflow (`*-reusable.yml`,…

Idioma del texto original: inglés

cleanup

Manual entry point: format and lint the current changes with the validate-changes skill. Use when the user types /cleanup.

Idioma del texto original: inglés

client-ids

Handle device, user and Datadog identifiers through the redacted `DeviceId`, `UserId` and `DatadogId` classes of `@domain/entity-client-identity`, reading a raw value only through an export method allowlisted in `export-rules.json`. Use when reading, storing…

Idioma del texto original: inglés

coin-families-contract

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

Idioma del texto original: inglés

coin-modules

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

Idioma del texto original: inglés

comments

Replace code comments with clearer names, explainer variables and test names, and keep the rare necessary comment to one short line or a link. Read when writing or reviewing code and about to add a `//` or `/* */` comment or a JSDoc block, or when a review…

Idioma del texto original: inglés

console-log

Choose between `console.warn`, `console.error` and no log at all, knowing Datadog RUM reports every `console.error` as an error event. Read when adding or changing a `console.error`, `console.warn` or `console.log` call in app or package code, or when Datadog…

Idioma del texto original: inglés

create-changeset

Create changesets for the ledger-live monorepo using @changesets/cli. Use when the user asks to add a changeset, prepare a release, or document package changes for a PR.

Idioma del texto original: inglés

create-pr

Push the current branch and open a draft pull request with a conventional title, a body from the repo PR template, a changeset and a Slack announcement. Use when the user runs `/create-pr` or asks to open a pull request for the current branch.

Idioma del texto original: inglés

data-layer-advanced

Structure a Ledger Wallet data layer where one API response serves several entities. Use when creating or reviewing cross-entity domain/api orchestration with RTK Query, createAsyncThunk, or both, including response validation and tests spanning multiple…

Idioma del texto original: inglés

detect-data-leaks

Detect new PII leaks introduced by the current branch. Use when asked to check for potential data leaks for the current changes.

Idioma del texto original: inglés

dialogs-slice

Open and close a Ledger Wallet Desktop global dialog through the shared `dialogs` Redux slice (`DIALOG_IDS`, `openDialog`, `selectIsDialogOpen`) and mount it once in `GlobalDialogs`. Use when adding a desktop dialog mounted at the app root and opened from a…

Idioma del texto original: inglés

domain-data

Build the data layer of one entity in `domain/`. The `domain/entity` package holds Zod schemas, inferred types, branded ids, the slice, mocks and selectors. The `domain/api` package injects RTK Query endpoints into an `@shared/api-services` base. Use when…

Idioma del texto original: inglés

e2e-desktop-add-or-update

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, add or change a timeout or wait, or work with Speculos.

Idioma del texto original: inglés

e2e-desktop-onboard

Interactive setup wizard for running desktop E2E (Playwright + Speculos) tests locally. Use when a developer sets up their machine to run desktop E2E tests for the first time.

Idioma del texto original: inglés

e2e-mobile-onboard

Interactive setup wizard for running mobile E2E (Detox) tests locally. Use when a developer sets up their machine to run mobile E2E tests for the first time.

Idioma del texto original: inglés

errors

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.

Idioma del texto original: inglés

feature-dev

Guided feature development for Ledger Wallet, from placing the code in the right layer through exploration, design, implementation and review. Use when the user asks to build a new feature or capability end to end.

Idioma del texto original: inglés

fix-ci

Bring a branch's failing GitHub Actions checks to green one error at a time, finding the latest run with `gh`, reading the failed job logs, applying the smallest fix and rerunning. Use when CI fails on the current branch or its pull request, when `gh pr…

Idioma del texto original: inglés

flow-package

The anatomy of a `features/flow/<name>` package: MVVM for every screen, flat `src/` or `screens/<Screen>/`, flow state versus entity state, local routing, and where `copy/`, `logic/`, `model/`, `types.ts` and `exports.ts` go. Use when creating or editing a…

Idioma del texto original: inglés

knip-migration

Dead-code / unused-dependency detection uses `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 to knip.

Idioma del texto original: inglés

ldls-native

Lumen UI React Native design system rules (`@ledgerhq/lumen-ui-rnative`) and how a native implementation maps a universal contract onto Lumen. Use when writing or reviewing native UI, in `*.native.tsx` files or under `apps/ledger-live-mobile/**`.

Idioma del texto original: inglés

ldls-web

Lumen UI React design system rules (`@ledgerhq/lumen-ui-react`) and how a web implementation maps a universal contract onto Lumen. Use when writing or reviewing web UI, in `*.web.tsx` files or under `apps/ledger-live-desktop/**`.

Idioma del texto original: inglés

ledger-wallet-cli

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), the Ledger Key Ring (ring…

Idioma del texto original: inglés

legacy-migration

Move code out of `libs/` or `apps/*/src` into the layers (`shared/`, `domain/`, `features/`) in three steps, addition, deprecation and deletion, and give a new-architecture package what only legacy code provides through injection (ports, thunk…

Idioma del texto original: inglés

mvvm-architecture

The Container, ViewModel, View convention of app composition code under apps/*/src/mvvm/** and of every features/flow package. Read when creating, editing or reviewing files in apps/*/src/mvvm/**, or view model and view files in features/flow/**…

Idioma del texto original: inglés

package-public-api

A new-architecture package (shared/, domain/, features/) exposes its API through barrels that contain nothing but `export *`, and keeps its private code in an internals location. Read this when creating a package under shared/, domain/ or features/, when…

Idioma del texto original: inglés

react-general

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

Idioma del texto original: inglés

remove-feature-flag

Remove a Ledger Wallet feature flag while preserving its resolved production behavior, then validate, create a draft PR, and watch CI to green. Invoke only through /remove-feature-flag; this command may stash local work, push a new branch, create or update…

Idioma del texto original: inglés

run-builds

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…

Idioma del texto original: inglés

run-tests

Manual entry point: test the current changes with the validate-changes skill. Use when the user types /run-tests.

Idioma del texto original: inglés

runner-images

Self-hosted CI runner images in LedgerHQ/ledger-wallet-runners bake this repo's toolchain. Read before changing a version in `mise.toml` or `mise.lock` (mise itself, node, pnpm, bun or any other mise tool) or the Android AVD configuration…

Idioma del texto original: inglés

slack-pr-message

Generate a formatted Slack message to share a pull request with the team. Use when the user asks to generate a Slack message for a PR, share a PR on Slack, or after creating a pull request.

Idioma del texto original: inglés

structure-flow

Decide where Ledger Wallet code goes in the monorepo layers (`support/`, `shared/`, `domain/`, `features/`, `apps/`, plus `devtools/`) with a first-yes-wins decision tree, and apply the placement rules behind it - entity versus flow state, one flow per…

Idioma del texto original: inglés

support-config

Give a package its TypeScript, jest, lint and format config from the `support/` presets (`@support/tsconfig`, `@support/jest`, `@support/lint`, `@support/fmt`), pick its tsconfig archetype, and fix what `pnpm lint:tool-config` reports. Use when creating or…

Idioma del texto original: inglés

testing

Write unit and integration tests for the Ledger Wallet apps and for packages in the layers (`shared/`, `domain/`, `features/`, `devtools/`): Jest with React Testing Library, `@support/jest` presets, MSW handlers and testing best practices. Integration tests…

Idioma del texto original: inglés

typescript

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

Idioma del texto original: inglés