tomevault-io Lint Logics docs
Run
python logics/skills/logics-doc-linter/scripts/logics_lint.py
python logics/skills/logics-doc-linter/scripts/logics_lint.py --require-status
What it checks
- Filename patterns (
req_###_*.md,item_###_*.md,task_###_*.md,prod_###_*.md,adr_###_*.md). - First heading format:
## <doc_ref> - <Title>. - Required indicators:
- requests:
From version,Understanding,Confidence - backlog/tasks: plus
Progress
- requests:
- product briefs:
Date,Status, related refs,Reminder - architecture docs:
Date,Status,Drivers, related refs,Reminder Statusvalue validation when present using the allowed values for each doc family.- Optional strict mode (
--require-status) to enforceStatuson every supported doc type. - For modified or untracked workflow docs (
request,backlog,task):- blocking errors for critical indicator placeholders such as
X.X.Xand??% - warning-level reporting for leftover template filler text such as
Describe the needorAdd context and constraints - warning-level reporting for generic Mermaid scaffolds or missing/stale
%% logics-signaturecomments in workflow Mermaid blocks - if a doc edit is explicitly non-semantic, add a marker such as
> Maintenance edit:or> Non-semantic edit:in the doc so the linter can keep indicators stable without guessing intent
- blocking errors for critical indicator placeholders such as
Converted and distributed by TomeVault — claim your Tome and manage your conversions.