6a6c04d34b
- Update all submodule URLs from gitea.centraal.wbd-rd.nl to gitea.wbd-rd.nl - Add settler as proper submodule in .gitmodules - Add agent skills, function anchors, decisions, and improvements - Add Docker configuration and scripts - Add manuals and third_party docs - Update .gitignore with secrets and build artifacts - Remove stale .tgz build artifact Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
41 lines
2.5 KiB
Markdown
41 lines
2.5 KiB
Markdown
# 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)
|