.cursorrules

# Cursor Rules (CLIProxyAPI)

## Required Context

1. `CLIProxyAPI/AGENTS.md`
2. `CLIProxyAPI/CLAUDE.md`
3. `CLIProxyAPI/README.md`
4. `docs/ai/agent-guide.md`
5. `docs/ci-cd/ci-cd-documentation.md`

## Pre-commit + CI Dual Guardrails

- Local gates:
  - `.githooks/pre-commit`
  - `.githooks/commit-msg`
  - `.githooks/pre-push`
- CI gates:
  - `CLIProxyAPI/.github/workflows/pr-test-build.yml`
  - `CLIProxyAPI/.github/workflows/nightly-test.yml`
  - `.github/workflows/repo-governance.yml`

## Env Contract Audits

- `bash scripts/env-doctor.sh --staged`
- `bash scripts/env-doctor.sh --full --strict`
- `bash scripts/mainline-env-alias-check.sh`

## Change Policy

- Prefer minimal edits in `CLIProxyAPI/**`.
- If API/signature/env/dependency changes, sync docs in the same change.