# AGENTS.md

## Purpose

This repository is for Indek, a COD-native courier operations platform. Agents working here should preserve the product framing and keep code and docs aligned.

## Project Conventions

- Keep product docs under `docs/`.
- Keep product-spec documents in `docs/product/`.
- Keep execution and sequencing docs in `docs/planning/`.
- Prefer updating the relevant docs when product language, workflows, or architecture change.

## Codebase Shape

- `apps/web` contains the Next.js application.
- `packages/shared` contains shared types.
- `packages/domain` contains domain selectors and business logic.
- `packages/db` contains seed data and database-facing code.

## Naming

- The product name is `Indek`.
- Use the workspace package scope `@indek/*`.
- Treat phrases like "dispatch board" as workflow terminology, not product branding.

## Working Style

- Make focused changes.
- Keep imports and package metadata consistent when renaming shared modules.
- Run `pnpm typecheck` after meaningful TypeScript or path changes.
- Update docs when moving files so references do not drift.