Skip to content

The library

The library

Every markdown document in the repository, rendered as it is and grouped as the folders are.

Top-level documents

HEARSAY (CLAUDE.md) CLAUDE.md
HEARSAY (README.md) README.md
HEARSAY: current state (Sat Sep 26, ~20:05; the file is final unless a ratified candidate replaces it) docs/STATUS.md
HEARSAY architecture docs/architecture.md
HEARSAY code map docs/code-map.md
HEARSAY: Master Doc (HackGT 13) docs/master-doc.md
HEARSAY: The Audio Authentication Challenge (NSA sponsor brief) docs/nsa-challenge.md
HEARSAY: The Plan (software only) docs/plan.md
scoping docs/scoping.md

Reports and plan reviews

M1 on public data: frozen XLS-R 300M + logistic probe (Fri Sep 25, 21:09) docs/reports/2026-09-25_m1-public-probe.md
2026-09-25 software only rescope (plan review) docs/reports/2026-09-25_software-only-rescope-plan-review.md
Plan: software-only rescope (deep mode) docs/reports/2026-09-25_software-only-rescope-plan.md
NSA HEARSAY: rules and sponsor questions (Fri Sep 25) docs/reports/2026-09-25_sponsor-questions.md
2026-09-26 channel robustness (plan review) docs/reports/2026-09-26_channel-robustness-plan-review.md
Plan: channel robustness (A, E, B; C gated) — Sat Sep 26, 2026, 12:35 docs/reports/2026-09-26_channel-robustness-plan.md
Channel robustness on the frozen deep path (Sat Sep 26, 2026) docs/reports/2026-09-26_channel-robustness.md
CPU detector track (D-track): engineered detectors and two data traps docs/reports/2026-09-26_cpu-detectors.md
Draft-review reaction branches (pre-computed Sat Sep 26, ~09:30) docs/reports/2026-09-26_draft-review-branches.md
Fusion sweep: pre-declared candidates and selection rule (written before any result, Sat Sep 26 ~08:15) docs/reports/2026-09-26_fusion-sweep-predeclared.md
Non-speech gate, default-answer policy, and speaker-embedding drift docs/reports/2026-09-26_gate-and-drift.md
Handcrafted v4: feature discovery for the three blind generators docs/reports/2026-09-26_handcrafted-v4.md
2026-09-26 k docker image (plan review) docs/reports/2026-09-26_k-docker-image-plan-review.md
Plan: K, the offline CPU Docker image and scripts/runpipeline.py (Sat Sep 26, 2026) docs/reports/2026-09-26_k-docker-image-plan.md
M1b: adding ASVspoof 2019 real speakers to the frozen XLS-R probe (Sat Sep 26, ~03:50) docs/reports/2026-09-26_m1b-asv19-bonafide.md
2026-09-26 m3 spectra aasist (plan review) docs/reports/2026-09-26_m3-spectra-aasist-plan-review.md
Plan: M3, Spectra-AASIST score stream (Sat Sep 26, 2026) docs/reports/2026-09-26_m3-spectra-aasist-plan.md
M3: Spectra-AASIST as the second deep score stream (Sat Sep 26, 2026) docs/reports/2026-09-26_m3-spectra.md
2026-09-26 m4 fusion v2 m5 scorer (plan review) docs/reports/2026-09-26_m4-fusion-v2-m5-scorer-plan-review.md
Plan: M4 fusion v2, M5 as a live scorer in the runner (Sat Sep 26, 2026, written 10:10, revised 10:20 after the critique agent) docs/reports/2026-09-26_m4-fusion-v2-m5-scorer-plan.md
2026-09-26 m5 xlsr finetune (plan review) docs/reports/2026-09-26_m5-xlsr-finetune-plan-review.md
Plan: M5, XLS-R 300M fine-tune on vast.ai (Sat Sep 26, 2026, ~03:20; revised 03:25 after Codex + critique + the consult answer) docs/reports/2026-09-26_m5-xlsr-finetune-plan.md
M5: XLS-R 300M fine-tune on vast.ai (Sat Sep 26, 2026) docs/reports/2026-09-26_m5-xlsr-finetune.md
2026-09-26 post draft gate sweep (plan review) docs/reports/2026-09-26_post-draft-gate-sweep-plan-review.md
Plan: post-draft gate sweep (scripts/fusesweepv3.py) docs/reports/2026-09-26_post-draft-gate-sweep-plan.md
Handcrafted v6: noise twins did not make the handcrafted model noise-robust (Sat Sep 26, 2026, evening) docs/reports/2026-09-26_post-draft-hc-noise.md
Post-draft heads: a frozen WavLM Large probe on the M1b recipe (Sat Sep 26, 2026, 19:10) docs/reports/2026-09-26_post-draft-heads.md
Post-draft candidate manifest and gate (pre-declared Sat Sep 26, 2026, ~17:45 EDT) docs/reports/2026-09-26_post-draft-manifest.md
What did not work after the draft review (Sat Sep 26, 2026, evening) docs/reports/2026-09-26_post-draft-negatives.md
Post-draft sweep: the locked table and the packet (Sat Sep 26, 2026, 19:08 EDT) docs/reports/2026-09-26_post-draft-sweep.md
Runner, API and Docker status (Sat Sep 26, 2026, runner lane; written 07:35, v2 at 08:35, v3 at 10:55) docs/reports/2026-09-26_runner-docker.md
2026-09-26 sponsor questions docs/reports/2026-09-26_sponsor-questions.md
Worked examples: eight real test files through the shipped pipeline docs/reports/2026-09-26_worked-examples.md
Cloud expense ledger (HEARSAY) docs/reports/cloud-expense-ledger.md

Run specs and audits

2026-09-25 software only rescope (audit) docs/specs/2026-09-25_software-only-rescope-audit.md
Run spec: software-only rescope (Fri Sep 25, 2026, ~23:00) docs/specs/2026-09-25_software-only-rescope.md
2026-09-26 channel robustness (audit) docs/specs/2026-09-26_channel-robustness-audit.md
Run spec: channel robustness on the frozen deep path (Sat Sep 26, 2026, 12:30) docs/specs/2026-09-26_channel-robustness.md
Run spec: does the double low-pass stopband move any detector? (Sat Sep 26, 2026, 14:26) docs/specs/2026-09-26_channel-stopband.md
2026-09-26 k docker image (audit) docs/specs/2026-09-26_k-docker-image-audit.md
Run spec: K, the offline CPU Docker image and the end-to-end runner (Sat Sep 26, 2026, ~06:20) docs/specs/2026-09-26_k-docker-image.md
2026-09-26 m3 spectra aasist (audit) docs/specs/2026-09-26_m3-spectra-aasist-audit.md
Run spec: M3, Spectra-AASIST as the second deep score stream (Sat Sep 26, 2026, ~04:20) docs/specs/2026-09-26_m3-spectra-aasist.md
2026-09-26 m4 fusion v2 m5 scorer (audit) docs/specs/2026-09-26_m4-fusion-v2-m5-scorer-audit.md
Run spec: M4 fusion v2, M5 as a live scorer in the runner (Sat Sep 26, 2026, ~09:50) docs/specs/2026-09-26_m4-fusion-v2-m5-scorer.md
2026-09-26 m5 xlsr finetune (audit) docs/specs/2026-09-26_m5-xlsr-finetune-audit.md
Run spec: M5, XLS-R 300M fine-tune on vast.ai (Sat Sep 26, 2026, ~02:50) docs/specs/2026-09-26_m5-xlsr-finetune.md
2026-09-26 post draft gate sweep (audit) docs/specs/2026-09-26_post-draft-gate-sweep-audit.md
Run spec: post-draft gate sweep (scripts/fusesweepv3.py) docs/specs/2026-09-26_post-draft-gate-sweep.md
2026-09-26 post draft heads (audit) docs/specs/2026-09-26_post-draft-heads-audit.md
Run spec: post-draft heads lane, frozen WavLM Large probe (Sat Sep 26, 2026, 18:15) docs/specs/2026-09-26_post-draft-heads.md

Handoffs

