AI agent config files: AGENTS.md, CLAUDE.md, Cursor rules and the rest

# AGENTS.md

## Project
One paragraph: what this repository does and who uses it.

## Commands
- Install: `pnpm install`
- Dev server: `pnpm dev`
- Tests: `pnpm test` (run before you finish)
- Lint and types: `pnpm lint && pnpm typecheck`

## Layout
- `src/app/`: routes and pages
- `src/lib/`: shared logic, no UI code
- `tests/`: mirrors `src/`

## Conventions
- TypeScript strict mode; avoid `any`.
- Follow the patterns already in `src/` before adding new ones.
- Small, focused functions; name things for what they do.

## Boundaries
- Never read or edit `.env*` files or commit secrets.
- Ask before adding a dependency or changing a public API.

## Done means
Tests pass, lint is clean, and the change is explained in the PR description.

# AGENTS.md

## Project
One paragraph: what this package does.

## Commands
- Set up: `uv sync`
- Tests: `uv run pytest -q`
- Lint and format: `uv run ruff check . && uv run ruff format .`
- Types: `uv run mypy src`

## Conventions
- Python 3.12; type hints on every public function.
- Use `pathlib`, f-strings and dataclasses; no new global state.
- Tests live in `tests/` and name the behaviour they check.

## Boundaries
- Don't touch `migrations/` without asking.
- Never print or log secrets; config comes from environment variables.

# API package

Applies to everything under `packages/api/`, on top of the root AGENTS.md.

- Run `pnpm --filter api test` instead of the full test suite.
- Handlers live in `src/routes/`, one file per resource.
- Validate every request body with the schemas in `src/schemas/`.
- Database access only through `src/db/`; no raw SQL in handlers.

@AGENTS.md

## Claude Code
- For changes that touch several files, outline the plan first and wait for a go-ahead.
- After editing, run the test command from AGENTS.md and fix failures before you stop.

---
paths:
  - "src/api/**/*.ts"
---

# API rules
- Every endpoint validates its input and returns typed errors.
- Add or update the matching test in `tests/api/`.

{
  "$schema": "https://json.schemastore.org/claude-code-settings.json",
  "permissions": {
    "allow": [
      "Bash(npm run lint)",
      "Bash(npm run test *)"
    ],
    "deny": [
      "Read(./.env)",
      "Read(./.env.*)"
    ]
  }
}

---
description: Conventions for React components
globs: src/components/**/*.tsx
alwaysApply: false
---

- Function components with named exports.
- Props type named `<Component>Props`, declared above the component.
- Styling with the existing Tailwind classes; no inline style objects.
- Each new component gets a test next to it.

This is a Next.js app written in TypeScript.

- Build with `pnpm build`; test with `pnpm test`.
- Put shared logic in `src/lib/`, never in components.
- Prefer server components; add "use client" only when needed.
- In pull requests, explain the why, and list anything that still needs a human check.

---
applyTo: "**/*.test.ts,**/*.spec.ts"
---

- Use Vitest's `describe` and `it`.
- One behaviour per test, named after the behaviour.
- Mock network calls; never call real APIs from tests.

# Folders without AGENTS.md: read these names instead
project_doc_fallback_filenames = ["TEAM_GUIDE.md", ".agents.md"]
# Raise the 32 KiB cap on combined instructions
project_doc_max_bytes = 65536

{
  "context": {
    "fileName": ["AGENTS.md", "GEMINI.md"]
  }
}

---
trigger: glob
globs: "**/*.test.ts"
---

- Use the helpers in `tests/utils/`; don't build fixtures by hand.
- Each test checks one behaviour.

---
inclusion: fileMatch
fileMatchPattern: "src/api/**/*.ts"
---

# API standards
- REST resources are plural nouns; errors use the shared error type.
- Every endpoint has an integration test.

read:
  - AGENTS.md
  - CONVENTIONS.md

{
  "instructions": ["CONTRIBUTING.md", "docs/guidelines.md", ".cursor/rules/*.md"]
}