Documentation Index

Use this page as the canonical entrypoint for manuals, stage design, and latest run outputs.

Start Here

• Platform overview: README.md
• Access endpoints: docs/SITE_ACCESS.json
• URL map: docs/URL_INVENTORY.md
• Operations manual: docs/OPERATIONS_AND_OUTPUT_GUIDE.md
• Latest changes: docs/CHANGELOG.md
• HTML manuals in UI:
• http://localhost:3101/manuals/index.html

Stage Folders

• Stage index root: docs/stages/README.md
• Stage 01 Foundation: docs/stages/stage-01-foundation/README.md
• Stage 01B Well Log: docs/stages/stage-01b-welllog/README.md
• Stage 02 Analog + Risk: docs/stages/stage-02-analog-risk/README.md
• Stage 03 Digital Twin: docs/stages/stage-03-digital-twin/README.md

System Interaction Map

• End-to-end interaction map (what is integrated vs not yet wired):
• docs/architecture/SYSTEM_INTERACTION_MAP.md
• POV QA evaluation and implementation blueprint:
• docs/architecture/POV_TECHNICAL_QA_EVALUATION_IMPLEMENTATION_V1.md
• Wiicco/Toquis phased BOM and POV schema manual:
• docs/architecture/WIICCO_TOQUIS_PHASED_BOM_AND_POV_SCHEMA.md
• Well log payload architecture and module design:
• docs/architecture/WELLLOG_PAYLOAD_ARCHITECTURE_AND_MODULE_DESIGN.md
• Earthbond ontology blueprint and AI query layer:
• docs/architecture/EARTHBOND_ONTOLOGY_BLUEPRINT_AND_AI_QUERY_LAYER.md
• Well reopening scoring schema and worklist design:
• docs/architecture/WELL_REOPENING_SCORING_SCHEMA_AND_WORKLIST.md
• Full build explanation and AI decision log:
• docs/architecture/FULL_BUILD_EXPLANATION_AND_AI_DECISION_LOG.md
• Build rationale, schema, and IP defense:
• docs/architecture/BUILD_RATIONALE_SCHEMA_AND_IP_DEFENSE.md
• HTML manual:
• docs/architecture/BUILD_RATIONALE_SCHEMA_AND_IP_DEFENSE_MANUAL.html
• Decision defense report:
• HTML manual:
• docs/architecture/DECISION_DEFENSE_REPORT_MANUAL.html
• Database schema defense report:
• generated from:
• scripts/dev/generate_database_schema_defense_manual.py
• HTML manual:
• docs/architecture/DATABASE_SCHEMA_DEFENSE_REPORT_MANUAL.html
• Reference workflow alignment report:
• HTML manual:
• docs/architecture/REFERENCE_WORKFLOW_ALIGNMENT_REPORT_MANUAL.html
• Revised human workflow alignment report:
• HTML manual:
• docs/architecture/REVISED_HUMAN_WORKFLOW_ALIGNMENT_REPORT_MANUAL.html
• New human workflow comparison:
• generated SVG:
• docs/architecture/NEW_HUMAN_REFERENCE_VS_IMPLEMENTED_WORKFLOW_DETAILED.svg
• HTML manual:
• docs/architecture/NEW_HUMAN_WORKFLOW_COMPARISON_MANUAL.html
• Data platform storage and DB manual:
• generated from:
• scripts/dev/generate_data_platform_storage_manual.py
• HTML manual:
• docs/architecture/DATA_PLATFORM_STORAGE_AND_DB_MANUAL.html
• Database relationship schematic:
• generated from:
• scripts/dev/generate_database_relationship_schematic.py
• SVG:
• docs/architecture/DATABASE_RELATIONSHIP_SCHEMATIC_20260331.svg
• HTML manual:
• docs/architecture/DATABASE_RELATIONSHIP_SCHEMATIC_MANUAL.html
• Reference vs implemented workflow draw.io source:
• docs/architecture/EARTHBOND_REFERENCE_VS_IMPLEMENTED_WORKFLOW.drawio
• Reference workflow comparison diagram:
• HTML manual:
• docs/architecture/REFERENCE_WORKFLOW_COMPARISON_DIAGRAM_MANUAL.html
• generated SVG:
• docs/architecture/EARTHBOND_REFERENCE_VS_IMPLEMENTED_WORKFLOW_DETAILED.svg

Operations Reports

• Report catalog (latest + historical run artifacts):
• docs/operations/REPORT_INDEX.md
• Well-log traceability and known-result audit guide:
• docs/operations/WELLLOG_TRACEABILITY_AND_AUDIT.md
• Engineering edit checklist:
• docs/operations/EDIT_CHECKLIST.md
• IP and copyright compliance review:
• docs/operations/IP_AND_COPYRIGHT_COMPLIANCE_REVIEW.md
• Human input workflow log:
• docs/operations/HUMAN_INPUT_WORKFLOW_LOG_20260331.md
• Human input workflow log revision 2:
• docs/operations/HUMAN_INPUT_WORKFLOW_LOG_20260331_REVISION_2.md
• GitHub deploy runbook:
• docs/operations/GITHUB_DEPLOY_RUNBOOK.md
• GitHub canonical developer workflow:
• docs/operations/GITHUB_CANONICAL_DEVELOPER_WORKFLOW.md
• Earthbond local server bootstrap:
• scripts/ops/bootstrap_earthbond_server_clone.sh
• Repository split runbook:
• docs/operations/REPO_SPLIT_RUNBOOK.md
• WIICCO site export script:
• scripts/ops/export_wiicco_site_repo.sh
• Data platform storage and processing audit:
• docs/operations/DATA_PLATFORM_STORAGE_AND_PROCESSING_AUDIT_20260331.json
• docs/operations/DATA_PLATFORM_STORAGE_AND_PROCESSING_AUDIT_20260331.csv
• Earthbond build and access manual:
• docs/operations/EARTHBOND_BUILD_AND_ACCESS_MANUAL.md

Update Rule

When code or workflows change, update these together:

1. docs/CHANGELOG.md
2. docs/OPERATIONS_AND_OUTPUT_GUIDE.md
3. Stage README under docs/stages/*
4. docs/operations/REPORT_INDEX.md (if test output artifacts changed)