WP15: proposal package — README first screen, docs/ tree with R16, adoption artifacts#30
Merged
Merged
Conversation
…doption artifacts, docs number-block automation - README.md restructured to the spec:270-273 first-screen order (~150 lines): verbatim spec-1 blurb, the placeholder-independent core up front, compact generated digest blocks (WP5/WP6 markers kept, templates shrunk), the exact L-tagged safety-wording formula, one-command reproduce, honesty pointers. - NEW docs/ tree (14 files): concept (counterfactual paragraph: ClearSpace-1 ~EUR86M, ADRAS-J2 ~JPY13.2B FY2027-28 hedged, BETs/sail literature + the installer-niche statement), technical_architecture, gnc, safety (full WP5 tables + WP12 ladder as generated marker blocks), target_selection (full sail sweep + WP13 kit + classC blocks), cost_model (full WP6 block + WP14 anchor by reference), legal_regulatory, limitations, roadmap (stale WP14-not-started + schema-1.0 claims fixed), pitch_agencies (self-framed "adoption brief -- NOT a mission proposal", agency-agnostic), one_pager, technical_summary_5p, pitch_deck (12-slide md source), release_engineering (Zenodo DOI procedure documented; execution deferred until the owner provides an account -- spec:279-282 path; also flags the CMake-version-vs-tag and missing-phase-tag inconsistencies as owner decisions). - R16 enforced: NEW tools/docs/fill_docs_numbers.py regenerates every DOCS-* marker block in docs/ from the committed CSVs (+ ctest docs_numbers: --check, corruption detection, determinism); fill_readme_numbers.py templates rewritten for the compact digests; test_evidence.py gains the docs/ audit: R15 pin-list scan outside marker blocks (reference-line heuristic exempt; enforcement scope documented, mirroring the R14 pattern-list precedent), banned-word scan with honest-discussion carve-outs, spec-mandated file-list check. - ci.yml: runs the docs filler and the reproducibility gate now covers docs/ as well (generated/ evidence/ README.md docs/). - Comment-only sweep of 9 C++ files: stale "see README" pointers now point at the moved docs/ homes (verified comment-only by diff scan). - Evidence pack regenerated (inventory tracks the new tool + shifted lines). All 8 local Python suites green; both fillers --check clean; 151 relative links verified; anchor phrase + banned-word discipline verified. Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
…ule) The adversarial verifier's sole blocker: the flagship technical summary carried zero occurrences of the binding anchor phrase 'Kessler-precursor removal' (spec section 1: it must appear in all summary texts). Added to the opening framing sentence. Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
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
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.
Implements spec §6 WP15 (§269–285) + R16. Completes the WP10–WP15 chain.
What this adds
tools/docs/fill_docs_numbers.pyregenerates every DOCS-* marker block from committed CSVs (+docs_numbersctest); the claims-audit gains a docs/ sweep (R15 pin-list outside marker blocks, banned words with honest-discussion carve-outs, mandated-file-list check — enforcement scope documented, mirroring the R14 pattern-list precedent); the CI reproducibility gate now coversdocs/(generated + evidence + README + docs, all SHA-stable — validated live in this PR's runs).Disclosed items (spec §10)
docs/release_engineering.md; execution awaits an owner-provided account (spec:279–282 "considered and documented" path). A git tag + GitHub release land at this merge.release_engineering.mdflags two owner decisions found during the work:CMakeLists.txt project(VERSION 4.0)is not in lockstep with the git-tag scheme, and WP13/WP14 merged without phase tags (backfill vs accept).Verification
docs_numbers+ both fillers + the extended 4-path gate).🤖 Generated with Claude Code