Skip to content

Conversation

@shazarre
Copy link
Collaborator

@shazarre shazarre commented Sep 10, 2025

Description

This PR introduces a simple PR template.

Tested

Not needed for this PR.

How to QA

The template should be picked up in subsequent PRs.

Summary by CodeRabbit

  • Documentation
    • Introduced a standardized pull request template with sections: Description, Tested, and How to QA, each including guidance to help authors provide clear context, evidence of testing, and repeatable QA steps.
    • Improves consistency and completeness of PRs, streamlines reviews, and reduces back-and-forth by prompting for key details up front.
    • No changes to runtime behavior or user-facing functionality.

@coderabbitai
Copy link
Contributor

coderabbitai bot commented Sep 10, 2025

Walkthrough

Introduces a new GitHub pull request template at .github/pull_request_template.md with sections for Description, Tested, and How to QA. No source code or runtime behavior changes.

Changes

Cohort / File(s) Change Summary
PR Template Addition
\.github/pull_request_template.md
Added a static PR description template with sections: Description, Tested, How to QA; includes italicized guidance text.

Estimated code review effort

🎯 1 (Trivial) | ⏱️ ~2 minutes

Pre-merge checks (3 passed)

✅ Passed checks (3 passed)
Check name Status Explanation
Description Check ✅ Passed Check skipped - CodeRabbit’s high-level summary is enabled.
Title Check ✅ Passed The title “chore: create PR template” succinctly and accurately summarizes the main change of introducing a pull request template without extraneous detail or noise.
Docstring Coverage ✅ Passed No functions found in the changes. Docstring coverage check skipped.

Poem

A template sails into our PR sea,
Three headers guiding where details should be.
No code awoke, no tests to run—
Just clearer paths when work is done.
Markdown whispers: “Describe, test, QA,”
So future merges find their way.

Tip

👮 Agentic pre-merge checks are now available in preview!

Pro plan users can now enable pre-merge checks in their settings to enforce checklists before merging PRs.

  • Built-in checks – Quickly apply ready-made checks to enforce title conventions, require pull request descriptions that follow templates, validate linked issues for compliance, and more.
  • Custom agentic checks – Define your own rules using CodeRabbit’s advanced agentic capabilities to enforce organization-specific policies and workflows. For example, you can instruct CodeRabbit’s agent to verify that API documentation is updated whenever API schema files are modified in a PR. Note: Upto 5 custom checks are currently allowed during the preview period. Pricing for this feature will be announced in a few weeks.

Please see the documentation for more information.

Example:

reviews:
  pre_merge_checks:
    custom_checks:
      - name: "Undocumented Breaking Changes"
        mode: "warning"
        instructions: |
          Pass/fail criteria: All breaking changes to public APIs, CLI flags, environment variables, configuration keys, database schemas, or HTTP/GraphQL endpoints must be documented in the "Breaking Change" section of the PR description and in CHANGELOG.md. Exclude purely internal or private changes (e.g., code not exported from package entry points or explicitly marked as internal).

Please share your feedback with us on this Discord post.

✨ Finishing Touches
🧪 Generate unit tests
  • Create PR with unit tests
  • Post copyable unit tests in a comment
  • Commit unit tests in branch shazarre/create-pr-template

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands and usage tips.

Copy link
Contributor

@coderabbitai coderabbitai bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Actionable comments posted: 1

📜 Review details

Configuration used: Path: .coderabbit.yaml

Review profile: CHILL

Plan: Pro

📥 Commits

Reviewing files that changed from the base of the PR and between 1cbabbb and 568b216.

📒 Files selected for processing (1)
  • .github/pull_request_template.md (1 hunks)

Comment on lines +1 to +11
### Description

_A brief description of the changes, what and how is being changed._

### Tested

_Explain how the change has been tested (for example by manual testing, unit tests etc) or why it's not necessary (for example version bump)._

### How to QA

_How can the change be tested in a repeatable manner?_
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

🛠️ Refactor suggestion

Augment template with security, contracts, performance, and rollout sections (critical for RN + TS + smart-contract app).

Missing prompts for security/privacy impact, smart contract changes, breaking changes/migrations, dependency risk, performance/bundle impact, and rollout/monitoring. These are medium-to-high priority for our stack and help prevent costly regressions and on-chain mistakes.

Apply this diff to extend the template:

 ### Description

 _A brief description of the changes, what and how is being changed._

 ### Tested

 _Explain how the change has been tested (for example by manual testing, unit tests etc) or why it's not necessary (for example version bump)._

 ### How to QA

 _How can the change be tested in a repeatable manner?_
