harness-anchor

Scaffold harness-anchor state files (AGENTS.md, feature_list.json, init.sh, progress.md, session-handoff.md, PROJECT-TOC.md) into the current project.

Initialize C/C++ project-specific harness files (.clang-format, .clang-tidy, sanitizer build, init.sh tuned per build system). Run AFTER /anchor.

On-demand code-drift / entropy scan (garbage collection) via a fresh-context drift-analyst subagent. Checks changed/active code against golden-rules.md + generic drift heuristics (dead code, duplication, doc-drift) and reports findings with an evidence path. Read-only — recommends, never auto-refactors. Not `git gc`.

(Re)build PROJECT-TOC.md — one-line index of every git-tracked source file, with git-commit freshness anchor.

Build a C/C++ project under runtime sanitizers (ASan+UBSan by default; TSan separately) and run its tests, reporting findings in fixed sections. Use for crashes, leaks, use-after-free, undefined behavior, or data races — or before merging C/C++ changes. Heavy build, so it is a command, never a hook.

Use when /test-plan runs or the calling agent needs a fresh-context coverage-gap analysis before a feature is called done. Derives test obligations from code + spec (post-implementation, gray-box), finds gaps — including paths and built binaries that sit OUTSIDE what the test runner executes — and recommends a minimal, oracle-independent-first test set. Read-only.

Use when C/C++ build fails — compile/link/configure error, missing header or package. Diagnoses root cause from build output. Read-only.

Use when /gc runs or the calling agent needs a fresh-context scan for code drift, entropy, or AI slop before wrapping up. Checks changed/active code against the project's golden-rules.md plus generic drift heuristics (duplicated helpers, inconsistent error handling, copy-paste blocks, oversized files, TODO pileup, doc-drift) and reports violations with an evidence path. Read-only — recommends, never refactors.

Use when PROJECT-TOC.md needs rebuilding — after refactors, renames, or SessionStart toc_stale. Runs index-builder.mjs. Writes only PROJECT-TOC.md.

Use when user invokes /verify or calling agent needs fresh-context evaluation of done-ness. Runs build/tests/lint, reports evidence paths. Read-only.

Use before claiming "done", "fixed", "complete", "passing". Default-FAIL contract — every criterion needs evidence; express uncertainty if missing.

Use when the same mistake or bad pattern recurs, when a code-review comment is really a convention worth enforcing, or when you catch AI-generated drift/slop and want it to never happen again. Encodes the lesson as a durable rule in golden-rules.md — the feedback-flywheel / harness-layer-learning ratchet — instead of a one-off fix. Generic (language-agnostic).

Use when sessions run long, adding subagents, fetching large files, or planning context-heavy work. SELECT/WRITE/COMPRESS/ISOLATE discipline.

Use in C/C++ projects for build configure/errors, compile_commands.json generation, or selecting CMake/Meson/Make/Bazel commands.

Use in C/C++ projects for clang-format. Changed-lines-only; never reformat unchanged code mid-feature. .clang-format from root or LLVM baseline.

4 hooks across 4 events