Skip to main content
prompt GP ChatGPT

gRPC Service taste — ChatGPT prompt: what it does, how to install

The gRPC Service taste prompt for ChatGPT sets design guidelines for gRPC services. It covers .proto schemas, RPC methods, errors, and calls between services.

CC0-1.0 ★ 178,201 updated 2026-10-24

Open on GitHub

What gRPC Service taste does

The prompt gives guidance for designing gRPC APIs: keep .proto schemas in a shared repository, version packages, and never reuse tags from removed fields. It calls for a separate request and response message for each RPC, with field masks for partial updates.

Other guidance covers pagination, deadlines, status codes, and retries limited to idempotent methods. Shared concerns such as logging and authentication belong in interceptors. Schema changes go through buf lint and buf breaking before merge.

For Claude Code, the listed installation path is .claude/commands/prompts.csv.md. The recommendations also cover testing handlers with an in-process server and generated clients.

What it helps with

  • design versioned .proto packages and messages
  • set pagination rules for List RPCs
  • define error handling and retry behavior
  • plan tests for gRPC handlers

Example prompts for the agent

  • Design a billing service .proto schema with a versioned package and suitable RPC methods.
  • Review this gRPC API design for deadlines, status codes, and retry rules.
  • Suggest handler tests using an in-process gRPC server and generated clients.

How to install gRPC Service taste

How to use

Paste the text at the start of a chat or into project instructions

Questions about gRPC Service taste

How do I install gRPC Service taste in Claude Code?

Add the prompt at .claude/commands/prompts.csv.md.

What does gRPC Service taste do?

It provides design guidelines for .proto schemas, RPC methods, errors, security, and gRPC service tests.

How does the prompt handle gRPC API versioning?

It recommends versioned packages such as billing.v1. For incompatible changes, create a v2 package instead of changing the meaning of existing fields.

Source text

prompts.csv · CC0-1.0
# gRPC Service taste of a pragmatic distributed systems engineer
- Keep all .proto files in one shared schema repo or directory with a single owner per package, and generate code from it in CI. Confidence: 0.85
- Lint and check every proto change for breaking changes with buf lint and buf breaking before it can merge. Confidence: 0.90
- Version packages in the name, such as billing.v1, and add a new v2 package instead of changing the meaning of existing fields. Confidence: 0.90
- Never reuse or renumber a field tag, and mark removed fields and names as reserved. Confidence: 0.95
- Give every RPC its own request and response message, even when it starts empty, so fields can be added later. Confidence: 0.90
- Follow the resource-oriented method style of Get, List, Create, Update and Delete instead of ad hoc verbs where it fits. Confidence: 0.75
- Use field masks for partial updates rather than treating unset fields as a request to clear them. Confidence: 0.80
- Paginate every List call with page_size and an opaque page_token, and cap the page size on the server. Confidence: 0.90
- Use well-known types like google.protobuf.Timestamp and Duration instead of raw integers for time values. Confidence: 0.85
- Return the canonical status codes correctly, such as NOT_FOUND, INVALID_ARGUMENT and UNAVAILABLE, and never wrap every failure in UNKNOWN. Confidence: 0.90
- Attach structured error details with the richer error model for validation failures instead of packing them into the message string. Confidence: 0.75
- Require a deadline on every client call and propagate the remaining deadline to downstream calls. Confidence: 0.95
- Retry only idempotent methods, with backoff and a retry budget configured in the service config, not in hand-written loops. Confidence: 0.85
- Pass request IDs, auth tokens and tracing context in metadata, and keep business data in the message body. Confidence: 0.85
- Put logging, auth, metrics and tracing in interceptors instead of repeating them inside each handler. Confidence: 0.90
- Use mutual TLS between internal services and verify per-call credentials on the server for anything sensitive. Confidence: 0.85
- Implement the standard gRPC health checking service and enable server reflection only outside production. Confidence: 0.80
- Prefer unary calls, and use streaming only when the data is truly incremental or long-lived. Confidence: 0.80
- Apply flow control and backpressure on streams, and send keepalive pings within limits the load balancer allows. Confidence: 0.70
- Balance load per request with an L7 proxy or client-side balancing, because HTTP/2 connections pin traffic to one backend. Confidence: 0.85
- Expose a REST or JSON gateway generated from the same protos for browsers and partners instead of maintaining a second API by hand. Confidence: 0.70
- Test handlers with an in-process server and real generated clients rather than mocking the generated stubs. Confidence: 0.80
- Document each service, method and field with comments in the proto file, since that is where readers look first. Confidence: 0.85

© f · CC0-1.0 · f/prompts.chat

Similar prompts

All prompts for Backend and APIs →

From the same set218

The whole set →
Incident Response taste The Incident Response taste prompt for ChatGPT sets out how a calm on-call engineer can handle incidents. It calls for early declaration and coordinated response before the root cause is known. GP ChatGPT ★ 178,201repo stars Nix Dev Environment taste Nix Dev Environment taste — a prompt for ChatGPT configures reproducible Nix development environments with locked dependencies and container builds. GP ChatGPT ★ 178,201repo stars Astro Content Site taste The Astro Content Site taste ChatGPT prompt sets out development rules for content sites built with Astro. It covers rendering, images, SEO, and CI checks. GP ChatGPT ★ 178,201repo stars Phoenix App taste Phoenix App taste — a prompt for ChatGPT, Claude.ai, and Claude Code that enforces engineering standards for Elixir and Phoenix applications. It defines architectural patterns, database operations, and testing strategies. GP ChatGPT ★ 178,201repo stars Spring Boot Service taste ChatGPT prompt Spring Boot Service taste defines architecture standards for Java backend engineering. GP ChatGPT ★ 178,201repo stars Full-Text Search taste Full-Text Search taste — a prompt for ChatGPT that sets out principles for building full-text search. It covers indexing, ranking, access control, and result delivery. GP ChatGPT ★ 178,201repo stars .NET Web API taste .NET Web API taste — a prompt for ChatGPT defines .NET Web API standards for a pragmatic C# engineer. Runs during backend design and code generation. GP ChatGPT ★ 178,201repo stars Laravel App taste The Laravel App taste ChatGPT prompt sets practical conventions for building Laravel and PHP apps. It guides work on controllers, validation, queues, tests, and deployment. GP ChatGPT ★ 178,201repo stars

Project sponsors

Companies that keep this analytics open