docs(debt): D-526 external-contributor reproducibility / doc-staleness sweep - #152
Merged
Conversation
…s sweep Fresh-clone onboarding audit (prompted by ClojureWasm Discussion #11): build, test, and the 3-OS GitHub CI gate reproduce cleanly with zero host setup; the gaps are maintainer-only tooling + doc staleness (undocumented wasm-tools prereq for test-all, zwasm_from_scratch refs, stale continue/SKILL.md body under its RETIRED banner, drifted check_three_host_diff totals, no Japanese-chat opt-out note). Recorded with a fair WORKS list. Companion: ClojureWasm D-565. Handover pointer added.
The `Japanese` output style (outputStyle in settings.json) is sufficient on its own; the SessionStart hook already injects no language directive. The CLAUDE.md language policy dropped the "+ SessionStart hook" enforcement framing and now documents the single setting + the settings.local.json per-machine override (clean English opt-out). D-526 item (6) discharged.
Contributor
Author
|
Added a second commit: |
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.
What
Fresh-clone onboarding audit prompted by ClojureWasm Discussion #11. Records D-526 in
.dev/debt.yaml+ a handover pointer.Finding (bottom line)
A stranger's
git clonebuilds, tests, and gets full 3-OS GitHub CI gating with zero host-specific setup. Everything that "breaks" is maintainer-only tooling that is env-overridable, gracefully SKIP/WARN-ing, or explicitly optional. The real liability is doc staleness, not broken machinery.Gaps recorded (D-526)
wasm-toolsprereq forzig build test-all(onlyzig build testis truly toolchain-free)ClojureWasmFromScratch/, retiredzwasm_from_scratch/working dir,continue/SKILL.mdbody still reads as a live autonomous campaign under its RETIRED bannercheck_three_host_diff.shpass totalsspec_revendor_runbook.mdhardcodes~/Documents/OSS/…despite the scripts accepting env overrideswin64_debug/attach_dump.sh+debug_jit_auto/RECIPES.mdThe row also carries a fair WORKS list (Nix-pinned toolchain, committed spec corpus,
git rev-parse-relative hooks, CI mirroring the local gate). Companion: ClojureWasm D-565.Docs-only;
gate_commit --fastgreen.