DSPy fleet-rlm Integration

Patterns, debugging techniques, and integration guidance for using DSPy within the qredence/fleet-rlm-dspy codebase.

Environment Setup

This skill requires uv as the Python package manager.

uv venv
source .venv/bin/activate
uv pip install dspy

Rule: Never use raw pip. Always use uv pip for installs and uv run for script execution.

When to Use This Skill

Use this skill when:

• Working on DSPy modules inside the fleet-rlm codebase
• Debugging fleet-rlm DSPy issues
• Following fleet-rlm architecture conventions for DSPy
• Integrating new DSPy signatures or programs into fleet-rlm
• Understanding the fleet-rlm DSPy module layout

fleet-rlm Module Layout

The qredence/fleet-rlm-dspy codebase organizes DSPy code as:

src/fleet_rlm/
├── signatures.py          # Re-export shim (imports from _prod and _demo)
├── signatures_prod.py     # Production signatures (runtime)
├── signatures_demo.py     # Demo/example signatures
├── core/
│   ├── interpreter.py     # Core reasoning / DSPy program execution
│   ├── llm_tools.py       # LLM tool integration
│   └── config.py          # DSPy configuration
└── ...

Import Conventions

# Production signatures
from fleet_rlm.signatures import AnalyzeLongDocument, CodeChangePlan

# Core interpreter
from fleet_rlm.core.interpreter import ...

# Configuration
from fleet_rlm.core.config import ...

Core Concepts

Patterns & Debugging

See patterns.md for:

• fleet-rlm DSPy architecture overview
• Common issues and solutions
• Performance optimization
• Testing strategies

Examples

The assets/examples/ directory contains real examples from fleet-rlm:

• fleet-rlm-signatures.py: Production signatures from fleet-rlm

Critical Rules

1. Always use uv: uv pip for installs, uv run for scripts
2. Use absolute imports: Always use from fleet_rlm.signatures import ...
3. Set require_compiled: true: Enable in production to fail-fast on missing artifacts
4. JSON logging is default: Set LOG_JSON=0 for human-readable logs during development
5. Compilation is offline-only: Never compile at runtime in production
6. Clear cache after changes: Run clear-cache.py after modifying DSPy modules

Related Skills

• dspy-core: Signatures, modules, programs, and compilation fundamentals
• dspy-optimization: Optimization, metrics, evaluation, and teleprompters

Progressive Disclosure

1. SKILL.md (this file): Quick reference and navigation
2. references/: Detailed fleet-rlm patterns and debugging docs
3. assets/: Real examples from the fleet-rlm codebase