docs: bring README and CLAUDE.md in line with v0.3.9 #82

Merged
lars merged 1 commits from docs/sync-readme-claude-md into master 2026-08-26 10:06:08 +02:00
Owner

CLAUDE.md still described the pre-v0.3.0 codebase: the Stage-2
autoregressive redesign as "designed, not implemented", a monolithic
network.py, a single global model.conditioning switch, and WGAN as
"implemented, not yet tested".

  • Architecture rewritten around the actual giant/model split
    (layers/encoders/trunks/routers/history/objectives/models/builders/
    _legacy/summary; network.py is now a re-export shim), plus
    cond_layout.py, checkpoint_io.py, _migration.py, data/setup_cache.py
    and giant/training/.
  • Conditioning documented per axis (conditioning.particle /
    conditioning.material, each physical|embedding|onehot, freely mixed).
  • Stage 2 documented with both decoders, n_sec.mode, teacher forcing,
    stage1_context and the three particle_type.target options.
  • Roadmap: v0.3.0 recorded as implemented/released; WGAN and MoE routing
    as implemented but unvalidated, with the router retrain as next step.
  • Analysis: run dir is /analysis_runs/analysis_, plus
    variables/reduced/runtime_estimate and analyze list/merge-one/metrics.
  • Added giant model summary, configs/, and the CI-automated version and
    changelog bump.

README drift fixes only: project tree for the model/analysis/training
splits, analyze run-dir default, missing subcommands, --precision and
--stage2-stage1-context, the extras list, and two accuracy fixes
(--router configures stage 1 only; --conditioning sets two independent
axes at once).

Co-Authored-By: Claude Opus 5 noreply@anthropic.com

CLAUDE.md still described the pre-v0.3.0 codebase: the Stage-2 autoregressive redesign as "designed, not implemented", a monolithic network.py, a single global model.conditioning switch, and WGAN as "implemented, not yet tested". - Architecture rewritten around the actual giant/model split (layers/encoders/trunks/routers/history/objectives/models/builders/ _legacy/summary; network.py is now a re-export shim), plus cond_layout.py, checkpoint_io.py, _migration.py, data/setup_cache.py and giant/training/. - Conditioning documented per axis (conditioning.particle / conditioning.material, each physical|embedding|onehot, freely mixed). - Stage 2 documented with both decoders, n_sec.mode, teacher forcing, stage1_context and the three particle_type.target options. - Roadmap: v0.3.0 recorded as implemented/released; WGAN and MoE routing as implemented but unvalidated, with the router retrain as next step. - Analysis: run dir is <cwd>/analysis_runs/analysis_<id>, plus variables/reduced/runtime_estimate and analyze list/merge-one/metrics. - Added giant model summary, configs/, and the CI-automated version and changelog bump. README drift fixes only: project tree for the model/analysis/training splits, analyze run-dir default, missing subcommands, --precision and --stage2-stage1-context, the extras list, and two accuracy fixes (--router configures stage 1 only; --conditioning sets two independent axes at once). Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
lars added 1 commit 2026-08-26 10:05:21 +02:00
docs: bring README and CLAUDE.md in line with v0.3.9
CI / Format (ruff format) (push) Successful in 36s
CI / Lint (ruff check) (push) Successful in 41s
CI / Sync project version with tag (push) Has been skipped
CI / Type check (ty) (push) Successful in 32s
CI / Lint (ruff check) (pull_request) Successful in 49s
CI / Format (ruff format) (pull_request) Successful in 48s
CI / Sync project version with tag (pull_request) Has been skipped
CI / Type check (ty) (pull_request) Successful in 40s
CI / Tests (push) Successful in 5m50s
CI / Tests (pull_request) Successful in 4m36s
CI / Bump version, tag, and update changelog on merge to master (push) Has been skipped
CI / Bump version, tag, and update changelog on merge to master (pull_request) Has been skipped
f2da0642b2
CLAUDE.md still described the pre-v0.3.0 codebase: the Stage-2
autoregressive redesign as "designed, not implemented", a monolithic
network.py, a single global model.conditioning switch, and WGAN as
"implemented, not yet tested".

- Architecture rewritten around the actual giant/model split
  (layers/encoders/trunks/routers/history/objectives/models/builders/
  _legacy/summary; network.py is now a re-export shim), plus
  cond_layout.py, checkpoint_io.py, _migration.py, data/setup_cache.py
  and giant/training/.
- Conditioning documented per axis (conditioning.particle /
  conditioning.material, each physical|embedding|onehot, freely mixed).
- Stage 2 documented with both decoders, n_sec.mode, teacher forcing,
  stage1_context and the three particle_type.target options.
- Roadmap: v0.3.0 recorded as implemented/released; WGAN and MoE routing
  as implemented but unvalidated, with the router retrain as next step.
- Analysis: run dir is <cwd>/analysis_runs/analysis_<id>, plus
  variables/reduced/runtime_estimate and analyze list/merge-one/metrics.
- Added giant model summary, configs/, and the CI-automated version and
  changelog bump.

README drift fixes only: project tree for the model/analysis/training
splits, analyze run-dir default, missing subcommands, --precision and
--stage2-stage1-context, the extras list, and two accuracy fixes
(--router configures stage 1 only; --conditioning sets two independent
axes at once).

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
lars merged commit 8dee2feab7 into master 2026-08-26 10:06:08 +02:00
lars deleted branch docs/sync-readme-claude-md 2026-08-26 10:06:10 +02:00
Sign in to join this conversation.