SKILL.md
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
- 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.X and ??% - warning-level reporting for leftover template filler text such as Describe the need or Add context and constraints - warning-level reporting for generic Mermaid scaffolds or missing/stale %% logics-signature comments 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