Schema 1.6, all fields optional (D-0014): - F7 review: `review: draft|reviewed|needs_update`, `reviewed_by`, `reviewed_on`; lint check 17 and a review queue; ckb-lint marks reviews - F4 `> CONTRADICTION:` marker, lint check 18; validity dates deferred - F21 `tags` against the new `wiki/tags.md`, lint check 19, retrieve_candidates.py --tag, DRAFT/NEEDS_UPDATE flags - F9 profiles in workload/profiles/, protected `## Rules` on project scope pages, precedence AGENTS.md > Rules > profile - F8 explicit lessons (profile or wiki/lessons.md); new ckb-profile skill Carry-over: `.secrets-allow` `<glob> match:<hash>` entries (also in the bash/PowerShell fallbacks); open threads no longer print twice. ckb-upgrade migrates 1.5 -> 1.6; init/reset know tags.md; Starlight shows review and tags. Smoke test covers a 1.6 KB. Docs in EN and PL. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
3.6 KiB
3.6 KiB
Manual lint checklist (no-Python path)
Use only when no Python interpreter is available (see "Scripts and the
Python Runtime" in AGENTS.md). This reproduces the detection that
scripts/lint_report.py does mechanically; the numbered checks in
SKILL.md still say what each finding means and what to do about it.
Work wiki/ first, then each connector-backed libs/<name>/ (has
source.yaml). Skip index.md and log.md everywhere. Scope the run and
say what was skipped — by hand, this costs tokens.
| # | Check | How to detect by hand |
|---|---|---|
| 1 | Conformance | rg -L --files-without-match '^---$' wiki -g '*.md' -g '!index.md' -g '!log.md' lists pages with no frontmatter. For the rest, open the frontmatter: must be flat key: value lines, closed by ---, with a non-empty type. lint_quick.sh/.ps1 counts these. |
| 2 | Freshness | `rg -n '^(last_updated |
| 3 | Confidence | rg -n '^confidence:' wiki — flag values outside 0.0–1.0 or non-numeric; then apply the decay rule from check 3 to pages older than their window. |
| 4 | Retention | rg -n '^retention: low' wiki and check each page's age against check 4's archive threshold. |
| 5 | Decisions | For each wiki/decisions/NNNN-*.md: status ∈ proposed/accepted/rejected/superseded/reversed; decided_on and decided_by present; every supersedes has a matching superseded_by on the target (`rg -n '^(supersedes |
| 6 | Orphans | For each page, rg -l '<page-slug>' wiki — a page nothing links to (outside its own directory index) is an orphan. Do this only for pages touched since the last lint unless asked for a full pass. |
| 7 | Graph | `rg -o '"(from |
| 8 | Index / log | Every page appears in its directory index.md; every file in git log --since=<last lint> --name-only -- wiki has a matching wiki/log.md (or wiki/decisions/log.md + POINTER) entry. |
| 12 | Source fingerprints | For each ## Sources bullet with sha256:<prefix>: sha256sum <file> (or Get-FileHash) must start with the prefix. lint_quick.sh/.ps1 counts these. |
| 13 | Crux verbatimness | For each ## Crux quote, rg -F '<first ~40 chars>' <cited source> — a miss means the evidence moved. Only practical for a few pages; list candidates and ask which to verify. |
| 15 | Secrets and private spans | `rg -n 'BEGIN [A-Z ]*PRIVATE KEY |
| 16 | Kept answers | For each outputs/answers/*.md, check its ## Sources fingerprints as in check 12. |
| 17 | Review status | rg -n '^review:' wiki — values must be draft/reviewed/needs_update; for each reviewed page compare last_updated with reviewed_on. `rg -l '^review: (draft |
| 18 | Contradictions | rg -n '^> *CONTRADICTION:' wiki — every hit is open until resolved. |
| 19 | Tags | rg -n '^tags:' wiki against the backticked first column of wiki/tags.md. |
| — | Context budget | wc -c AGENTS.md ÷ 4, plus each skill's description: line ÷ 4, against budget: always_loaded_tokens in ckb.yaml (default 9000). |
Checks 9–11 (error book, supersession judgment, auto-fix vs. report) are the model's job in every mode and are unchanged here.