AI agents contributing to this repository must follow project conventions.
The Device Management Kit (DMK) is a TypeScript library that provides easy communication with Ledger devices.
- README.md
- CONTRIBUTING.md - Full contribution guidelines (branch naming, commits, PRs, changesets)
- proto is used as the toolchain manager to install the right version of every tool.
- pnpm is used as the package manager to install all the dependencies.
- Use
ghCLI (if available) for GitHub operations (create/update PRs, view workflows, comments, etc.)
Skills are activated automatically when the user's request matches a trigger phrase.
| Skill | Trigger | Description |
|---|---|---|
| Release Packages | release, /release |
Orchestrates the full release flow using scripts in .cursor/scripts/release/ |
| Backmerge | backmerge, /backmerge |
Backmerge release into develop after PR merges |
Commands are invoked explicitly by the user (via the command palette or / prefix).
| Command | Description |
|---|---|
| commit | Create a commit following gitmoji conventions |
| changeset | Create a changeset for a package |
| create-pr | Create a GitHub PR with proper title, changeset, and CI validation |
| trigger-snapshot-release | Trigger the snapshot release CI workflow |
Rules provide context to agents when relevant (not always applied).
| Rule | Description |
|---|---|
| commit.mdc | Gitmoji commit message format and signing requirements |
| changeset.mdc | Changeset creation guidelines (one package per changeset, bump types) |
Hooks run automatically on agent events. Configured in .cursor/hooks.json.
| Hook | Event | Description |
|---|---|---|
| format.cjs | afterFileEdit |
Auto-formats edited files with Prettier |
| post-task-checks.cjs | stop |
Runs tests, lint, and typecheck on changed packages |
The following commands require required_permissions: ["all"] because the default sandbox blocks post-install scripts, native module builds, or network access they need:
pnpm install/pnpm i- Any command that calls the GitHub API via
gh(e.g.gh auth status, release scripts that fetch PR metadata)