# 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

---
description: React component conventions and patterns
globs: "*.tsx,*.jsx"
alwaysApply: false
---
# React Component Rules

1. Use functional components with TypeScript interfaces for props
2. Prefer server components by default — add "use client" only for interactivity
3. Colocate component tests in adjacent __tests__/ directories
4. Use named exports, not default exports
5. Extract custom hooks into hooks/ directory when reused across components

## Styling
- Use Tailwind CSS v4 utility classes
- Follow mobile-first responsive design
- Keep component-specific styles colocated

## State Management
- Use React 19 use() for async data in server components
- Prefer URL state (searchParams) over client state where possible
- Use Zustand for complex client-side state