+
+### Security & Privacy Impact
+_Auth/permissions scope changes, secret handling, PII/data flows, encryption/storage, attack surface, and security testing performed (e.g., unit, fuzz, SAST)._
+
+### Smart Contract Impact
+_Networks, contract names/addresses, ABI changes, migrations/scripts, upgradability/governance approvals, and links (Etherscan/Blockscout). Risk assessment and roll-forward/back plan._
+
+### Breaking Changes & Migrations
+_Backward compatibility, app/data migration steps (including on-chain/off-chain), and explicit rollback procedure._
+
+### Performance & Bundle Impact
+_Expected impact on startup time, memory/CPU, and JS/native bundle size. Provide before/after metrics where possible._
+
+### Dependencies
+_New/updated/removed deps with versions, rationale, license notes, and security review outcome (advisories)._
+
+### Rollout & Monitoring
+_Feature flags, staged rollout plan, analytics/telemetry events, dashboards/alerts to watch, and kill switch._
+
+### Checklist
+- [ ] No secrets/keys committed; configs per env validated
+- [ ] Tests added/updated and passing (unit/integration/e2e)
+- [ ] iOS and Android builds verified locally/CI
+- [ ] Contract addresses/configs updated for all networks
+- [ ] Release notes/docs updated
📝 Committable suggestion

‼️ IMPORTANT
Carefully review the code before committing. Ensure that it accurately replaces the highlighted code, contains no missing lines, and has no issues with indentation. Thoroughly test & benchmark the code to ensure it meets the requirements.

Suggested change
### Description
_A brief description of the changes, what and how is being changed._
### Tested
_Explain how the change has been tested (for example by manual testing, unit tests etc) or why it's not necessary (for example version bump)._
### How to QA
_How can the change be tested in a repeatable manner?_
### Description
_A brief description of the changes, what and how is being changed._
### Tested
_Explain how the change has been tested (for example by manual testing, unit tests etc) or why it's not necessary (for example version bump)._
### How to QA
_How can the change be tested in a repeatable manner?_
### Security & Privacy Impact
_Auth/permissions scope changes, secret handling, PII/data flows, encryption/storage, attack surface, and security testing performed (e.g., unit, fuzz, SAST)._
### Smart Contract Impact
_Networks, contract names/addresses, ABI changes, migrations/scripts, upgradability/governance approvals, and links (Etherscan/Blockscout). Risk assessment and roll-forward/back plan._
### Breaking Changes & Migrations
_Backward compatibility, app/data migration steps (including on-chain/off-chain), and explicit rollback procedure._
### Performance & Bundle Impact
_Expected impact on startup time, memory/CPU, and JS/native bundle size. Provide before/after metrics where possible._
### Dependencies
_New/updated/removed deps with versions, rationale, license notes, and security review outcome (advisories)._
### Rollout & Monitoring
_Feature flags, staged rollout plan, analytics/telemetry events, dashboards/alerts to watch, and kill switch._
### Checklist
- [ ] No secrets/keys committed; configs per env validated
- [ ] Tests added/updated and passing (unit/integration/e2e)
- [ ] iOS and Android builds verified locally/CI
- [ ] Contract addresses/configs updated for all networks
- [ ] Release notes/docs updated
🤖 Prompt for AI Agents
In .github/pull_request_template.md around lines 1 to 11, the PR template is
missing required prompts for security/privacy impact, smart-contract/on-chain
changes, breaking changes/migrations, dependency risk, performance/bundle
impact, and rollout/monitoring; add new sections to the template titled
"Security & Privacy", "Smart Contract / On‑chain Changes", "Breaking Changes /
Migrations", "Dependencies & Risk", "Performance & Bundle Impact", and "Rollout
& Monitoring" (each with a short prompt to describe impact, mitigation steps,
and required reviewers or post-deploy checks), and update the "How to QA" or
"Tested" areas to reference any additional test steps for those sections so
submitters must explicitly document these aspects.

@aaronmgdr
Copy link
Contributor

looks good to me

@transphorm transphorm changed the base branch from main to dev September 11, 2025 00:51
@transphorm
Copy link
Member

one way to clear this issue to is push another commit to the branch

Screenshot 2025-09-10 at 11 37 13 PM

@@ -0,0 +1,11 @@
### Description
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

nit: can we also add space for a ticket? and a reminder that they can add the ticket number to the title?

ex: SELF-123: New feature

@aaronmgdr
Copy link
Contributor

will need to merge this into dev first since main is blocked

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

4 participants