القائمة
Global patterns for the Metaboost repo (API + Next.js app). Use when starting work in the repo or when applying repo-wide code quality, structure, or plan conventions.
التثبيت باستخدام Codex أو Claude انسخ هذا Prompt والصقه في Codex أو Claude أو مساعد آخر ليراجع صفحة Skill ويثبّتها لك.
استنادا إلى تصنيف SOC المهني
Canonical linear DB migrations under infra/k8s/base/ops/source/database/linear-migrations, ops bundles, env keys, and runners. Use when adding or changing SQL migrations, K8s DB bootstrap, or scripts/database in this repo.
When an E2E test verifies a specific element, pass it to the capture helper so the step screenshot is taken with that element vertically centered.
Create and use Metaboost git worktrees in sibling directories named metaboost_<branch_slug> (underscores). Use when starting feature work, moving WIP off the main checkout, or opening the correct worktree path for a branch.
Distributed tracing and OTLP export patterns. Use when adding trace context, log correlation, or Observability env — after Metaboost adopts a shared observability package.
When you finish a plan file in active/, automatically move it to completed/. If it's the last plan in its set, move the whole set. Use when completing any plan under .llm/plans/active/.
User vocabulary abcmemory and abcremember — where Cursor guidance lives and how to persist new instructions. Use when the user says abcmemory or abcremember.
| name | metaboost-global-patterns |
| description | Global patterns for the Metaboost repo (API + Next.js app). Use when starting work in the repo or when applying repo-wide code quality, structure, or plan conventions. |
| version | 1.1.2 |
apps/api/ – Standalone Express HTTP APIapps/web/ – Next.js appapps/web/sidecar/ – Runtime-config server for the Next.js apptsconfig.base.json in apps. Use ESM (NodeNext). Avoid type assertions (as) when a better approach exists.export default in ordinary modules when a named export works. See .cursor/skills/prefer-named-exports/SKILL.md (Next.js page defaults excepted)..llm/plans/active/ (not .cursor/plans/).*.scss / *.css, do not use second-argument fallbacks with var() — see .cursor/rules/css-custom-properties-no-var-fallbacks.mdc. Tokens live under packages/ui/src/styles/ (e.g. _themes.scss).=== / !== only). Semicolons in JS/TS. Prefer import type for type-only imports.lib/validation.ts) when they are already exported by a shared package (e.g. @metaboost/helpers). Callers should import from the canonical source; unnecessary re-exports add indirection and maintenance cost.catch { ... } (no variable). Put at least one comment inside the block when swallowing errors so ESLint no-empty passes. See .cursor/skills/catch-unused-error/SKILL.md._unused. See .cursor/skills/avoid-unused-props-vars/SKILL.md.undefined explicitly to components. Allow null as a value for optional props so callers can pass prop={value} directly; components treat null (and undefined) as "not set" / default behavior. When checking optional string props (e.g. error messages) for "has value", use a simple falsy check (Boolean(value) or if (value)) instead of explicit !== undefined && !== null && !== ''.style={{ ... }} for layout or appearance. Use CSS classes instead: component or page SCSS modules (e.g. ComponentName.module.scss), or shared utility classes where appropriate. Keeps styling maintainable and consistent.make e2e_test_web, npm run test, make e2e_test_web_signup_enabled) during agent or plan implementation work.bash block so the user can copy and run them.