digitalmodel-code-explorer

name	digitalmodel-code-explorer
description	Fast orientation guide for the digitalmodel codebase, with module lookup, source-to-test mapping, and targeted inspection patterns to avoid repeated bulk-reading of digitalmodel/src and tests.
version	1.0.0
category	digitalmodel
type	skill
trigger	manual
auto_execute	false
capabilities	["module_indexing","source_test_mapping","package_orientation","targeted_code_lookup","architecture_navigation"]
tools	["Read","Grep","Bash"]
related_skills	["module-lookup"]
requires	[]
tags	["digitalmodel","code-explorer","navigation","architecture"]

Digitalmodel Code Explorer

Purpose

Use this skill to navigate digitalmodel/src/digitalmodel/ and its tests without bulk-reading large numbers of files. It is intended to reduce repeated manual source exploration by giving a fast module map and lookup workflow.

Core Areas in digitalmodel/src/digitalmodel/

Examples of major areas present on this machine include:

• fatigue/
• cathodic_protection/
• structural/
• subsea/
• reservoir/
• signal_processing/
• well/
• workflows/
• top-level helpers like engine.py, units.py, __main__.py

Recommended Exploration Pattern

1. Find the relevant package first

find digitalmodel/src/digitalmodel -maxdepth 2 -type f | head -50

2. Narrow by topic before reading files

Examples:

rg -n "rainflow|sn curve|fatigue" digitalmodel/src/digitalmodel/fatigue
rg -n "orcawave|diffraction|rao" digitalmodel/src/digitalmodel
rg -n "cathodic|anode|iccp" digitalmodel/src/digitalmodel/cathodic_protection

3. Read only the most relevant files

Prefer:

• package __init__.py
• API-facing modules
• the exact function/class implementation you matched
• the corresponding tests

Source -> Test Mapping Pattern

Before editing a source file, look for mirrored or neighboring tests.

Examples:

find digitalmodel/tests -type f | rg "fatigue|cathodic|orcawave|orcaflex"

Heuristic mapping:

• digitalmodel/src/digitalmodel/fatigue/<module>.py -> search under digitalmodel/tests/ for <module> or the package name
• package-level behavior -> check digitalmodel/tests/<package>/ and