Handoff — first-two-hours (2026-09-25, 8:01 pm) docs/handoffs/2026-09-25_first-two-hours-handoff.md
Handoff: channel robustness on the frozen path (Sat Sep 26, 2026, ~08:30) docs/handoffs/2026-09-26_channel-robustness-handoff.md
Handoff: CPU detector track (Sat Sep 26, 2026, ~01:10) docs/handoffs/2026-09-26_cpu-detectors-handoff.md
Handoff: K, the Docker image (Sat Sep 26, 2026, ~05:45) docs/handoffs/2026-09-26_docker-handoff.md
Handoff — docs-site lane, continued in a Claude Code cloud session (Sat Sep 26, 2026, ~13:35) docs/handoffs/2026-09-26_docs-site-cloud-handoff.md
Handoff: the documentation site (Sat Sep 26, 2026, ~13:10) docs/handoffs/2026-09-26_docs-site-handoff.md
Handoff: the test-set TSV, the draft review and the final submission (Sat Sep 26, 2026, ~10:00) docs/handoffs/2026-09-26_draft-review-handoff.md
Feature engineering: where you can add (map for the spectral/prosody teammate) docs/handoffs/2026-09-26_feature-engineering-map.md
Frontend ↔ backend contract (Sat Sep 26, 2026, ~06:30) docs/handoffs/2026-09-26_frontend-contract.md
Handoff: wiring the frontend to HEARSAY, with the fusion section (Sat Sep 26, 2026, ~09:20) docs/handoffs/2026-09-26_frontend-wiring-handoff.md
Brief: handcrafted v4, feature discovery for the three blind generators (Sat Sep 26, 2026, ~03:40) docs/handoffs/2026-09-26_handcrafted-v4-brief.md
Handoff: M3, Spectra-AASIST as the second deep detector (Sat Sep 26, 2026, ~03:35) docs/handoffs/2026-09-26_m3-spectra-aasist-handoff.md
Handoff: M4 fusion (Sat Sep 26, 2026, ~09:10) docs/handoffs/2026-09-26_m4-fusion-handoff.md
Handoff: M5 XLS-R fine-tune on vast.ai (Sat Sep 26, 2026, ~01:30) docs/handoffs/2026-09-26_m5-finetune-handoff.md
Handoff: the oversight chat (Sat Sep 26, 2026, ~08:55) docs/handoffs/2026-09-26_oversight-handoff.md
Handoff — post-draft CPU lane: the negative results, written up for the README (Sat Sep 26, 2026, ~17:25; revised after the Fable second opinion) docs/handoffs/2026-09-26_post-draft-cpu-handoff.md
Handoff — post-draft gate lane: manifest, stricter gate, the sweep, the ratification packet (Sat Sep 26, 2026, ~17:25; revised after the Fable second opinion) docs/handoffs/2026-09-26_post-draft-gate-handoff.md
Handoff — post-draft heads lane: WavLM Large probe (Sat Sep 26, 2026, ~17:25; revised after the Fable second opinion) docs/handoffs/2026-09-26_post-draft-heads-handoff.md
Handoff: the README, the explanation report and orchestration credit (Sat Sep 26, 2026, ~08:30) docs/handoffs/2026-09-26_readme-orchestration-handoff.md

Consult records

Consult: fusion, selection, false alarms and the "default answer" (Sat Sep 26, 2026, ~03:30 EDT; updated ~04:30 with In-the-Wild and band-limit findings; ~05:50 with the band-matched v3 numbers, M3 and the fusion v0 readout) docs/consults/2026-09-26_fusion-strategy_CONSULTATION.md
Response: fusion, selection, false alarms and the "default answer" (received Sat Sep 26, 2026, 08:05) docs/consults/2026-09-26_fusion-strategy_RESPONSE.md
2026-09-26 fusion strategy RESPONSE verbatim docs/consults/2026-09-26_fusion-strategy_RESPONSE_verbatim.md
Consult: M5, XLS-R fine-tune data mix and recipe (Sat Sep 26, 2026, ~02:30 EDT) docs/consults/2026-09-26_m5-extra-data-finetune_CONSULTATION.md
Response: M5 extra-data mix and fine-tune recipe docs/consults/2026-09-26_m5-extra-data-finetune_RESPONSE.md
2026-09-26 m5 extra data finetune RESPONSE verbatim docs/consults/2026-09-26_m5-extra-data-finetune_RESPONSE_verbatim.md
Consult: after the draft review — the returned number is fixed; what do we build in the last 13 hours? (Sat Sep 26, 2026, drafted ~12:15 EDT, rewritten ~15:40 with NSA's returned numbers) docs/consults/2026-09-26_post-draft-review_CONSULTATION.md
Response: after the draft review — what to build in the last hours (received Sat Sep 26, 2026, ~16:50) docs/consults/2026-09-26_post-draft-review_RESPONSE.md
Independent second opinion: a Claude Fable 5.1 agent on the post-draft consult (Sat Sep 26, 2026, 17:00–17:15 EDT) docs/consults/2026-09-26_post-draft-review_RESPONSE_fable.md
2026-09-26 post draft review RESPONSE verbatim docs/consults/2026-09-26_post-draft-review_RESPONSE_verbatim.md

Working method (skills and review rubrics)

codex audit prompt .claude/codex-audit-prompt.md
codex review prompt .claude/codex-review-prompt.md
/consult — External-source consultation message .claude/skills/consult/SKILL.md
Diagnose .claude/skills/diagnose/SKILL.md
/doc-sync — Documentation drift check .claude/skills/doc-sync/SKILL.md
/handoff — New-chat handoff prompt .claude/skills/handoff/SKILL.md
/p3 — Execute .claude/skills/p3/SKILL.md
/plan-review — Full Change Pipeline .claude/skills/plan-review/SKILL.md
/test-runner — Run and diagnose the suite .claude/skills/test-runner/SKILL.md
/validate-training-data — Dataset / manifest validation .claude/skills/validate-training-data/SKILL.md
zoom-out .claude/skills/zoom-out/SKILL.md