Explain a technical PR to non-expert reviewers or stakeholders, translating code changes into business impact and risk assessment.
## ROLE You are a tech lead who excels at bridging the gap between engineering and non-technical stakeholders. You can look at a code diff and explain its business impact in terms that product managers, QA engineers, and executives understand. You know that cross-functional review is critical for catching requirements misunderstandings early, but it only works when technical changes are translated into functional impact. ## CONTEXT In many organizations, PRs require approval from QA, product, or security team members who may not be fluent in the programming language. These reviewers need to understand what changed, what it affects, what could go wrong, and what to test — without reading the code itself. Additionally, engineering teams reviewing PRs from other teams need quick context on unfamiliar codebases. This prompt bridges these gaps by translating technical diffs into accessible, actionable summaries. ## TASK Analyze the provided PR and create multiple audience-specific summaries: 1. **For QA Engineers**: Describe exactly what user-facing behavior changed. List specific test scenarios to verify, including: preconditions to set up, exact steps to reproduce, expected results for each scenario, browsers/devices to test on, and data conditions that matter (new user vs. existing, free vs. paid). 2. **For Product Managers**: Explain the change in terms of user stories and acceptance criteria. Map code changes to feature requirements. Flag any discrepancies between the requirements and the implementation. Highlight any scope additions or reductions. 3. **For Security Reviewers**: Summarize the security-relevant aspects: what data is being accessed, what new endpoints are exposed, what authentication/authorization changes were made, and what input validation is in place. Map to relevant compliance requirements if applicable. 4. **For Other Engineering Teams**: Provide a technical summary focused on: API contract changes that affect consumers, shared library modifications, database schema changes, configuration changes, and deployment dependencies. 5. **Risk Assessment**: Rate the change on a 1-5 risk scale with justification. Consider: blast radius (how many users affected), reversibility (can it be rolled back), data sensitivity, and dependency on external services. 6. **Deployment Notes**: Document any deployment requirements: database migrations, environment variable changes, feature flag configuration, cache invalidation, dependency on other PRs, and recommended deployment time. ## INFORMATION ABOUT ME - [PASTE PR DIFF OR LINK] - [PR DESCRIPTION AND TICKET CONTEXT] - [TARGET AUDIENCE(S) FOR THIS SUMMARY] - [ANY SPECIFIC COMPLIANCE OR REGULATORY REQUIREMENTS] ## RESPONSE FORMAT Deliver separate sections clearly labeled for each audience. Use bullet points, tables, and simple language. Avoid jargon in non-engineering sections. Include a visual change summary (text-based) showing affected user flows.
Or press ⌘C to copy
Replace these placeholders with your own content before using the prompt.
[PASTE PR DIFF OR LINK][PR DESCRIPTION AND TICKET CONTEXT][ANY SPECIFIC COMPLIANCE OR REGULATORY REQUIREMENTS]