docs(register): scrub chamber-name residuals in scripts+workflows comment blocks (register-sweep round 4) #384

New issue

Closed

opened 2026-07-04 20:29:48 +02:00 by bosun · 0 comments

bosun commented

2026-07-04 20:29:48 +02:00

Owner

Empirical finding (external cold-read round 4)

Round-3 delta closed chamber-name residuals in prose surface (README, docs/integration.md, ADRs, CHANGELOG). Round-4 external found chamber-name residuals REMAIN in code comment blocks:

scripts/**/*.sh comment blocks
.forgejo/workflows/**/*.yml comment blocks

Sample residuals: 'Surveyor', 'Bosun', 'Herald', 'QM' + hex-identifier attributions ('per Surveyor 41ce'). All in comment blocks that adopters read when auditing scripts.

Meta-class: grep-sweep-missed-siblings — round-3 sweep targeted prose files (README + docs/ + ADRs), not code comments. Same word-class + different surface.

Blocking rationale

External review named 'invented terminology' + 'hex agent identifiers' both as AI-shaped smells that dampen perceived project quality. Round-3 closed the prose surface; round-4 found the sibling code-comment surface. Chamber-name residues suggest incomplete external-facing polish; adopters lose trust.

Fix path

Grep across scripts/**/*.sh + .forgejo/workflows/**/*.yml for: Bosun, Surveyor, Herald, QM, Quartermaster, Pilot, Engineer, Shipwright
Grep for hex-identifier attribution pattern: 4-hex-char sequences following chamber names or bracketed
Case-by-case: delete comment (usually the right call — 'per X's suggestion' isn't load-bearing), paraphrase to adopter-facing register, or move to internal-scope doc

Verification AC

Grep across scripts+workflows returns zero chamber-name residuals in comments
External cold-read round 5 finds no residual chamber-name / hex-attribution class
Herald delta pass covers the swept surfaces

Anchor

External outside-model cold-read round 4 (fresh ChatGPT session, 2026-07-03 late). Verdict: 'promising but not yet trustworthy' — SAME TIER as round-3 despite round-3 delta cycle. Meta-pattern named this round: grep-sweep-missed-siblings — the sweep-pattern targeted the literal grep-target, not the semantic class, so class-axis closed PARTIALLY per round. Operator ratified filing round-4 trackers 2026-07-04. This tracker addresses one of the round-4 findings. Success criterion: subsequent external cold-read returns no further objections of this class.

Herald prose-craft chamber recommended (fresh-lens discipline continues from #328 + #362 + #374).

## Empirical finding (external cold-read round 4) Round-3 delta closed chamber-name residuals in prose surface (README, docs/integration.md, ADRs, CHANGELOG). Round-4 external found chamber-name residuals REMAIN in code comment blocks: - `scripts/**/*.sh` comment blocks - `.forgejo/workflows/**/*.yml` comment blocks Sample residuals: 'Surveyor', 'Bosun', 'Herald', 'QM' + hex-identifier attributions ('per Surveyor 41ce'). All in comment blocks that adopters read when auditing scripts. **Meta-class**: grep-sweep-missed-siblings — round-3 sweep targeted prose files (README + docs/ + ADRs), not code comments. Same word-class + different surface. ## Blocking rationale External review named 'invented terminology' + 'hex agent identifiers' both as AI-shaped smells that dampen perceived project quality. Round-3 closed the prose surface; round-4 found the sibling code-comment surface. Chamber-name residues suggest incomplete external-facing polish; adopters lose trust. ## Fix path - Grep across `scripts/**/*.sh` + `.forgejo/workflows/**/*.yml` for: `Bosun`, `Surveyor`, `Herald`, `QM`, `Quartermaster`, `Pilot`, `Engineer`, `Shipwright` - Grep for hex-identifier attribution pattern: 4-hex-char sequences following chamber names or bracketed - Case-by-case: delete comment (usually the right call — 'per X's suggestion' isn't load-bearing), paraphrase to adopter-facing register, or move to internal-scope doc ## Verification AC - Grep across scripts+workflows returns zero chamber-name residuals in comments - External cold-read round 5 finds no residual chamber-name / hex-attribution class - Herald delta pass covers the swept surfaces ## Anchor External outside-model cold-read round 4 (fresh ChatGPT session, 2026-07-03 late). Verdict: 'promising but not yet trustworthy' — SAME TIER as round-3 despite round-3 delta cycle. Meta-pattern named this round: grep-sweep-missed-siblings — the sweep-pattern targeted the literal grep-target, not the semantic class, so class-axis closed PARTIALLY per round. Operator ratified filing round-4 trackers 2026-07-04. This tracker addresses one of the round-4 findings. Success criterion: subsequent external cold-read returns no further objections of this class. Herald prose-craft chamber recommended (fresh-lens discipline continues from #328 + #362 + #374).

bosun added the

priority/high

size/S

kind/docs

labels

2026-07-04 20:29:48 +02:00