geox-basin-interpreter (Ψ_GEOX Domain Layer)
Purpose
Subsurface reasoning for basin screening, petroleum systems analysis, trap/seal/reservoir framing, and evidence-led interpretations.
Use When
- Screening basins or prospects for petroleum systems presence (source rock, migration pathway, reservoir, trap, and seal).
- Interpretations are requested based on seismic sections, structural maps, or well-log correlations.
- Conducting subsurface risk assessments (e.g. calculation of Geological Chance of Success - GCoS).
- Verifying subsurface candidate validity against structural or stratigraphic constraints.
- Ingesting or synthesizing geologic domain lit reviews, papers, or basin reports.
Do Not Use When
- The task is purely focused on petrophysical QC, well-log curve normalization, or curve sanity checks (use
geox-well-log-audit instead).
- The task requires calculating specific fluid-flow dynamic parameters inside well casings (use standard production engineering tools).
- The task requires writing standard system scripts or web designs (use generic engineering or design skills instead).
Inputs
- Seismic/Map Data: Grid coordinates, structural mapping files, or interpretive cross-sections.
- Well Context: Core descriptions, formation picks, or petrophysical summaries.
- Geochemical Context: Total Organic Carbon (TOC) levels, thermal maturity data (Ro%), or pressure profiles.
The Five-Box GCoS Evaluation Template
Every basin/prospect screening report must output the following five-box risk matrix:
### 1. Geological Chance of Success (GCoS) Matrix
| Element | Probability (Pg) | Primary Evidence | Key Risks & Contradictions |
| :--- | :---: | :--- | :--- |
| **Source (Charge)** | `0.0 - 1.0` | e.g. TOC/Ro% measurements from analogs | e.g. Kitchen thermal migration shadow |
| **Reservoir** | `0.0 - 1.0` | e.g. Core porosity, turbidite facies maps | e.g. Deep diagenetic quartz cementation |
| **Trap** | `0.0 - 1.0` | e.g. 3D seismic horizon closure amplitude | e.g. Lateral fault seal leakage risk |
| **Seal** | `0.0 - 1.0` | e.g. Continuous regional shale interval | e.g. Crestal fault breaching |
| **Timing & Migration** | `0.0 - 1.0` | e.g. Basin modeling maturation curves | e.g. Late trap deformation |
**Composite Geological Chance of Success (GCoS):**
`Pg_total = Pg_source × Pg_reservoir × Pg_trap × Pg_seal × Pg_timing`
`Pg_total = [Calculated Value]%` (Apply Humility Band: uncertainty margin of ±0.03 to ±0.05)
Procedure
- Framework Screening: Map the active geologic basin setting (e.g., extensional rift, passive margin, foreland basin) to set stratigraphic expectations.
- Petroleum Systems Element Audit: Evaluate each of the 5 crucial elements using the Five-Box GCoS Evaluation Template.
- STDP Geologic Evidential Loop: Verify all claims. Distinguish directly measured evidence (e.g., core plugs, DST tests) from indirect indicators (e.g. seismic amplitude anomalies) and speculative inference.
- GCoS Calculation: Compute probability metrics for each element. Multiply the elements to obtain the total Chance of Success (Pg_total).
- Evidence Matrix Serialization: Document all structural contradictions or faults mapped across the basin.
Postconditions
- All geologic inferences are explicitly tagged with their data source and confidence level.
- The resulting basin interpretation maps exact GCoS risk elements with empirical justification.
- All trap/seal/reservoir maps comply with physical compaction and pressure gradients.
Failure Modes & Escalation
- Data Scarcity: No well or seismic control exists for the screened block. Action: Rely strictly on analog basins. Tag all findings as "Estimate Only - Analog Grounded" and set GCoS risk margins to conservative bounds.
- Structural Discontinuity: Mapped faults show contradictory sealing history. Action: Flag the seal parameter as a critical system hazard, degrade interpretation class to
CAUTION, and escalate for expert validation.
Telemetry per Run
{
"skill_name": "geox-basin-interpreter",
"version": "1.1.0",
"trigger_phrase": "{{trigger_phrase}}",
"selected_reason": "{{selected_reason}}",
"latency_ms": 0,
"token_in": 0,
"token_out": 0,
"commands_run": 0,
"artifacts_written": 1,
"postcondition_pass": false,
"human_approval_required": false,
"hold_code": "{{hold_code}}"
}
Recursive Scorecard
- Activation Precision: [0.0 - 1.0] (Target: >0.90)
- Task Completion Rate: [0.0 - 1.0] (Target: >0.95)
- Rollback Safety: [0.0 - 1.0] (Target: 1.00)
- Context Efficiency: [0.0 - 1.0] (Target: >0.90)
- Doc Freshness: [0.0 - 1.0] (Target: 1.00)
- Cross-Skill Collision Rate: [0.0 - 1.0] (Target: <0.02)
- Human Trust Score: [0.0 - 1.0] (Target: >0.98)
1---2name: geox-basin-interpreter3description: Subsurface reasoning for basin screening, petroleum systems analysis, trap/seal/reservoir framing, and evidence-led interpretations. Load when geology, geophysics, or petrophysics tasks appear.4---5# geox-basin-interpreter (Ψ_GEOX Domain Layer)67## Purpose8Subsurface reasoning for basin screening, petroleum systems analysis, trap/seal/reservoir framing, and evidence-led interpretations.910## Use When111. Screening basins or prospects for petroleum systems presence (source rock, migration pathway, reservoir, trap, and seal).122. Interpretations are requested based on seismic sections, structural maps, or well-log correlations.133. Conducting subsurface risk assessments (e.g. calculation of Geological Chance of Success - GCoS).144. Verifying subsurface candidate validity against structural or stratigraphic constraints.155. Ingesting or synthesizing geologic domain lit reviews, papers, or basin reports.1617## Do Not Use When181. The task is purely focused on petrophysical QC, well-log curve normalization, or curve sanity checks (use `geox-well-log-audit` instead).192. The task requires calculating specific fluid-flow dynamic parameters inside well casings (use standard production engineering tools).203. The task requires writing standard system scripts or web designs (use generic engineering or design skills instead).2122## Inputs23* **Seismic/Map Data:** Grid coordinates, structural mapping files, or interpretive cross-sections.24* **Well Context:** Core descriptions, formation picks, or petrophysical summaries.25* **Geochemical Context:** Total Organic Carbon (TOC) levels, thermal maturity data (Ro%), or pressure profiles.2627## The Five-Box GCoS Evaluation Template2829Every basin/prospect screening report must output the following five-box risk matrix:3031```markdown32### 1. Geological Chance of Success (GCoS) Matrix3334| Element | Probability (Pg) | Primary Evidence | Key Risks & Contradictions |35| :--- | :---: | :--- | :--- |36| **Source (Charge)** | `0.0 - 1.0` | e.g. TOC/Ro% measurements from analogs | e.g. Kitchen thermal migration shadow |37| **Reservoir** | `0.0 - 1.0` | e.g. Core porosity, turbidite facies maps | e.g. Deep diagenetic quartz cementation |38| **Trap** | `0.0 - 1.0` | e.g. 3D seismic horizon closure amplitude | e.g. Lateral fault seal leakage risk |39| **Seal** | `0.0 - 1.0` | e.g. Continuous regional shale interval | e.g. Crestal fault breaching |40| **Timing & Migration** | `0.0 - 1.0` | e.g. Basin modeling maturation curves | e.g. Late trap deformation |4142**Composite Geological Chance of Success (GCoS):**43`Pg_total = Pg_source × Pg_reservoir × Pg_trap × Pg_seal × Pg_timing`44`Pg_total = [Calculated Value]%` (Apply Humility Band: uncertainty margin of ±0.03 to ±0.05)45```4647## Procedure481. **Framework Screening:** Map the active geologic basin setting (e.g., extensional rift, passive margin, foreland basin) to set stratigraphic expectations.492. **Petroleum Systems Element Audit:** Evaluate each of the 5 crucial elements using the **Five-Box GCoS Evaluation Template**.503. **STDP Geologic Evidential Loop:** Verify all claims. Distinguish *directly measured evidence* (e.g., core plugs, DST tests) from *indirect indicators* (e.g. seismic amplitude anomalies) and *speculative inference*.514. **GCoS Calculation:** Compute probability metrics for each element. Multiply the elements to obtain the total Chance of Success (Pg_total).525. **Evidence Matrix Serialization:** Document all structural contradictions or faults mapped across the basin.5354## Postconditions551. All geologic inferences are explicitly tagged with their data source and confidence level.562. The resulting basin interpretation maps exact GCoS risk elements with empirical justification.573. All trap/seal/reservoir maps comply with physical compaction and pressure gradients.5859## Failure Modes & Escalation60* **Data Scarcity:** No well or seismic control exists for the screened block. *Action:* Rely strictly on analog basins. Tag all findings as *"Estimate Only - Analog Grounded"* and set GCoS risk margins to conservative bounds.61* **Structural Discontinuity:** Mapped faults show contradictory sealing history. *Action:* Flag the seal parameter as a critical system hazard, degrade interpretation class to `CAUTION`, and escalate for expert validation.6263## Telemetry per Run64```json65{66 "skill_name": "geox-basin-interpreter",67 "version": "1.1.0",68 "trigger_phrase": "{{trigger_phrase}}",69 "selected_reason": "{{selected_reason}}",70 "latency_ms": 0,71 "token_in": 0,72 "token_out": 0,73 "commands_run": 0,74 "artifacts_written": 1,75 "postcondition_pass": false,76 "human_approval_required": false,77 "hold_code": "{{hold_code}}"78}79```8081## Recursive Scorecard82* **Activation Precision:** [0.0 - 1.0] (Target: >0.90)83* **Task Completion Rate:** [0.0 - 1.0] (Target: >0.95)84* **Rollback Safety:** [0.0 - 1.0] (Target: 1.00)85* **Context Efficiency:** [0.0 - 1.0] (Target: >0.90)86* **Doc Freshness:** [0.0 - 1.0] (Target: 1.00)87* **Cross-Skill Collision Rate:** [0.0 - 1.0] (Target: <0.02)88* **Human Trust Score:** [0.0 - 1.0] (Target: >0.98)