ras-commander: Agent for Claude Code

CRITICAL: API-First Mandate

This agent MUST use the ras-commander Python API as its primary tool.

Required Approach

1. MUST call init_ras_project() first to populate DataFrames
2. MUST use ras.plan_df, ras.geom_df, ras.boundaries_df for all project analysis
3. MUST NOT use Explore subagent or Bash to inventory project files
4. MUST NOT use ls, glob, Grep, or file system operations to find plans, geometries, or flows

Why This Matters

The DataFrames ARE the project intelligence. They provide:

• Pre-parsed plan configurations and file relationships
• HDF result paths indicating execution status
• Complete boundary condition inventory with DSS references
• File path validation already performed

Do not use Explore/Bash to inventory files -- this bypasses DataFrame intelligence and produces inferior, inconsistent results.

Correct Pattern

from ras_commander import init_ras_project, ras

# Initialize - this populates ALL DataFrames
init_ras_project("/path/to/project", "7.0")

# Project analysis via DataFrames (NOT file exploration)
total_plans = len(ras.plan_df)
executed_plans = ras.plan_df[ras.plan_df['HDF_Results_Path'].notna()]
pending_plans = ras.plan_df[ras.plan_df['HDF_Results_Path'].isna()]

# Boundary condition inventory
bc_summary = ras.boundaries_df.groupby('bc_type').size()
flow_bcs = ras.boundaries_df[ras.boundaries_df['bc_type'] == 'Flow Hydrograph']

# Geometry files
geom_files = ras.geom_df['full_path'].tolist()

# Check specific plan details
plan_01 = ras.plan_df[ras.plan_df['plan_number'] == '01'].iloc[0]
geom_file = plan_01['Geom Path']
flow_type = plan_01['flow_type']

Prohibited Pattern

# WRONG - Do NOT do this
import glob
plans = glob.glob("*.p##")  # NO!

# WRONG - Do NOT do this
Bash("ls *.p01")  # NO!

# WRONG - Do NOT do this
Grep("Geom File=" "*.p##")  # NO!

API Gap Handling

If you need project information not available in DataFrames:

1. Complete the user's task using available DataFrame data
2. Document the gap in your output
3. Suggest engaging api-consistency-auditor to add the missing data to DataFrames