# EVOLV Scientific & Technical Reference Library

## Purpose

This directory contains curated reference documents for EVOLV's domain-specialist agents. These summaries distill authoritative sources into actionable knowledge that agents should consult **before making scientific or engineering claims**.

## How Agents Should Use This

1. **Before making domain claims**: Read the relevant reference doc to verify your reasoning
2. **Cite sources**: When referencing scientific facts, point to the specific reference doc and its cited sources
3. **Acknowledge uncertainty**: If the reference docs don't cover a topic, say so rather than guessing
4. **Cross-reference with skills**: Combine these references with `.agents/skills/` SKILL.md files for implementation context

## Index

| File | Domain | Used By Agents |
|------|--------|---------------|
| [`asm-models.md`](asm-models.md) | Activated Sludge Models (ASM1-ASM3) | biological-process-engineer |
| [`settling-models.md`](settling-models.md) | Sludge Settling & Clarifier Models | biological-process-engineer |
| [`pump-affinity-laws.md`](pump-affinity-laws.md) | Pump Affinity Laws & Curve Theory | mechanical-process-engineer |
| [`pid-control-theory.md`](pid-control-theory.md) | PID Control for Process Applications | mechanical-process-engineer, node-red-runtime |
| [`signal-processing-sensors.md`](signal-processing-sensors.md) | Sensor Signal Conditioning | instrumentation-measurement |
| [`wastewater-compliance-nl.md`](wastewater-compliance-nl.md) | Dutch Wastewater Regulations | commissioning-compliance, biological-process-engineer |
| [`influxdb-schema-design.md`](influxdb-schema-design.md) | InfluxDB Time-Series Best Practices | telemetry-database |
| [`ot-security-iec62443.md`](ot-security-iec62443.md) | OT Security Standards | ot-security-integration |

## Sources Directory

The `sources/` subdirectory is for placing actual PDFs of scientific papers, standards, and technical manuals. Agents should prefer these curated summaries but can reference originals when available.

## Validation Status

All reference documents have been validated against authoritative sources including:
- IWA Scientific and Technical Reports (ASM models)
- Peer-reviewed publications (Takacs 1991, Vesilind, Burger-Diehl)
- Engineering Toolbox (pump affinity laws)
- ISA publications (Astrom & Hagglund PID control)
- IEC standards (61298, 62443)
- EU Directive 91/271/EEC (wastewater compliance)
- InfluxDB official documentation (schema design)