Repository navigation
docs: require a work-log record per experiment, and record the region floor - #10
Merged
Merged
Conversation
shinaoka
force-pushed
the
docs/worklog
branch
from
October 14, 2026 02:18
e24cf4c to
48a972f
Compare
The fork's whole purpose is a measurable delta against upstream, so the reason for each ledger row and the course of an optimisation have to survive the session that made it. AGENTS.md now points at the shared Work Logs And Design Records policy and the local format in docs/worklogs/, states that upstream feedback is deferred at this stage, and says where an unmeasured lead belongs. The first record covers #9: the floor the compact factor now asks once, the two candidates that lost with the measurements that killed them, how the fork and upstream compare, and the leads this session did not measure.
shinaoka
force-pushed
the
docs/worklog
branch
from
October 14, 2026 02:22
48a972f to
b56308d
Compare
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Makes the fork's records followable, and puts the format where the others already live.
What
AGENTS.mdgains a Work Logs And Review Intent section: follow the shared Work Logs And Design Records policy and the local format indocs/worklogs/README.md; one record per change theme for a nontrivial multi-phase change, a non-obvious design choice or a performance experiment.PATCHSET.mdstays the ledger of what the fork carries; the record explains why it carries it — the isolation, the candidates that were tried and dropped with the measurement that dropped them, and what is linked to the result. Unmeasured leads go under "what remains unverified" in the record, not into the ledger.AGENTS.mdalso states that upstream feedback is deferred at this stage: measure an upstream defect, record it with the upstream revision that was measured, and leave the decision to the maintainer. Nothing is prepared or opened upstream.docs/worklogs/README.md: the local format, adapted fromtenferro-rs'sdocs/worklogs/README.md(same policy, same## Decisions/## Verification conclusions and constraintsskeleton), plus one duty specific to this fork: a performance record says which upstream revision was measured, or that none was.docs/worklogs/2026-10-14-compact-factor-region-floor.md: the first record, for perf(householder): no parallel region below the compact factor's own floor #9. Why the floor is asked once, the two rejected candidates with the numbers that killed them (the area-based gate: 4096x256 f64 6.36 → 6.82 ms; forcing then x n x nhead product toPar::Seq: 512x512 f64 2.49 → 3.43 ms), the upstream comparison (upstream0.24.4is 4.46x slower threaded at 128x128 f64, against the fork's 4.57 before the change), the limits of the evidence (a scan, not a paired comparison; one unattributable pooled cell; one pre-existing unrelated test failure), and the three leads nobody has measured yet (bidiag.rsdiscardspar,evd/tridiag.rsnever threads,luscales 1.85x at 512 and needs a phase profile first).Documentation only: no source change, no
PATCHSET.mdstatus change.