tomevault-io/tomes

governor

> Use when this capability is needed.

لغة النص الأصلي: الإنجليزية

advice-provider-hygiene

Use when writing kernel, account, or note MASM code that reads from or writes to the advice provider (advice stack / advice map) — validate advice data.

لغة النص الأصلي: الإنجليزية

assert-specific-error-in-tests

Use when writing a Rust test that exercises a failure path or a MASM test that expects a `panic` / `assert` — assert on the specific expected error variant or error code.

لغة النص الأصلي: الإنجليزية

cheap-masm-equivalents

Use when writing or reviewing MASM hot paths — prefer the cheaper equivalent instruction: `neq.0` over `gt.0` for non-zero checks, `cdrop` over an `if/else` selecting between two values, `dup.N` over `loc_load` for a value still on the stack, `eqw` over…

لغة النص الأصلي: الإنجليزية

checked-arithmetic

Use when writing Rust arithmetic on amounts or other quantities derived from external/user input — guard against silent overflow.

لغة النص الأصلي: الإنجليزية

conversion-method-naming

Use when naming a conversion or accessor method in Rust — follow the Rust API naming conventions for the method's cost and ownership.

لغة النص الأصلي: الإنجليزية

decouple-component-from-storage

Use when writing a MASM procedure inside a reusable account component that accesses account storage — receive the storage slot as a parameter so the component is portable across storage layouts.

لغة النص الأصلي: الإنجليزية

domain-newtypes-over-primitives

Use when introducing API parameters, struct fields, or return types that carry a domain value — represent them with a domain newtype that enforces their invariants.

لغة النص الأصلي: الإنجليزية

felt-construction

Use when constructing a `Felt` from a numeric value in Rust — avoid silently truncating values that may exceed the field modulus.

لغة النص الأصلي: الإنجليزية

intra-doc-links

Use when writing or editing a Rust doc comment that references a type, method, or module — link the reference so renames are caught by rustdoc.

لغة النص الأصلي: الإنجليزية

lowercase-error-messages

Use when writing or editing a Rust error message, panic/assert string, or MASM `ERR_*` constant — follow the Rust convention for error-message casing and punctuation.

لغة النص الأصلي: الإنجليزية

masm-constants

Enforce constant definition and organization conventions for Miden Assembly (.masm) files. Use when editing, reviewing, or creating .masm files that define or use constants. Use when this capability is needed.

لغة النص الأصلي: الإنجليزية

masm-doc-comments

Enforce doc comment conventions for Miden Assembly (.masm) procedures. Use when editing, reviewing, or creating .masm procedures, especially when documenting inputs, outputs, panic conditions, or invocation types. Use when this capability is needed.

لغة النص الأصلي: الإنجليزية

masm-error-constants

Use when adding or editing MASM `assert*` / `panic` instructions — give every assertion a descriptive named error code.

لغة النص الأصلي: الإنجليزية

masm-explicit-stack-inputs

Use when defining the interface for a new MASM procedure — keep its inputs explicit on the stack so the signature reflects what it consumes.

لغة النص الأصلي: الإنجليزية

masm-file-structure

Enforce file structure and section ordering for Miden Assembly (.masm) files. Use when editing, reviewing, or creating .masm files. Use when this capability is needed.

لغة النص الأصلي: الإنجليزية

masm-inline-comments

Enforce inline commenting conventions for Miden Assembly (.masm) files. Use when editing, reviewing, or creating .masm files. Use when this capability is needed.

لغة النص الأصلي: الإنجليزية

masm-locals-over-globals

Use when a MASM procedure needs temporary scratch storage — keep it in procedure-local memory so it cannot collide in a shared global region.

لغة النص الأصلي: الإنجليزية

masm-named-literals

Use when writing or editing MASM or Rust code that contains meaningful numeric literals — promote them to named constants with a single source of truth.

لغة النص الأصلي: الإنجليزية

masm-padding

Enforce stack padding conventions for Miden Assembly (.masm) procedures based on invocation type (call vs exec). Use when editing, reviewing, or creating .masm procedures, especially those with Invocation annotations. Use when this capability is needed.

