ckb/.agents/skills/ckb-lint/references/manual-checklist.md
Michał Kopeć bf2cc8e8aa Template 1.23.0: agent-knowledge release 2, schema 1.6
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>
2026-11-02 20:06:02 +01:00

3.6 KiB
Raw Blame History

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.