|
| 1 | +{ |
| 2 | + "document_id": "REVIEW-GUIDE-001", |
| 3 | + "title": "ChatGPT Review Guide — HUF Repo Structure and Priority Files", |
| 4 | + "date": "2026-04-05", |
| 5 | + "prepared_by": "Claude (Opus 4.6)", |
| 6 | + "purpose": "Structured entry point for ChatGPT to review the Higgins Unity Framework repo after the April 5 reorganisation. Start here. Follow the tiers. Report findings against the verification checklist at the bottom.", |
| 7 | + "repo_url": "https://github.com/PeterHiggins19/Higgins-Unity-Framework", |
| 8 | + |
| 9 | + "repo_structure": { |
| 10 | + "description": "312 verified files. 16 sessions tracked (S000–S015, all pushed). Governance state: (CGS-2, n=3).", |
| 11 | + "top_level": { |
| 12 | + "files": ["LICENSE", "README.md", "START_HERE.md"], |
| 13 | + "note": "START_HERE.md is the onboarding document for new reviewers." |
| 14 | + }, |
| 15 | + "directories": { |
| 16 | + "drafts/codawork-2026/": { |
| 17 | + "purpose": "COIMBRA CORE — 27 files. The science, the presentation, the defense. This is the focused conference material.", |
| 18 | + "subfolders": { |
| 19 | + "post-coimbra/": "11 files. Second Room material: CGS, Ramsar, scaling, confidence framework, governance declaration. Real and important but NOT for first contact at Coimbra.", |
| 20 | + "archive/": "8 files. Superseded versions (abstract v1, v2), historical documents, Off Table items (Peterson letter). Preserved for the record." |
| 21 | + } |
| 22 | + }, |
| 23 | + "data/codawork-samples/": { |
| 24 | + "purpose": "The evidence. Raw data and computed results. 5 files.", |
| 25 | + "note": "This is where the numbers live. Everything in the science documents should trace back here." |
| 26 | + }, |
| 27 | + "huf-gov/": { |
| 28 | + "purpose": "The instrument architecture. Governance, science, evidence, tools. 51 files.", |
| 29 | + "key_subfolders": { |
| 30 | + "governance/": "Kill test, open-loop doctrine, GOV/CLS separation, safety. 7 files.", |
| 31 | + "tools/spectrum-analyzer/": "The v3 HTML demonstrator. 3 files.", |
| 32 | + "evidence/case-studies/": "Backblaze, energy, GDP, Planck, Ramsar, Toronto. Historical case studies." |
| 33 | + } |
| 34 | + }, |
| 35 | + "huf-cls/": "Closed-loop architecture. NOT for Coimbra. 16 files.", |
| 36 | + "process/": { |
| 37 | + "purpose": "Collective reports, staging manifest, governance docs, review traces. 48 files.", |
| 38 | + "key_files": ["STAGING_MANIFEST.json", "collective-reports/CRPT-007.json", "collective-reports/CRPT-008.json", "collective-reports/CRPT-009.json"] |
| 39 | + }, |
| 40 | + "reference/": "Historical reference material. 112 files. Machine-readable JSONs, technical notes, pillars, wiki. The fossil record — not the living organism.", |
| 41 | + "archive/": "Pre-standardised papers and tools. 12 files.", |
| 42 | + "context-books/": "4 editions of the advanced theory book (engineering, general, physics, sciences).", |
| 43 | + "math-books/": "4 editions of the mathematics reference (engineering, general, physics, sciences)." |
| 44 | + } |
| 45 | + }, |
| 46 | + |
| 47 | + "review_tiers": { |
| 48 | + "instructions": "Review in this order. Each tier builds on the previous. Do not skip to Tier 3 without reading Tier 1.", |
| 49 | + |
| 50 | + "tier_1_the_science": { |
| 51 | + "start_here": true, |
| 52 | + "description": "The empirical evidence. If this is wrong, nothing else matters.", |
| 53 | + "files": [ |
| 54 | + { |
| 55 | + "path": "drafts/codawork-2026/COHERENCE_RESIDUAL_RESULTS.md", |
| 56 | + "what_it_is": "First empirical computation of the coherence residual on EMBER. The spearpoint finding.", |
| 57 | + "check_for": [ |
| 58 | + "Is the CR method sound or is the ad hoc normalised coupling indicator too fragile?", |
| 59 | + "Are the thresholds (TV>0.05, Aitchison>0.5, CR>0.4) defensible or arbitrary?", |
| 60 | + "Is the 31% STRUCTURAL finding robust or an artefact of threshold choice?", |
| 61 | + "Is the Egozcue-Greenacre framing accurate and fair to both sides?", |
| 62 | + "Are the six honest caveats sufficient or are we missing something critical?" |
| 63 | + ] |
| 64 | + }, |
| 65 | + { |
| 66 | + "path": "data/codawork-samples/ember_coherence_residual.json", |
| 67 | + "what_it_is": "Machine-readable CR results. 74 transitions, 3 countries, 8 SBP nodes each.", |
| 68 | + "check_for": [ |
| 69 | + "Do the numbers match the claims in COHERENCE_RESIDUAL_RESULTS.md?", |
| 70 | + "Is the SBP design physically motivated?", |
| 71 | + "Are the balance deltas and Aitchison distances internally consistent?" |
| 72 | + ] |
| 73 | + }, |
| 74 | + { |
| 75 | + "path": "data/codawork-samples/backblaze_coherence_residual.json", |
| 76 | + "what_it_is": "Cross-domain validation. 900,000+ drives, 4 manufacturers, same three diagnostics.", |
| 77 | + "check_for": [ |
| 78 | + "Is the SMART-based health classification defensible?", |
| 79 | + "Does the GDoF calculation (264) hold?", |
| 80 | + "Is CGS-2 legitimately reached?", |
| 81 | + "Do the same pattern families genuinely appear or is it pattern matching?" |
| 82 | + ] |
| 83 | + }, |
| 84 | + { |
| 85 | + "path": "data/codawork-samples/ember_multisite_compositions.csv", |
| 86 | + "what_it_is": "Raw EMBER composition data. The input to everything.", |
| 87 | + "check_for": ["Data integrity. Are the compositions proper (sum to 1)?"] |
| 88 | + }, |
| 89 | + { |
| 90 | + "path": "drafts/codawork-2026/ENTANGLEMENT_ERROR_ANALYSIS.md", |
| 91 | + "what_it_is": "The 25-error calibration catalogue. E-01–E-17 active, E-18/E-19 future, ES-01–ES-06 scaling.", |
| 92 | + "check_for": [ |
| 93 | + "Is each error source genuinely distinct?", |
| 94 | + "Are the detection tests actionable?", |
| 95 | + "Are there obvious missing error sources?" |
| 96 | + ] |
| 97 | + } |
| 98 | + ] |
| 99 | + }, |
| 100 | + |
| 101 | + "tier_2_conference_package": { |
| 102 | + "description": "The conference-facing artifacts. Must be internally consistent and aligned with Tier 1 evidence.", |
| 103 | + "files": [ |
| 104 | + { |
| 105 | + "path": "drafts/codawork-2026/abstract_v3.md", |
| 106 | + "what_it_is": "197-word abstract. Three diagnostics, CR results, Backblaze, 25 errors.", |
| 107 | + "check_for": [ |
| 108 | + "Does it say what it needs to say in 197 words?", |
| 109 | + "Are the three alignment sentences present?", |
| 110 | + "Would this abstract get accepted at a CoDa conference?" |
| 111 | + ] |
| 112 | + }, |
| 113 | + { |
| 114 | + "path": "drafts/codawork-2026/PRESENTATION_SCRIPT.md", |
| 115 | + "what_it_is": "16-slide talk script. 10-12 minutes. Includes CR results (Slide 10) and Backblaze (Slide 11).", |
| 116 | + "check_for": [ |
| 117 | + "Is the pacing right for 10-12 minutes?", |
| 118 | + "Is the CR explanation on Slide 10 clear to a mathematician?", |
| 119 | + "Does the closing carry all three alignment sentences?", |
| 120 | + "Is the white flag posture correct or too submissive?" |
| 121 | + ] |
| 122 | + }, |
| 123 | + { |
| 124 | + "path": "drafts/codawork-2026/THE_UNION.md", |
| 125 | + "what_it_is": "The thesis statement. What CoDa brings, what HUF brings, what only the union produces.", |
| 126 | + "check_for": [ |
| 127 | + "Does the opening paragraph carry the three alignment sentences?", |
| 128 | + "Does Section 3b (CR as third diagnostic) match the empirical results?", |
| 129 | + "Does the architecture diagram say 'three-diagnostic protocol' not 'dual-metric'?", |
| 130 | + "Is the deployment path realistic?" |
| 131 | + ] |
| 132 | + }, |
| 133 | + { |
| 134 | + "path": "drafts/codawork-2026/CONFERENCE_CORE_STACK.pdf", |
| 135 | + "what_it_is": "One-page triage handout. Front Room / Second Room / Off Table.", |
| 136 | + "check_for": [ |
| 137 | + "Is the Front Room / Second Room sorting correct?", |
| 138 | + "Should anything move between zones?", |
| 139 | + "Are the three alignment sentences in the box?" |
| 140 | + ] |
| 141 | + }, |
| 142 | + { |
| 143 | + "path": "drafts/codawork-2026/HUF_MC4_CoDaWork_Packet_v3.docx", |
| 144 | + "what_it_is": "Conference handout. 4 parts: CoDa primer, methods challenge, EMBER case, metric correction.", |
| 145 | + "check_for": [ |
| 146 | + "CRITICAL: This predates the CR results. Does it need a v4?", |
| 147 | + "Is it inconsistent with abstract_v3.md on diagnostic count or error count?", |
| 148 | + "Does Part II still say 'dual-metric' instead of 'three diagnostics'?" |
| 149 | + ] |
| 150 | + }, |
| 151 | + { |
| 152 | + "path": "drafts/codawork-2026/TWO_MONTH_ROADMAP.md", |
| 153 | + "what_it_is": "Validation plan. 10 ranked weaknesses, week-by-week calendar, depth vs width framework.", |
| 154 | + "check_for": [ |
| 155 | + "Is the priority ordering correct?", |
| 156 | + "Are we missing a weakness that could kill the Coimbra conversation?", |
| 157 | + "Is the depth-then-width sequencing right?" |
| 158 | + ] |
| 159 | + } |
| 160 | + ] |
| 161 | + }, |
| 162 | + |
| 163 | + "tier_3_instrument_architecture": { |
| 164 | + "description": "How HUF-GOV works. The engineering that makes this more than a data analysis notebook.", |
| 165 | + "files": [ |
| 166 | + { |
| 167 | + "path": "huf-gov/governance/KILL-001-kill-test.json", |
| 168 | + "what_it_is": "The kill test. How HUF can be falsified.", |
| 169 | + "check_for": ["Are the kill conditions clear and testable?"] |
| 170 | + }, |
| 171 | + { |
| 172 | + "path": "huf-gov/governance/LOOP-001-open-loop-doctrine.json", |
| 173 | + "what_it_is": "Open-loop doctrine. HUF-GOV reads, does not act.", |
| 174 | + "check_for": ["Is the GOV/CLS separation clean?"] |
| 175 | + }, |
| 176 | + { |
| 177 | + "path": "huf-gov/tools/spectrum-analyzer/HUF_Spectrum_Analyzer_v3.html", |
| 178 | + "what_it_is": "The demonstrator. The instrument in action.", |
| 179 | + "check_for": [ |
| 180 | + "Does the title still say 'Unified Command Dashboard'? It should say 'CoDa Calibration Demonstrator'.", |
| 181 | + "Does it behave as a lab instrument or a command system?" |
| 182 | + ] |
| 183 | + }, |
| 184 | + { |
| 185 | + "path": "drafts/codawork-2026/THE_LINEAGE.md", |
| 186 | + "what_it_is": "Origin story. Loudspeaker physics to CoDa.", |
| 187 | + "check_for": ["Does the BTL physics narrative hold up? Is it compelling to a mathematician?"] |
| 188 | + }, |
| 189 | + { |
| 190 | + "path": "drafts/codawork-2026/WHAT_HUF_IS.md", |
| 191 | + "what_it_is": "Instrument description. GOV/CLS fork, PLL architecture.", |
| 192 | + "check_for": ["Is the instrument description consistent with THE_UNION.md and the analyzer?"] |
| 193 | + }, |
| 194 | + { |
| 195 | + "path": "drafts/codawork-2026/THE_THIRD_DIAGNOSTIC.md", |
| 196 | + "what_it_is": "CR theory document. Predicted the four agreement patterns before computation.", |
| 197 | + "check_for": ["Do the predictions match the empirical results in COHERENCE_RESIDUAL_RESULTS.md?"] |
| 198 | + } |
| 199 | + ] |
| 200 | + }, |
| 201 | + |
| 202 | + "tier_4_supporting_evidence": { |
| 203 | + "description": "Reference material. Consult as needed, do not review exhaustively.", |
| 204 | + "files": [ |
| 205 | + { |
| 206 | + "path": "reference/machine-readable/Metric_Correction_L2_vs_TVD_v1.0.json", |
| 207 | + "what_it_is": "The L2→TV metric correction. Proves the project catches its own errors." |
| 208 | + }, |
| 209 | + { |
| 210 | + "path": "reference/machine-readable/RWA_Corporate_Reference_v1.0.json", |
| 211 | + "what_it_is": "Corporate identity. Correct email: PeterHiggins@RogueWaveAudio.com." |
| 212 | + }, |
| 213 | + { |
| 214 | + "path": "reference/machine-readable/EMBER_Deceptive_Drift_Analysis_v3.0.json", |
| 215 | + "what_it_is": "Original EMBER deceptive drift finding. Where the CoDa path started." |
| 216 | + }, |
| 217 | + { |
| 218 | + "path": "drafts/codawork-2026/CODA_LITERATURE_CROSS_REFERENCE.md", |
| 219 | + "what_it_is": "Maps HUF concepts to published CoDa literature." |
| 220 | + }, |
| 221 | + { |
| 222 | + "path": "drafts/codawork-2026/FORMULA_REFERENCE.md", |
| 223 | + "what_it_is": "All formulas in one place." |
| 224 | + } |
| 225 | + ] |
| 226 | + }, |
| 227 | + |
| 228 | + "tier_5_collective_record": { |
| 229 | + "description": "Process documents. Read CRPT-009 for current state; older reports for history.", |
| 230 | + "files": [ |
| 231 | + { |
| 232 | + "path": "process/collective-reports/CRPT-009.json", |
| 233 | + "what_it_is": "Current session report. Conference alignment, folder restructure, validation roadmap." |
| 234 | + }, |
| 235 | + { |
| 236 | + "path": "process/collective-reports/CRPT-008.json", |
| 237 | + "what_it_is": "Prior session. CR computation, Backblaze, CGS creation." |
| 238 | + }, |
| 239 | + { |
| 240 | + "path": "process/collective-reports/CRPT-007.json", |
| 241 | + "what_it_is": "The CoDa entanglement session. All four original AI reviews." |
| 242 | + }, |
| 243 | + { |
| 244 | + "path": "process/STAGING_MANIFEST.json", |
| 245 | + "what_it_is": "Full file history S000–S015. Every change tracked. File count verified at 312." |
| 246 | + } |
| 247 | + ] |
| 248 | + } |
| 249 | + }, |
| 250 | + |
| 251 | + "do_not_review": { |
| 252 | + "description": "These are preserved for the record but should not consume review time.", |
| 253 | + "paths": [ |
| 254 | + "drafts/codawork-2026/archive/ — superseded versions and Off Table items", |
| 255 | + "huf-cls/ — closed-loop architecture, not for Coimbra", |
| 256 | + "archive/ — pre-standardised papers and old tools", |
| 257 | + "context-books/ — advanced theory editions (reference only)", |
| 258 | + "math-books/ — mathematics reference editions (reference only)", |
| 259 | + "reference/machine-readable/ — 65 historical JSONs (the fossil record)", |
| 260 | + "reference/pillars/ — original development documents", |
| 261 | + "reference/technical-notes/ — 20 technical notes from pre-CoDa era", |
| 262 | + "process/review-traces/ — 25+ historical trace documents", |
| 263 | + "process/governance-docs/ — internal governance process documents" |
| 264 | + ] |
| 265 | + }, |
| 266 | + |
| 267 | + "three_alignment_sentences": { |
| 268 | + "description": "Every conference-facing artifact must contain these. Verify their presence.", |
| 269 | + "sentence_1": "This is a calibration study of a compositional monitoring instrument, not a finished framework.", |
| 270 | + "sentence_2": "The instrument uses three diagnostics: total variation distance, Aitchison distance, and the coherence residual.", |
| 271 | + "sentence_3": "A 25-error calibration catalogue with detection tests and governance actions makes the instrument falsifiable.", |
| 272 | + "verified_in": ["abstract_v3.md", "PRESENTATION_SCRIPT.md", "THE_UNION.md", "CONFERENCE_CORE_STACK.pdf"], |
| 273 | + "flag_if_found": "Any conference-facing file still saying '17-error', 'dual-metric protocol', or missing the coherence residual as third diagnostic." |
| 274 | + }, |
| 275 | + |
| 276 | + "verification_checklist": { |
| 277 | + "description": "ChatGPT: report against each of these after review.", |
| 278 | + "items": [ |
| 279 | + { |
| 280 | + "id": "V-01", |
| 281 | + "check": "Do the numbers in COHERENCE_RESIDUAL_RESULTS.md match ember_coherence_residual.json?", |
| 282 | + "expected": "Mean CR ~0.58, 31% STRUCTURAL, 1.4% LOCAL_EVENT" |
| 283 | + }, |
| 284 | + { |
| 285 | + "id": "V-02", |
| 286 | + "check": "Does backblaze_coherence_residual.json support the CGS-2 claim?", |
| 287 | + "expected": "GDoF = 264, CGS = 2.42, same pattern families as EMBER" |
| 288 | + }, |
| 289 | + { |
| 290 | + "id": "V-03", |
| 291 | + "check": "Are all three alignment sentences in abstract_v3, PRESENTATION_SCRIPT, THE_UNION, and CONFERENCE_CORE_STACK?", |
| 292 | + "expected": "All present. Zero stale '17-error' or 'dual-metric' references in core." |
| 293 | + }, |
| 294 | + { |
| 295 | + "id": "V-04", |
| 296 | + "check": "Is HUF_MC4_CoDaWork_Packet_v3.docx consistent with abstract_v3?", |
| 297 | + "expected": "Likely inconsistent — packet predates CR results. Flag for v4 consideration." |
| 298 | + }, |
| 299 | + { |
| 300 | + "id": "V-05", |
| 301 | + "check": "Does THE_THIRD_DIAGNOSTIC.md predict the four patterns that COHERENCE_RESIDUAL_RESULTS.md found?", |
| 302 | + "expected": "Yes — theory predicted STABLE, LOCAL_EVENT, COUPLED_EVENT, STRUCTURAL. All four appear in data." |
| 303 | + }, |
| 304 | + { |
| 305 | + "id": "V-06", |
| 306 | + "check": "Does the analyzer title still say 'Unified Command Dashboard'?", |
| 307 | + "expected": "Probably yes — title softening is a pending item. Flag for fix." |
| 308 | + }, |
| 309 | + { |
| 310 | + "id": "V-07", |
| 311 | + "check": "Is the folder structure clean? No stale files in codawork-2026/ top level?", |
| 312 | + "expected": "27 core files. CGS, CMSI, Ramsar, etc. all in post-coimbra/. Old abstracts and Peterson in archive/." |
| 313 | + }, |
| 314 | + { |
| 315 | + "id": "V-08", |
| 316 | + "check": "Does TWO_MONTH_ROADMAP.md identify the right four priority weaknesses?", |
| 317 | + "expected": "W-1 independence, W-2 CR grounding, W-3 thresholds, W-4 SBP sensitivity. Is anything missing?" |
| 318 | + }, |
| 319 | + { |
| 320 | + "id": "V-09", |
| 321 | + "check": "Is the error count consistent everywhere in core documents?", |
| 322 | + "expected": "25 in all core files. 17+2+6 breakdown where elaborated." |
| 323 | + }, |
| 324 | + { |
| 325 | + "id": "V-10", |
| 326 | + "check": "File count: does STAGING_MANIFEST say 312?", |
| 327 | + "expected": "Yes. Verified by full repo scan. Count correction note explains FOR_SHARON.md deletion." |
| 328 | + } |
| 329 | + ] |
| 330 | + }, |
| 331 | + |
| 332 | + "post_coimbra_for_later": { |
| 333 | + "description": "These files are in post-coimbra/ subfolder. Review only after Tier 1 and Tier 2 are complete.", |
| 334 | + "files": [ |
| 335 | + "COMPOSITIONAL_GOVERNANCE_SCALE.md — the five-level CGS framework", |
| 336 | + "RAMSAR_COMPLEXITY_GAP.md — 10 deployment gaps (3 CRITICAL, 3 SERIOUS, 4 MODERATE)", |
| 337 | + "SCALING_COHERENCE.md — telescoping binary balances for deep hierarchies", |
| 338 | + "CONFIDENCE_INDEX.md — 3^n systems confidence framework", |
| 339 | + "Q_INQUISITOR.md — Small's Q as compositional coupling quality", |
| 340 | + "GOVERNANCE_DECLARATION.md — 8 known unknowns, 5 doubts, full transparency", |
| 341 | + "CONJ-001-winning-horse.md — strategic conjecture", |
| 342 | + "FULL_SYSTEM_ASSESSMENT.xlsx — W/M/X/Z assessment matrix", |
| 343 | + "S013_DOCUMENT_COMPARISON.xlsx — 28-dimension document comparison with 1/Q insight", |
| 344 | + "CMSI.md — superseded by CGS, retained as development record", |
| 345 | + "CONFERENCE_CONCEPTS.md — concept inventory" |
| 346 | + ] |
| 347 | + }, |
| 348 | + |
| 349 | + "governance_state": { |
| 350 | + "current": "(CGS-2, n=3)", |
| 351 | + "gdof": 264, |
| 352 | + "cgs": 2.42, |
| 353 | + "corpus": 312, |
| 354 | + "sessions": 16, |
| 355 | + "all_pushed": true, |
| 356 | + "contact": "PeterHiggins@RogueWaveAudio.com" |
| 357 | + } |
| 358 | +} |
0 commit comments