Skip to content

AGENTS.md

Latest commit

 

History

History
110 lines (99 loc) · 3.15 KB

AGENTS.md

File metadata and controls

110 lines (99 loc) · 3.15 KB

AGENTS.md

Goals

  • Avoid clarification loops by proposing a concrete interpretation when details are missing.
  • Default to the language of the user's initial message unless they explicitly request a different language.
  • Match the tone and formality of the user's initial message unless they explicitly ask for a change.
  • Treat a language switch in the user's message as an explicit request to respond in that language.
  • If a message is mixed-language, reply in the dominant language unless the user specifies otherwise.

Purpose

This file defines practical instructions for working in the @retailcrm/embed-ui repository.

Repository Structure

  • This project is a Yarn Workspaces monorepo.
  • Workspace glob: packages/*.
  • Current workspace folders:
    • v1-components
    • v1-contexts
    • v1-testing
    • v1-types
  • Workspace package names may differ from folder names, but commit scopes in this repository are based on workspace folder names.

Local Environment Prerequisites

  • Yarn version is 4.12.0 (see packageManager in package.json and yarnPath in .yarnrc.yml).
  • Package manager mode is node-modules (see .yarnrc.yml).
  • Local Yarn config is generated from .yarnrc.dist.yml using:
make .yarnrc.yml
  • Root install:
yarn install

Running Checks

Local Path (without Docker)

  • Prepare Yarn config:
make .yarnrc.yml
  • Install dependencies:
yarn install
  • Build all workspaces:
yarn workspaces foreach -A --topological-dev run build
  • Run lint:
yarn eslint
  • Run tests:
yarn test

Docker Path (Makefile)

  • Install dependencies in container:
make node_modules
  • Build all workspaces:
make build
  • Run tests:
make tests
  • Pass custom Vitest CLI arguments via Makefile:
make tests cli="-t outOfRangeErrorText"

Related Commands

  • Build root package only:
yarn build
  • Build root code artifacts only:
yarn build:code
  • Build root meta artifacts only:
yarn build:meta
  • Build Storybook for v1-components:
yarn workspace @retailcrm/embed-ui-v1-components run storybook:build

Commit Workflow

  • Before creating commits, you must read skills/commit-workflow/SKILL.md and follow its rules.

Skills

  • Repository-local skills are available under skills/.
  • If a skill conflicts with this file, follow AGENTS.md.
  • Current local skills:
    • skills/commit-workflow/SKILL.md
    • skills/sync-remote-host-registry/SKILL.md
    • skills/yarn-lock-conflict-resolution/SKILL.md

Notes

  • Do not assume legacy rules from other repositories (especially omnica) apply here.
  • Keep imports grouped by type-only, external, internal alias, and relative blocks, separated from each other and alphabetized within each block: this improves scanability and reduces merge conflicts when multiple PRs add imports to the same file.
  • When resolving lint issues, prefer running eslint with --fix first to avoid manual import reshuffling and unnecessary reading of repository-specific lint rules.
  • If repository policy is unclear, ask a short clarifying question before making irreversible actions.