You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Remove explanatory Rust prose that the #278 code-as-expression audit established is unnecessary for understanding the implementation, so source files remain readable through their names, types, modules, APIs, and control flow rather than through parallel prose maps.
Context
Audit #278 performed file-by-file header/comment ablation across the manually maintained production Rust surface and found no code-structure blocker: ordinary ownership, pipeline, responsibility, and execution summaries were classified as removable prose because the code already expresses that information.
Keeping that prose after proving it unnecessary adds stale-context and maintenance risk for both humans and coding agents.
Scope
Remove file/module headers and implementation comments that merely describe ownership, module purpose, pipeline stages, neighboring responsibilities, or obvious execution flow already discoverable from the code.
Remove stale or transient source commentary encountered in the audited removable-prose surface.
Preserve only comments/Rustdoc that carry information not reasonably expressible in code, such as external compatibility constraints, correctness/safety invariants, provenance/evidence, or real consumer-facing public contracts.
Re-check each affected file after removal; if a file becomes unclear without the prose, stop treating that prose as cleanup and identify the bounded code-structure defect instead.
Non-goals
Reducing comment count as a metric.
Removing useful public API Rustdoc or external contract/invariant documentation.
Changing behavior, ownership, crate boundaries, or public APIs.
Unrelated refactoring, renaming, or formatting cleanup.
Goal
Remove explanatory Rust prose that the #278 code-as-expression audit established is unnecessary for understanding the implementation, so source files remain readable through their names, types, modules, APIs, and control flow rather than through parallel prose maps.
Context
Audit #278 performed file-by-file header/comment ablation across the manually maintained production Rust surface and found no code-structure blocker: ordinary ownership, pipeline, responsibility, and execution summaries were classified as removable prose because the code already expresses that information.
Keeping that prose after proving it unnecessary adds stale-context and maintenance risk for both humans and coding agents.
Scope
Non-goals
Acceptance criteria
Dependencies / ownership