Skip to content

Start Here in 5 Minutes (fast path)

If you only have a few minutes, use this page and run the canonical commands exactly in this order.

Goal

Get a deterministic ship/no-ship signal with machine-readable artifacts in one short loop.

5-minute flow

python -m sdetkit gate fast --format json --stable-json --out build/gate-fast.json
python -m sdetkit gate release --format json --out build/release-preflight.json
python -m sdetkit doctor

What to check first

  1. build/release-preflight.json:
  2. ok
  3. failed_steps
  4. If failed_steps contains gate_fast, inspect build/gate-fast.json:
  5. ok
  6. failed_steps
  7. Use terminal logs only after artifact triage.

Generate a concise reviewer-ready summary from artifacts:

make gate-decision-summary

This writes: - build/gate-decision-summary.json - build/gate-decision-summary.md

Use the markdown file in PR/release notes so teams review evidence, not only command output.

Validate summary contract (recommended for CI/local guardrails):

make gate-decision-summary-contract

Next steps