docs(contributing): document the fast t27c inner loop

[gHashTag]

Closes #5934. Part of #5905 (weak point 5, last checklist row).

What changes

CONTRIBUTING.md gains a "Build speed" section. The only build it named before was the release build, which has no incremental compilation, so each edit cost about 30 s.

you need	command	one-line edit, then rebuild
type errors only	cargo check -p t27c	2.4-3.3 s
a binary that runs	cargo build -p t27c	3.2-4.1 s
a release binary that runs	CARGO_PROFILE_RELEASE_INCREMENTAL=true cargo build --release -p t27c	3.2-5.0 s
the CI / release build	cargo build --release -p t27c	29.8-33.9 s

The section also covers three things that were not written down:

• Do not benchmark or ship an incremental release build. It defaults to 256 codegen units instead of 16.
• scripts/tri prefers target/release/t27c over a fresher debug binary, so iterating with debug builds needs TRI_T27C=target/debug/t27c.
• The compiler.rs seal. The remedy that build.rs and FROZEN.md print, cargo run --release -- frozen-digest, panics again after the edit (build.rs FROZEN_HASH panic tells you to run a command that hits the same panic #5928). The section names two routes that work: a binary built before the edit, or shasum -a 256. All three print the same digest:

$ t27c frozen-digest
b45a356c...3526 bootstrap/src/compiler.rs
$ shasum -a 256 bootstrap/src/compiler.rs
b45a356c...3526  bootstrap/src/compiler.rs
$ head of bootstrap/stage0/FROZEN_HASH
b45a356c...3526 bootstrap/src/compiler.rs

The section links to the ceremony in FROZEN.md instead of restating it.

CLAUDE.md section 2 gains one pointer line, not a copy.

Where the numbers come from

They were measured on 2026-10-04 on an idle M1 Pro (8 cores), adding one function to bootstrap/src/suite.rs, with a warm-up build first. The debug row used CARGO_PROFILE_DEV_DEBUG=0.

I also tried to time edits to compiler.rs itself. The machine was at load average 200-300, and a debug rebuild took 137-215 s, so those numbers measure contention, not the build. They are not in the doc, and the section says compiler.rs was not timed on an idle machine.

Not changed

No [profile] edit and no .cargo/config, so CI and release builds are unchanged.

🤖 Generated with Claude Code

[github-actions]

PR Dashboard

Generated at: 2026-10-04 07:41:38 UTC

• docs(contributing): document the fast t27c inner loop #5945 docs(contributing): document the fast t27c inner loop | Created: 2026-10-04 | Updated: 2026-10-04 | 13 failing / 30 total
• test(c-backend): retain real compiler regression controls #5944 test(c-backend): retain real compiler regression controls | Created: 2026-10-04 | Updated: 2026-10-04 | 6 failing / 37 total
• spec(split-reel): v9 -- each voice is held to its own slowest measured pace #5932 spec(split-reel): v9 -- each voice is held to its own slowest measured pace | Created: 2026-10-04 | Updated: 2026-10-04 | 2 failing / 32 total
• spec(automation/blog-share): v3 -- the owner's queue comes first; a switched-off network is not asked about #5931 spec(automation/blog-share): v3 -- the owner's queue comes first; a switched-off network is not asked about | Created: 2026-10-04 | Updated: 2026-10-04 | 3 failing / 34 total
• Port gHashTag/BrowserOS:trios/agent-server/apps/server/src/lib/provider-error-classifier.ts (TypeScript, 1 function) to  #5926 Port gHashTag/BrowserOS:trios/agent-server/apps/server/src/lib/provider-error-classifier.ts (TypeScript, 1 function) to | Created: 2026-10-04 | Updated: 2026-10-04 | 2 failing / 31 total
• CI: spec-guards and emit-bitexact restore master cargo caches; cancel superseded emit-bitexact runs (B25) #5924 CI: spec-guards and emit-bitexact restore master cargo caches; cancel superseded emit-bitexact runs (B25) | Created: 2026-10-04 | Updated: 2026-10-04 | 1 failing / 32 total
• ring-096 and formats.t27 agree on f32 (Closes #5746) #5921 ring-096 and formats.t27 agree on f32 (Closes #5746) | Created: 2026-10-04 | Updated: 2026-10-04 | 1 failing / 56 total
• build(t27c): reqwest on native-tls, drop the aws-lc-sys build #5920 build(t27c): reqwest on native-tls, drop the aws-lc-sys build | Created: 2026-10-04 | Updated: 2026-10-04 | 8 failing / 31 total
• build(t27c): put the web stack behind cargo features (212 -> 49 crates) #5914 build(t27c): put the web stack behind cargo features (212 -> 49 crates) | Created: 2026-10-04 | Updated: 2026-10-04 | 5 failing / 33 total
• fix(rust): preserve writes to by-value parameter bindings #5911 [GOLD-RING] Infer writable Rust value parameter bindings | Created: 2026-10-04 | Updated: 2026-10-04 | 4 failing / 41 total
• fix(t27c): var tuple destructure silences never-mutated Zig locals (Closes #5886) #5902 fix(t27c): var tuple destructure silences never-mutated Zig locals (Closes #5886) | Created: 2026-10-04 | Updated: 2026-10-04 | 3 failing / 46 total
• chore(deps): drop unused candle-core/candle-nn from t27c (clean build 142.7 s -> 97.9 s) #5900 chore(deps): drop unused candle-core/candle-nn from t27c (clean build 142.7 s -> 97.9 s) | Created: 2026-10-04 | Updated: 2026-10-04 | 7 failing / 38 total
• fix(tri tick): dirty work nobody holds is an anomaly, released claim or not #5896 fix(tri tick): dirty work nobody holds is an anomaly, released claim or not | Created: 2026-10-04 | Updated: 2026-10-04 | 3 failing / 34 total
• fix(tri gates shell): a step whose run: key comes first is a step #5894 fix(tri gates shell): a step whose run: key comes first is a step | Created: 2026-10-04 | Updated: 2026-10-04 | 1 failing / 43 total
• spec(crm-client-workspace): v6 -- client work carries the client's marks #5893 spec(crm-client-workspace): v6 -- client work carries the client's marks | Created: 2026-10-04 | Updated: 2026-10-04 | 1 failing / 34 total
• Port gHashTag/trios:crates/trios-openclaw/rings/OC-01/src/lib.rs (Rust, 3 functions) to specs/port/trios/crates/trios-op #5888 Port gHashTag/trios:crates/trios-openclaw/rings/OC-01/src/lib.rs (Rust, 3 functions) to specs/port/trios/crates/trios-op | Created: 2026-10-04 | Updated: 2026-10-04 | 2 failing / 35 total
• Port gHashTag/trinity:fpga/openxc7-synth/d_oscillator.v (Verilog, 1 module) to specs/port/trinity/fpga/openxc7-synth/d_o #5887 Port gHashTag/trinity:fpga/openxc7-synth/d_oscillator.v (Verilog, 1 module) to specs/port/trinity/fpga/openxc7-synth/d_o | Created: 2026-10-04 | Updated: 2026-10-04 | 5 failing / 35 total
• Port scripts/test-agent-bridge.sh (Shell, 1 function) to specs/port/scripts/test-agent-bridge.t27 #5883 Port scripts/test-agent-bridge.sh (Shell, 1 function) to specs/port/scripts/test-agent-bridge.t27 | Created: 2026-10-04 | Updated: 2026-10-04 | 2 failing / 35 total
• Port gHashTag/BrowserOS:trios/agent-server/apps/server/src/api/services/a2a/a2a-liveness.ts (TypeScript, 2 functions) to #5879 Port gHashTag/BrowserOS:trios/agent-server/apps/server/src/api/services/a2a/a2a-liveness.ts (TypeScript, 2 functions) to | Created: 2026-10-04 | Updated: 2026-10-04 | 3 failing / 35 total
• feat(tri pr-state): --why, and each name under the heading tri printed it under #5868 feat(tri pr-state): --why, and each name under the heading tri printed it under | Created: 2026-10-04 | Updated: 2026-10-04 | 1 failing / 30 total
• Port gHashTag/trinity:fpga/openxc7-synth/led_both_test.v (Verilog, 1 module) to specs/port/trinity/fpga/openxc7-synth/le #5866 Port gHashTag/trinity:fpga/openxc7-synth/led_both_test.v (Verilog, 1 module) to specs/port/trinity/fpga/openxc7-synth/le | Created: 2026-10-04 | Updated: 2026-10-04 | 4 failing / 35 total
• fix(tri tick): a released claim is not held, and the dead-tick fix names its files #5864 fix(tri tick): a released claim is not held, and the dead-tick fix names its files | Created: 2026-10-04 | Updated: 2026-10-04 | 1 failing / 34 total
• Port gHashTag/trios:crates/trios-scarab-types/rings/SR-01/src/lib.rs (Rust, 6 functions) to specs/port/trios/crates/trio #5855 Port gHashTag/trios:crates/trios-scarab-types/rings/SR-01/src/lib.rs (Rust, 6 functions) to specs/port/trios/crates/trio | Created: 2026-10-04 | Updated: 2026-10-04 | 4 failing / 35 total
• feat(tri pr ready): --why compares what a pre-existing failure printed #5853 feat(tri pr ready): --why compares what a pre-existing failure printed | Created: 2026-10-04 | Updated: 2026-10-04 | 3 failing / 38 total
• feat(tri): tri harness measures a page signed in -- --save-state / --storage-state, sessionStorage included #5849 feat(tri): tri harness measures a page signed in -- --save-state / --storage-state, sessionStorage included | Created: 2026-10-04 | Updated: 2026-10-04 | 2 failing / 35 total
• feat(tri pr ready): ask a check's own workflow when the commit window missed it #5839 feat(tri pr ready): ask a check's own workflow when the commit window missed it | Created: 2026-10-03 | Updated: 2026-10-03 | 3 failing / 41 total
• Port gHashTag/trinity:src/vibeec/validation_engine.zig (Zig, 3 functions) to specs/port/trinity/src/vibeec/validation_en #5836 Port gHashTag/trinity:src/vibeec/validation_engine.zig (Zig, 3 functions) to specs/port/trinity/src/vibeec/validation_en | Created: 2026-10-03 | Updated: 2026-10-04 | 5 failing / 35 total
• feat(tri): tri harness -- a page measured at 375px and 1024px, every visible frame #5828 feat(tri): tri harness -- a page measured at 375px and 1024px, every visible frame | Created: 2026-10-03 | Updated: 2026-10-03 | 2 failing / 37 total
• feat(tri census explain): name the file behind a moved census number #5826 feat(tri census explain): name the file behind a moved census number | Created: 2026-10-03 | Updated: 2026-10-03 | 3 failing / 39 total
• tri pr-state: a loop's pull requests with tri pr ready's verdict, not "open" #5824 tri pr-state: a loop's pull requests with tri pr ready's verdict, not "open" | Created: 2026-10-03 | Updated: 2026-10-03 | 1 failing / 32 total
• Port gHashTag/trinity:fpga/openxc7-synth/blink_simple.v (Verilog, 1 module) to specs/port/trinity/fpga/openxc7-synth/bli #5822 Port gHashTag/trinity:fpga/openxc7-synth/blink_simple.v (Verilog, 1 module) to specs/port/trinity/fpga/openxc7-synth/bli | Created: 2026-10-03 | Updated: 2026-10-04 | 4 failing / 35 total
• Port gHashTag/trinity:fpga/openxc7-synth/uart_echo.v (Verilog, 1 module) to specs/port/trinity/fpga/openxc7-synth/uart_e #5820 Port gHashTag/trinity:fpga/openxc7-synth/uart_echo.v (Verilog, 1 module) to specs/port/trinity/fpga/openxc7-synth/uart_e | Created: 2026-10-03 | Updated: 2026-10-04 | 4 failing / 35 total
• tri: stranded-work finder and cron tick resume card #5787 tri: stranded-work finder and cron tick resume card | Created: 2026-10-03 | Updated: 2026-10-03 | 1 failing / 31 total
• Port gHashTag/trinity:fpga/openxc7-synth/d_srl_blink.v (Verilog, 1 module) to specs/port/trinity/fpga/openxc7-synth/d_sr #5783 Port gHashTag/trinity:fpga/openxc7-synth/d_srl_blink.v (Verilog, 1 module) to specs/port/trinity/fpga/openxc7-synth/d_sr | Created: 2026-10-03 | Updated: 2026-10-04 | 2 failing / 36 total
• Port gHashTag/trinity:fpga/openxc7-synth/d_bufg_test.v (Verilog, 1 module) to specs/port/trinity/fpga/openxc7-synth/d_bu #5781 Port gHashTag/trinity:fpga/openxc7-synth/d_bufg_test.v (Verilog, 1 module) to specs/port/trinity/fpga/openxc7-synth/d_bu | Created: 2026-10-03 | Updated: 2026-10-04 | 3 failing / 36 total
• Port gHashTag/trinity:fpga/openxc7-synth/led_on_test.v (Verilog, 1 module) to specs/port/trinity/fpga/openxc7-synth/led_ #5780 Port gHashTag/trinity:fpga/openxc7-synth/led_on_test.v (Verilog, 1 module) to specs/port/trinity/fpga/openxc7-synth/led_ | Created: 2026-10-03 | Updated: 2026-10-03 | 2 failing / 36 total
• Port gHashTag/BrowserOS:trios/agent-server/apps/server/src/api/services/queen-lane-credits.ts (TypeScript, 4 functions)  #5778 Port gHashTag/BrowserOS:trios/agent-server/apps/server/src/api/services/queen-lane-credits.ts (TypeScript, 4 functions) | Created: 2026-10-03 | Updated: 2026-10-03 | 3 failing / 32 total
• bees/merger/publisher: reviewer bee as a service, merger reads discounted checks, publisher heading passes check (Closes #5776) #5777 bees/merger/publisher: reviewer bee as a service, merger reads discounted checks, publisher heading passes check (Closes #5776) | Created: 2026-10-03 | Updated: 2026-10-04 | 0 failing / 31 total
• Port gHashTag/trinity:fpga/openxc7-synth/d_g22_test.v (Verilog, 1 module) to specs/port/trinity/fpga/openxc7-synth/d_g22 #5757 Port gHashTag/trinity:fpga/openxc7-synth/d_g22_test.v (Verilog, 1 module) to specs/port/trinity/fpga/openxc7-synth/d_g22 | Created: 2026-10-03 | Updated: 2026-10-03 | 3 failing / 35 total
• Port gHashTag/trinity:fpga/openxc7-synth/d_y0_test.v (Verilog, 1 module) to specs/port/trinity/fpga/openxc7-synth/d_y0_t #5756 Port gHashTag/trinity:fpga/openxc7-synth/d_y0_test.v (Verilog, 1 module) to specs/port/trinity/fpga/openxc7-synth/d_y0_t | Created: 2026-10-03 | Updated: 2026-10-03 | 2 failing / 37 total
• Port scripts/tri-issue-create.py (Python, 1 function) to specs/port/scripts/tri-issue-create.t27 #5755 Port scripts/tri-issue-create.py (Python, 1 function) to specs/port/scripts/tri-issue-create.t27 | Created: 2026-10-03 | Updated: 2026-10-03 | 3 failing / 37 total
• fix(tri): gates preview reads the PR body the way the issue gate does (Closes #5744) #5745 fix(tri): gates preview reads the PR body the way the issue gate does (Closes #5744) | Created: 2026-10-03 | Updated: 2026-10-03 | 2 failing / 42 total
• fix(tri): gates preview asks the contexts the ruleset requires, parse-ratchet among them (Closes #5725) #5732 fix(tri): gates preview asks the contexts the ruleset requires, parse-ratchet among them (Closes #5725) | Created: 2026-10-03 | Updated: 2026-10-03 | 2 failing / 43 total
• Port gHashTag/trinity:fpga/openxc7-synth/d_e21_test.v (Verilog, 1 module) to specs/port/trinity/fpga/openxc7-synth/d_e21 #5689 Port gHashTag/trinity:fpga/openxc7-synth/d_e21_test.v (Verilog, 1 module) to specs/port/trinity/fpga/openxc7-synth/d_e21 | Created: 2026-10-03 | Updated: 2026-10-03 | 2 failing / 32 total
• spec(automation): kanban-card-chat v7 -- the bee's own log on a running card, live #5680 spec(automation): kanban-card-chat v7 -- the bee's own log on a running card, live | Created: 2026-10-03 | Updated: 2026-10-03 | 5 failing / 32 total
• docs(constitution): entrench Article CREDIT and seal it (v1.3) #5667 docs(constitution): entrench Article CREDIT and seal it (v1.3) | Created: 2026-10-03 | Updated: 2026-10-03 | 4 failing / 40 total
• specs/port/fpga/verilog/ternary_mac_synth.t27: rewrite w_code_to_mult/product in t27 form (explicit return, element-wise #5664 specs/port/fpga/verilog/ternary_mac_synth.t27: rewrite w_code_to_mult/product in t27 form (explicit return, element-wise | Created: 2026-10-03 | Updated: 2026-10-03 | 1 failing / 36 total
• Port gHashTag/trinity:fpga/openxc7-synth/symbiflow_blink.v (Verilog, 1 module) to specs/port/trinity/fpga/openxc7-synth/ #5663 Port gHashTag/trinity:fpga/openxc7-synth/symbiflow_blink.v (Verilog, 1 module) to specs/port/trinity/fpga/openxc7-synth/ | Created: 2026-10-03 | Updated: 2026-10-03 | 3 failing / 36 total
• docs(igla): re-take the corpus figures on master, 1150 specs (Refs #5497) #5610 docs(igla): re-take the corpus figures on master, 1150 specs (Refs #5497) | Created: 2026-10-02 | Updated: 2026-10-02 | 1 failing / 34 total
• The Queen's accept is the merge: dispatch.t27 says so, and its harness measures it #5452 The Queen's accept is the merge: dispatch.t27 says so, and its harness measures it | Created: 2026-10-01 | Updated: 2026-10-02 | 6 failing / 36 total

Summary

Status	Count
Total Open PRs	50
PRs with Failing Checks	46
PRs with All Checks Green	4
READY	1
FAILING	46
PENDING	0
NO CHECKS YET	0

These columns do not partition: 1 + 46 + 0 + 0 = 47, and there are 50 open PRs. A PR is being counted twice or not at all.

Seal Status

• ⚠️ STALE -- sha256(compiler.rs)=b45a356c2eb6 != manifest seal=87e5cbd3ad94.
  The committed NMSE numbers were certified against an older compiler.rs.
  Run scripts/reseal-check.sh locally for the two-step reseal command (advisory; not a merge gate).

[github-actions]

📓 NotebookLM Notebook linked to this PR

• Notebook ID: b83263109fb055dc
• URL: https://notebooklm.google.com/notebook/b83263109fb055dc

This notebook contains session context, decisions, and artifacts for this work.