AGENTS.md

Agent Workflow

Follow these guidelines when editing this repository.

Commands

• Build SDK: turbo build --filter '@giselle-sdk/*' --filter giselle-sdk --cache=local:rw
  • Add --filter <package> to build specific packages.
• Check Types: turbo check-types --cache=local:rw
  • Use --filter <package> for package-level checks.
• Format: turbo format --cache=local:rw
  • Prefer pnpm biome check --write [filename] for individual files.
• Test: turbo test --cache=local:rw
  • Run pnpm -F <package> test for package-level tests.

Formatting

• Run pnpm biome check --write [filename] after every code change.
• All code must be formatted with Biome before commit.

Style

• Use TypeScript and avoid any.
• Components should use React hooks and Next.js patterns.
• Follow package-based architecture.
• Use async/await and proper error handling.
• Tests use Vitest with *.test.ts naming.

Naming

• Files: kebab-case.
• Components: PascalCase.
• Variables/functions: camelCase.
• Booleans and functions use is, has, can, should prefixes.
• Function names should clearly indicate purpose.

Communication

• Correct grammar in commit messages, code comments, and PR comments.
• Git branch names must always be written in English.