Skip to content

docs(methods): methods skeleton and update rules - #115

Merged
briney merged 10 commits into
mainfrom
docs/methods-skeleton
Nov 13, 2026
Merged

briney merged 10 commits into
mainfrom
docs/methods-skeleton

Conversation

@briney

@briney briney commented Nov 12, 2026 •

Copy link
Copy Markdown
Owner

Summary

Adds docs/methods/, the source material for the paper's methods section: what the production models are, why each choice was made, and the results behind each choice.

  • README.md: the six rules, the evidence-record template and the CSV conventions.
  • Five topic pages (architecture, data, optimization, evaluation, fold): one table each, listing every choice, where its value lives and the evidence for it. No row reads to backfill any more.
  • 15 evidence records under evidence/<slug>/, each with a README.md, a results.csv, the arms' resolved configs and, where the figure is a curve, a curves.csv.
  • Pointers from docs/README.md and AGENTS.md.

Evidence records

Status Records
settled (5) base-lr-funnel, decay-shape, residual-gate, mup-coordinate-check, member-sampling-check
provisional (7) antibody-fraction, lr-vs-training-length, decay-uniref70-share, weight-decay-to-init, looping, training-length-and-overfitting, coevolution-eval-readout
needs matched rerun (3) canon-ablation (#116), oplm-vs-esmc-recipe (#117), adamw-lr-multiplier (#118)

What is still open

Notes for review

  • Most of the diff is resolved run configs and CSVs; the prose is the topic pages and the record READMEs.
  • The OPLM coordinate check was rerun for this PR (job 36026, commit 7150334); no earlier output had been kept.
  • Numbers taken from session notes instead of a run artifact are labeled as such in the record.

Test plan

  • pytest tests/test_docs.py (6 passed)

Refs #70

🤖 Generated with Claude Code

briney and others added 2 commits November 12, 2026 11:28
Topic pages list each production choice, where its value lives and its
evidence; evidence records (README + results.csv) hold the results.

Co-Authored-By: Claude Fable 5.2 <noreply@anthropic.com>
Co-Authored-By: Claude Fable 5.2 <noreply@anthropic.com>
briney and others added 5 commits November 12, 2026 11:40
decay-shape, lr-vs-training-length, decay-uniref70-share, oplm-vs-esmc-recipe.

Co-Authored-By: Claude Fable 5.2 <noreply@anthropic.com>
…nit records

Co-Authored-By: Claude Fable 5.2 <noreply@anthropic.com>
Co-Authored-By: Claude Fable 5.2 <noreply@anthropic.com>
Co-Authored-By: Claude Fable 5.2 <noreply@anthropic.com>
…the data rows

Co-Authored-By: Claude Fable 5.2 <noreply@anthropic.com>
briney and others added 3 commits November 12, 2026 15:30
Add the adamw-lr-multiplier record (÷3 vs ÷10 to 800k, needs matched
rerun, #118). The depth LR correction and tokens per step were never
varied; their rows say so and point at the funnel record.

Refs #70

Co-Authored-By: Claude Fable 5.2 <noreply@anthropic.com>
Add the coevolution-eval-readout record (nine proxy checkpoints scored
against the published Potts reference). The structure sets, the CDR3
masking scheme and judging after a decay point at existing homes.

Refs #70

Co-Authored-By: Claude Fable 5.2 <noreply@anthropic.com>
None needed a new record: the LM base and the PDB-only single-chain data
are scope decisions deferred to #49, inference memory already lives in
FOLD.md, and the pair-width comparison is pending the proof runs (#48).

Refs #70

Co-Authored-By: Claude Fable 5.2 <noreply@anthropic.com>
@briney
briney merged commit 81ca84e into main Nov 13, 2026
3 checks passed
@briney
briney deleted the docs/methods-skeleton branch November 13, 2026 18:02
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant