Skip to main content
manual page/ Reference

Local checks

sourceSource: suspec/docs/reference/local-checks.mdModified: 2026-06-30
Sections
4
Format
Markdown
Order
30 / 156

Suspec core checks are generic.

Project-specific checks belong to the project.

Ownership

LayerOwns
Suspec core CLIgeneric artifact checks
Workspacecommand slots and local policy
Code repobuild, test, lint, typecheck
Local scriptsproject-specific predicates

Core stays portable. Product checks stay local.

Name the predicate

Name checks after what they prove.

AvoidUse
no-regressions-checkbaseline-regression-check
complete-reviewdeclared-scope-coverage
correctness-checkartifact-shape-check

A local script proves only its predicate.

It can prove:

  • declared artifacts exist
  • declared commands ran
  • snapshots match
  • declared scope was touched
  • parseable structure is valid

It cannot prove:

  • no regressions anywhere
  • complete correctness
  • behavior outside the declared evidence path

Anything outside the predicate is Unverified, Blocked, or Human attention.

Honesty level

Mark local checks honestly:

  • convention
  • checklist
  • toolable
  • enforced by this team's gate

If a script cannot run, it returns Unverified or Blocked. It does not guess Pass.

Starter kit: Set up a workspace