AGENTS.md

AGENTS.md

Conventions and guardrails

Guidance for AI agents working in this repository. Keep changes scoped to the target app and follow existing patterns.

• AVOID using arbitrary type checks asRecord, for example:

  ❌const asRecord = (value: unknown): Record<string, unknown> | null => {
  ❌  if (!value || typeof value !== 'object') {
  ❌    return null;
  ❌  }
  ❌  return value as Record<string, unknown>;
  ❌};

• If the input and output data types are unknown, use a placeholder and request the type definitions from the user.
• Xpert API calls in this repository must go through the @xpert-ai/xpert-sdk Client. Do not call Xpert APIs with native fetch, axios, or other ad hoc HTTP clients. If the SDK does not expose the needed endpoint yet, update @xpert-ai/xpert-sdk first and ask the user to use that SDK version.