BreachcraftSecurity

CI green · 15-test offline suite · 21 Nov 2026

brief-lint

Refuse the brief before a candidate meets it.

A lab brief is markable or it is filler. This checks the shape and the parts that decide a mark, and exits non-zero so CI can hold the line.

Usage

python -m breachcraft_tools.brief_lint path/to/brief.md [--json]

Exit 0 clean, 1 problems, 2 usage. No third-party packages.

What it refuses

Why each one exists

A brief that fails any of these turns into a discussion at marking time: whose objective was it, what counts as evidence, what does a pass look like. The linter moves that discussion to authoring, where it is cheap.

Limits, stated so a pass is not over-read

It is a shape check, not a judgement. A brief can pass and still be dull, mispriced or aimed at the wrong level. It reads one file at a time and does not know the track, the prerequisites or whether the evidence is actually obtainable in the tenant.

Private, all rights reserved. Source and licence note on request; nothing here is a published release.

All tools →

Elsewhere · Services · Academy · Labs · Standards

Breachcraft Security · Evilsaint Ltd · hello@breachcraftsecurity.com