# Agent Guidelines for LangGraphGo

## Build/Lint/Test Commands
- `make build` - Build all packages
- `make test` - Run all tests; for single test: `go test -v ./path/to/pkg -run TestName`
- `make test-race` - Run with race detector
- `make lint` - Run golangci-lint (also run `make fmt`, `make vet` before committing)

## Code Style
- Use `make fmt` to format code with gofmt before committing
- Exported types/functions: PascalCase; private: camelCase
- Define errors as package-level variables: `var (ErrX = errors.New("..."))`
- Write godoc comments for all exported identifiers
- Tests: Use table-driven tests with `t.Run()`, `t.Parallel()` where appropriate
- Always check errors (linted by golangci-lint)
- Run `make check` (fmt-check, vet, lint) and `make test` before committing

## Package Overview
- graph: Core graph construction and execution engine with state management
- memory: Various memory strategies for conversational AI applications
- prebuilt: Ready-to-use agent implementations (ReAct, Supervisor, Planning, etc.)
- ptc: Programmatic tool calling using generated code (Python, JavaScript, Shell)
- rag: Retrieval-Augmented Generation with vector and GraphRAG support
- store: Checkpoint storage backends (SQLite, PostgreSQL, Redis)
- tool: Collection of tools for web search, file ops, code execution
- log: Simple leveled logging interface for applications
- adapter: Integration adapters for GoSkills, MCP, and external systems