Righthand
← All posts

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.

ResponsibilityOwner
Prepare source scope and accessAccount owner
Organize evidence and proposed next stepsRighthand
Approve consequential changesthe 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 itemSupplied observationDraft conclusion
Branch AOwner confirms review scopeUse approved results
Branch BEnvironment ambiguousRequest identity confirmation
Query CFilters missingHold 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.