How to use a Righthand with Neon
Use Righthand to prepare a Neon branch inventory for a development handoff.
Quick answer
Use Righthand to prepare a Neon branch inventory for a development handoff. Branch identity matters because a familiar database name can still refer to the wrong environment.
Start with a reviewable deliverable, keeping Neon as the accepted home for its records. This guide uses an explicitly approved snapshot or browser read; it does not assume that every provider API action is exposed by your Righthand connection.
Evidence and access
Neon documents database branching and branch-specific connection strings. See the official Neon reference. Provider capabilities and Righthand's available tools are separate checks.
Request the approved project's branch inventory, connection context, and read-only query results, retaining branch and environment identity. Verify the required tools and owner-approved scope through Righthand integrations; use the supplied packet when a native read is unavailable.
Define the objects and authority
Include these fields in the working input: project ID, branch ID, parent, environment label, endpoint reference, owner, creation time. These are the requested review columns, not a promise that every provider endpoint returns them under those exact names.
A branch is not a production promotion. Connection strings are credentials and should not be copied into the review brief.
| Responsibility | Owner |
|---|---|
| Prepare source scope and access | Account owner |
| Organize evidence and proposed next steps | Righthand |
| Approve consequential changes | the database operator |
Illustrative first-run brief
Use the owner-provided Neon snapshot or approved read-only view. Review the supplied branch inventory and release plan. Identify branches with unclear owners or environment labels. Prepare a retention discussion without creating or deleting branches. Run once for the agreed sample, using America/Los_Angeles for the review deadline and preserving source timestamps separately. Return the draft in this conversation by Friday at 3 PM Pacific for the database operator to review. Include source references and missing fields. Do not write records, spend money, change permissions, or send external messages. Stop and report an unavailable source rather than substituting another account.
Expected result and verification
A preview branch with no owner is a review candidate, not proof it is disposable. The packet preserves parent and environment context.
Match a branch ID and parent to the accepted project view without exposing secrets. Record the source cutoff, applied filters, and items excluded from the sample. The reviewer should be able to follow each consequential finding back to an original object. A well-written summary is not evidence that a proposed action happened. If a later write is authorized, verify its specific result separately before changing the task's status.
Illustrative input and draft output
These synthetic entries show the requested review, not live account results or a provider field schema.
| Source item | Supplied observation | Draft conclusion |
|---|---|---|
| Branch A | Owner confirms review scope | Use approved results |
| Branch B | Environment ambiguous | Request identity confirmation |
| Query C | Filters missing | Hold record comparison |
Common failure and recovery
A copied label can make two branches look identical. Resolve by immutable branch IDs and approved endpoint references before proposing cleanup.
If a database branch is mistaken for another environment, stop its comparison and ask the owner to confirm the correct branch and connection context.
FAQ
What should the reviewer verify first?
Verify project, branch, database, query scope, and cutoff. A branch that resembles production in name is not proof of production identity.
How should a repeat run be scoped?
Preserve branch identifiers and snapshot dates across reviews. Compare equivalent query contexts and keep branch creation, deletion, and restore actions outside the first run.
For connection and permission details, use Righthand Docs. Review Pricing alongside any separate provider charges before expanding the workflow.