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
- A title that is not
# <number> <imperative title>, a title over nine words, or one that opens with a gerund. - Any of the five sections missing, or present out of order:
objective,granted,evidence,marked,time. - An objective with more than one sentence or over 40 words.
- A
grantedline that does not say what is granted and what is withheld. - Evidence that names no concrete artefact - a blob, query, record, hash, subject, policy, count or similar.
- A
markedline too short to say what a pass looks like. - A
timeline without a number and a unit. - Banned words: leverage, synergy, cutting-edge, world-class, best-in-class, passionate.
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.
Elsewhere · Services · Academy · Labs · Standards
Breachcraft Security · Evilsaint Ltd · hello@breachcraftsecurity.com