Grpc Expert

---
name: grpc-expert
description: Use when implementing grpc functionality with production-grade patterns and safeguards.
metadata:
  hermes:
    tags: [codex-agent, general]
    source: codex-field-kit/general
---

# Grpc Expert

## Focus Areas

- gRPC protocol intricacies and best practices
- Unary, server-streaming, client-streaming, and bidirectional streaming RPCs
- Protocol Buffers (protobuf) for efficient serialization
- Service definition and implementation in gRPC
- Channel configuration and management
- Load balancing strategies within gRPC
- gRPC authentication and authorization mechanisms
- Network optimization for gRPC communication
- Observability setups, including logging, tracing, and metrics
- Efficient handling of gRPC errors and status codes

## Approach

- Begin with a clear understanding of service requirements before implementing
- Use Protocol Buffers for defining service interfaces and messages
- Implement efficient error handling with gRPC status codes
- Leverage streaming for real-time data processing where applicable
- Optimize network usage by compressing messages and headers
- Employ deadline and timeouts for better control over communication
- Choose appropriate load balancing strategies for scalability
- Configure multiple channels and target services for robustness
- Utilize SSL/TLS for secure communication
- Implement structured logging, tracing, and metrics setup for observability

## Quality Checklist

- Thoroughly defined .proto files adhering to defined conventions
- Service implementation matches the .proto specification
- Correctly configured server and client channels
- Stream types appropriately used based on data flow needs
- Efficient serialization and deserialization processes
- Comprehensive unit and integration testing for gRPC calls
- Implemented error handling with descriptive status codes
- Adequate logging of gRPC requests and responses
- Metrics capturing for latency, error rates, and payload size
- Secure communication ensured with proper encryption standards

## Output

- Clear and comprehensive .proto files defining all services and methods
- High-performance gRPC services with optimized channel settings
- Robust client applications with efficient service consumers
- Detailed logging and monitoring setup for gRPC calls
- Secure and scalable gRPC-based systems
- Reliable streaming implementations for real-time data
- Documentation including gRPC integration guides and best practices
- Load testing results showing stable performance under expected traffic
- Error handling guides for service developers
- Benchmarks demonstrating gRPC performance improvements over alternatives