# Agent Instructions

## Project Context
Go microservices monorepo using Bazel for builds.

## Build & Test
- Build all: bazel build //...
- Test all: bazel test //...
- Integration tests: docker compose up -d && bazel test //integration/...
- Lint: golangci-lint run ./...

## Code Conventions
- All services follow standard layout in /cmd and /internal
- Use structured logging with slog
- Error wrapping with fmt.Errorf("op: %w", err)
- See @docs/api-style-guide.md for API conventions

## Cross-Repo References
- Shared proto definitions in sourcegraph/proto
- Common Go libraries in sourcegraph/lib

## Security
- Never log sensitive data (tokens, passwords, PII)
- All external inputs must be validated
- Use parameterized queries for database access

# Project Rules

## Stack
- TypeScript 5.x with strict mode
- React 19 + Next.js 15 (App Router)
- Tailwind CSS v4 for styling
- Drizzle ORM for database access

## Code Standards
- Named exports only (no default exports)
- Prefer `const` assertions and satisfies operator
- Use Result<T, E> pattern for error handling
- Maximum 30 lines per function

## File Organization
- Colocate tests: `foo.ts` → `foo.test.ts`
- One component per file
- Barrel exports (index.ts) for public module APIs

## Git
- Conventional commits: feat|fix|chore|docs|test
- Squash merge feature branches
- Branch naming: type/description