لغة النص الأصلي: الإنجليزية

masm-rust-constant-parity

Use when changing a numeric or string constant in Rust or MASM that has a counterpart on the other side — keep the two definitions from drifting apart.

لغة النص الأصلي: الإنجليزية

non-exhaustive-public-types

Use when defining a public `enum` or `struct` in a library crate that may gain variants or fields later — keep future additions from being breaking changes.

لغة النص الأصلي: الإنجليزية

parametrize-related-tests

Use when writing two or more tests that differ only by inputs or expected outputs — collapse the duplication into parameterized cases.

لغة النص الأصلي: الإنجليزية

preserve-error-source

Use when defining a new error variant or wrapping a lower-level error — keep the underlying error's source chain intact.

لغة النص الأصلي: الإنجليزية

private-fields-with-accessors

Use when adding a public struct or changing a field's visibility in a Rust library crate — keep fields encapsulated so the layout can evolve without breaking callers.

لغة النص الأصلي: الإنجليزية

return-error-not-panic

Use when writing a public Rust API, a deserialization path, or any code reachable from untrusted input — surface recoverable failures as a `Result`.

لغة النص الأصلي: الإنجليزية

u32-assert-before-u32-ops

Use when writing MASM `u32*` instructions on values from user input or untrusted sources — ensure the operands are valid u32s first.

لغة النص الأصلي: الإنجليزية

use-bon-builder

Use when introducing a Rust type whose constructor takes more than ~3 optional or named parameters — give it a generated builder instead of hand-written boilerplate.

لغة النص الأصلي: الإنجليزية

use-test-fixtures

Use when a Rust or MASM test needs to construct an account, note, transaction, or other domain object — build it with the existing test fixtures.

لغة النص الأصلي: الإنجليزية

validate-in-constructor

Use when writing or reviewing a Rust constructor, `try_new`, or builder `build` — centralize validation so every instance is valid by construction.

لغة النص الأصلي: الإنجليزية

workspace-shared-dependencies

Use when adding or modifying a dependency in a crate's `Cargo.toml` that is or may become shared by multiple workspace crates — keep its version defined in one place.

لغة النص الأصلي: الإنجليزية

cybernetic-systems-engineering-v2

| Use when this capability is needed.

لغة النص الأصلي: الصينية

pilot

通过 vite-plugin-pilot 在浏览器中测试页面。当需要查看页面状态、与页面元素交互、验证前端功能时使用。前置条件：vite-plugin-pilot 已安装且 dev server 已启动。 Use when this capability is needed.

لغة النص الأصلي: الصينية

react-native-best-practices

React Native development. Cross-platform code, native modules, performance. Use when building mobile apps. Use when this capability is needed.

لغة النص الأصلي: الإنجليزية

custom-control-builder

| Use when this capability is needed.

لغة النص الأصلي: الصينية

iptvnator-nx-architecture

Repository-specific Nx monorepo structure, library placement rules, scoped path aliases, and migration guardrails for portal/workspace/app code. Use when this capability is needed.

لغة النص الأصلي: الإنجليزية

iptvnator-sqlite-db-worker

Repository-specific guidance for Electron non-EPG SQLite worker boundaries, request-scoped DB progress events, and validation for slow DB operations. Use when this capability is needed.

لغة النص الأصلي: الإنجليزية

iptvnator-theme-style

Theme architecture, design tokens, shared SCSS library, portal header/sidebar patterns, Electron drag regions, and cross-portal style consistency. Use when this capability is needed.

لغة النص الأصلي: الإنجليزية

iptvnator-ui-design

Repository-specific UI design guidance for IPTVnator channel rows, EPG views, settings surfaces, shared selection styles, and light/dark theme consistency. Use when this capability is needed.

لغة النص الأصلي: الإنجليزية

xtream-electron

IPTVnator's Electron-first Xtream implementation, including feature/data-access boundaries, worker-backed DB flows, and Xtream loading/progress UX. Use when this capability is needed.

لغة النص الأصلي: الإنجليزية