Skip to main content
CodingArchitectureadvanced

Engineering RFC & Technical Design Document Author

Author comprehensive Request for Comments (RFC) documents detailing alternatives considered, trade-offs, and rollout risks.

Compatibility & Specs

Compatible AI Models
ClaudeChatGPTGemini
Last UpdatedApr 1, 2026
Customizable Variables5 parameters

How to Use This Prompt

Follow this 3-step workflow to extract high-signal responses from any compatible AI model.

01

1. Tailor the Parameters

Use the interactive customizer above to substitute the bracketed placeholders with your exact context, requirements, and constraints.

02

2. Send to AI Model

Copy the prompt and paste it into Claude, ChatGPT, Gemini, or Copilot. These models follow structured multi-step constraints reliably.

03

3. Review and Iterate

Review the output against the verified benchmark below. Follow up in the conversation to stress-test edge cases or refine tone.

Prompt Variables & Parameters

Reference breakdown of every dynamic variable embedded in this prompt template.

PlaceholderParameter NameTypeStatusDescription & Guidance
[initiative_title]Initiative TitletextRequiredDescriptive name of the RFCDefault: RFC-089: Distributed Webhook Delivery & Event Retry Engine
[problem_statement]Problem Statement & FrictiontextareaRequiredWhy current architecture is failingDefault: Currently, third-party partner webhooks are dispatched synchronously inside our main HTTP checkout thread. When customer endpoints time out or return 500 errors, our worker threads stall, causing checkout thread pool exhaustion and message loss.
[proposed_solution]Proposed Technical SolutiontextareaRequiredYour intended architectural designDefault: Decouple webhook dispatching into an asynchronous event-driven queue powered by Redis Streams and background worker pods using exponential backoff with jitter and a Dead-Letter Queue (DLQ).
[alternatives_considered]Alternatives ConsideredtextareaRequiredOther options and why they were not chosenDefault: Alternative 1: Managed SaaS (Svix) - Rejected due to data residency compliance requirements. Alternative 2: Dedicated Kafka cluster - Rejected due to disproportionate operational maintenance overhead.
[non_goals]Explicit Non-GoalstextareaOptionalWhat this project deliberately will NOT solveDefault: 1. Not building a self-service customer UI for viewing webhook logs in this phase; 2. Not supporting custom payload encryption keys beyond standard HMAC-SHA256 signatures.

Example Execution & Benchmark Output

Sample input arguments and the verified AI response demonstrating expected quality and formatting.

Sample VariablesInputs
[initiative_title]
RFC-089: Distributed Webhook Delivery & Event Retry Engine
[problem_statement]
Currently, third-party partner webhooks are dispatched synchronously inside our main HTTP checkout thread. When customer endpoints time out or return 500 errors, our worker threads stall, causing checkout thread pool exhaustion and message loss.
[proposed_solution]
Decouple webhook dispatching into an asynchronous event-driven queue powered by Redis Streams and background worker pods using exponential backoff with jitter and a Dead-Letter Queue (DLQ).
[alternatives_considered]
Alternative 1: Managed SaaS (Svix) - Rejected due to data residency compliance requirements. Alternative 2: Dedicated Kafka cluster - Rejected due to disproportionate operational maintenance overhead.
[non_goals]
1. Not building a self-service customer UI for viewing webhook logs in this phase; 2. Not supporting custom payload encryption keys beyond standard HMAC-SHA256 signatures.
Expected AI ResponseVerified Result
### RFC-089: Distributed Webhook Delivery & Event Retry Engine **Status:** DRAFT | **Author:** Staff Infrastructure Engineer | **Target Date:** Q3 ### 1. Context & Problem Statement Today, third-party webhook dispatches are coupled directly to the HTTP checkout request lifecycle. If a customer webhook endpoint hangs for 15 seconds, our application thread remains blocked. During a partner outage on Aug 14, 180 worker threads were consumed waiting on dead endpoints, triggering a cascade of 504 Gateway Timeouts across unrelated API routes. ### 2. Goals & Non-Goals - **Goal:** Guarantee sub-5ms return time for internal events by decoupling dispatch asynchronously. - **Goal:** Provide guaranteed at-least-once delivery with exponential backoff (1m, 5m, 30m, 2h, 24h). - **Non-Goal:** Customer-facing payload inspection UI (deferred to RFC-094). ### 5. Alternatives Considered & Rejection Rationale - **Svix (Third-Party Managed Service):** Would save 4 weeks of engineering effort, but requires routing sensitive EU customer metadata through a third-party multi-tenant cloud, conflicting with our HIPAA/GDPR vendor compliance boundaries. - **Apache Kafka:** Provides higher throughput, but introduces ZooKeeper/KRaft operational burden that our 8-person team cannot sustainably maintain.

Best Use Cases

Scenarios and roles where this prompt produces maximum leverage.

Staff and Senior engineers pitching major infrastructure changes to leadership
Engineering teams establishing institutional RFC templates for architectural governance
Developers proposing significant database migrations or third-party service deprecations

Tips for Best Results

Techniques to elevate response fidelity

  • •Provide rich background context rather than one-sentence inputs to receive deep, non-generic responses.
  • •Engage in multi-turn conversation: use the initial output as a baseline, then ask the AI to sharpen specific sections.
  • •Prompt the model to highlight any hidden assumptions or missing trade-offs in its recommendations.

Common Mistakes to Avoid

Frequent failure modes and anti-patterns

  • •Giving minimal context and expecting nuanced, expert-level strategic output.
  • •Not validating factual references, citations, or statistical claims with verified primary sources.
  • •Skipping the customization step and pasting raw bracketed template variables into the AI chat.

Part of Curated Collections

This prompt is sequenced as part of these goal-oriented workflows

View all collections

Related AI Prompts

Complementary workflows in Coding

View all Coding prompts
Codingadvanced

Principal Code Reviewer & Architecture Auditor

Conduct rigorous architectural code reviews identifying memory leaks, race conditions, and typing holes.

claudechatgptcopilot
#code-review#clean-code#architecture
Codingadvanced

Pragmatic REST & GraphQL API Contract Architect

Design robust, backwards-compatible API contracts with clean error schemas, pagination, and idempotency keys.

claudechatgptgemini
#api-design#rest-api#graphql
Codingadvanced

Monolith to Modular Decoupling & Boundary Architect

Carve clear bounded contexts out of entangled monoliths using the Strangler Fig pattern and event-driven seams.

claudechatgptgemini
#software-architecture#refactoring#monolith-to-microservices

Related Engineering Guides

Deep-dive playbooks and system prompt methodologies for Coding

View all guides