The Sanctra workflow

Five clear steps from a repository to a reviewable pull request.

Sanctra is deliberate. Every stage is transparent, every artifact is inspectable, and nothing modifies your default branch without your explicit review.

01Connect

Install the GitHub App on the repos you choose.

OAuth into Sanctra, install the GitHub App with least-privilege scopes, and pick exactly which repositories Sanctra can see. Access is per-installation and revocable at any time.

    OAuth 2.0 sign-inPer-repo installationRead-only by default
Installation
acme/apigranted
acme/dashboardgranted
acme/marketingskipped
02Analyze

Sanctra reads the repository and reports what it found.

A sparse checkout inspects your package files, lockfiles, existing Dockerfiles, workflows, env hints, and folder shape. You get a health score, detected stack, and a ranked list of findings — each backed by evidence.

    Stack detectionHealth scoreEvidence-backed findings
analysis · acme/api
# sparse checkout · scanning
stack: Node.js 22 · Fastify · Postgres
health: 62/100
4 recommendations · 2 unknowns
03Review

Recommendations you can question, dismiss, or defer.

Each recommendation carries severity, effort, and the files it applies to. Include what you want in the generation pass; skip the rest with an optional reason kept in history.

    Severity + effortOptional dismissalHistory preserved
Recommendations
  • Missing container health checkdanger
  • No CI workflow presentwarning
  • Env vars undocumentedwarning
  • Add DEPLOYMENT.mdneutral
04Generate

Preview the exact files before any commit.

The generation wizard shows a file tree, code diff, and validation results. Errors block PR creation; warnings require explicit acknowledgment. Nothing writes to your default branch.

    File tree + diffValidators run firstWarnings gated
preview · pr #142
+ .github/workflows/deploy.yml 58 lines
+ Dockerfile 32 lines
+ .env.example 12 lines
+ DEPLOYMENT.md 74 lines
validators passed · 0 warnings
05Merge

Sanctra opens a branch and PR. You merge.

A Sanctra branch appears in GitHub with the generated files, a summary description, and links back to the analysis. Review it like any other PR. Merge on your schedule.

    Branch + PR openedTraceable summaryNo auto-merge, ever
Pull request
Merge#142
chore(sanctra): production-ready infra
by sanctra-app · 4 files changed · +176 −0

Want to see it on your own repo?

Request access to the private beta.

Request early access →