docs: retire repo-mem MCP, migrate skills to .claude/skills, audit fixes
- Delete .mcp.json + .claude/rules/repo-mem.md; drop .repo-mem from .gitignore - Remove repo-mem / substrate_score / repo_search references from all .md - Move 15 EVOLV skills from .agents/skills/ to .claude/skills/ so they are auto-discovered by the Claude Code harness and invokable via the Skill tool - Retire .agents/skills/evolv-orchestrator (duplicate of the subagent at .claude/agents/evolv-orchestrator.md); orchestrator lives as a subagent only - Drop OpenAI-format agent yaml metadata from each skill (not needed for CC) - Update CLAUDE.md, CONTRACTS.md, AGENTS.md to point at the new locations and disambiguate skills (.claude/skills/) vs subagents (.claude/agents/) - Fix CLAUDE.md tick-loop wording (opt-in per-node, not a fixed 1000ms) - Widen .claude/rules/ paths frontmatter so node-architecture and telemetry rules trigger on more relevant files; add frontmatter to flow-layout rule - Bump CONTRACTS.md review date to 2026-05-19; add step 7 to the contract- change workflow (review example flows when topic usage changes) - Bump nodes/generalFunctions pin (Home.md substrate_score reference removed) Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
This commit is contained in:
znetsixe
@@ -41,8 +41,8 @@ You are a biological process engineer specializing in wastewater treatment model
|
||||
- `.agents/function-anchors/monster/`
|
||||
|
||||
## Reference Skills
|
||||
- `.agents/skills/evolv-biological-process-engineering/SKILL.md`
|
||||
- `.agents/skills/evolv-process-hydraulics-mass-balance/SKILL.md`
|
||||
- `.claude/skills/evolv-biological-process-engineering/SKILL.md`
|
||||
- `.claude/skills/evolv-process-hydraulics-mass-balance/SKILL.md`
|
||||
|
||||
## Validation Checklist
|
||||
- [ ] Kinetic rates have correct temperature compensation
|
||||
@@ -53,4 +53,4 @@ You are a biological process engineer specializing in wastewater treatment model
|
||||
- [ ] Retention times consistent with reactor geometry and flow
|
||||
|
||||
## Reasoning Difficulty: Very High
|
||||
This agent handles ASM kinetics, mass balance calculations, temperature compensation, and sludge settling models — some of the most complex scientific reasoning in the platform. Incorrect stoichiometric coefficients, missed temperature corrections, or flawed mass balance closures can propagate silently through reactor simulations. When uncertain, consult `third_party/docs/asm-models.md`, `third_party/docs/settling-models.md`, and `.agents/skills/evolv-biological-process-engineering/SKILL.md` before making claims about biological process behavior.
|
||||
This agent handles ASM kinetics, mass balance calculations, temperature compensation, and sludge settling models — some of the most complex scientific reasoning in the platform. Incorrect stoichiometric coefficients, missed temperature corrections, or flawed mass balance closures can propagate silently through reactor simulations. When uncertain, consult `third_party/docs/asm-models.md`, `third_party/docs/settling-models.md`, and `.claude/skills/evolv-biological-process-engineering/SKILL.md` before making claims about biological process behavior.
|
||||
|
||||
@@ -43,9 +43,9 @@ You are a commissioning and compliance specialist for the EVOLV wastewater treat
|
||||
- Mode changes (auto→manual, simulation→physical) are compliance-relevant events
|
||||
|
||||
## Reference Skills
|
||||
- `.agents/skills/evolv-commissioning-validation/SKILL.md`
|
||||
- `.agents/skills/evolv-regulatory-compliance-wastewater/SKILL.md`
|
||||
- `.agents/skills/evolv-alarms-interlocks-permissives/SKILL.md`
|
||||
- `.claude/skills/evolv-commissioning-validation/SKILL.md`
|
||||
- `.claude/skills/evolv-regulatory-compliance-wastewater/SKILL.md`
|
||||
- `.claude/skills/evolv-alarms-interlocks-permissives/SKILL.md`
|
||||
|
||||
## Validation Checklist
|
||||
- [ ] Compliance-relevant output fields unchanged (or migration documented)
|
||||
@@ -56,4 +56,4 @@ You are a commissioning and compliance specialist for the EVOLV wastewater treat
|
||||
- [ ] Control-action traceability maintained through the change
|
||||
|
||||
## Reasoning Difficulty: High
|
||||
This agent handles regulatory compliance context, audit trail requirements, and simulation-to-field validation gaps. Dutch wastewater regulations (Waterschapswet, EU UWWTD) have specific monitoring and reporting obligations that code changes can inadvertently violate. When uncertain, consult `third_party/docs/wastewater-compliance-nl.md` and `.agents/skills/evolv-commissioning-validation/SKILL.md` before making claims about compliance requirements.
|
||||
This agent handles regulatory compliance context, audit trail requirements, and simulation-to-field validation gaps. Dutch wastewater regulations (Waterschapswet, EU UWWTD) have specific monitoring and reporting obligations that code changes can inadvertently violate. When uncertain, consult `third_party/docs/wastewater-compliance-nl.md` and `.claude/skills/evolv-commissioning-validation/SKILL.md` before making claims about compliance requirements.
|
||||
|
||||
@@ -29,7 +29,7 @@ You are the EVOLV orchestrator agent. You decompose complex tasks, route to spec
|
||||
- Canonical internal units: Pa, m³/s, W, K
|
||||
|
||||
## Workflow
|
||||
1. Read `.agents/skills/evolv-orchestrator/SKILL.md` for full orchestration protocol
|
||||
1. Read `.claude/skills/evolv-orchestrator/SKILL.md` for full orchestration protocol
|
||||
2. Build an impact map: which nodes, contracts, and shared modules are affected?
|
||||
3. Identify the minimum set of specialist agents needed
|
||||
4. Decompose into sequenced subtasks with clear acceptance criteria
|
||||
@@ -44,7 +44,7 @@ You are the EVOLV orchestrator agent. You decompose complex tasks, route to spec
|
||||
- `CONTRACTS.md` (EVOLV root) — front-door map: where every contract, rule, and standard lives
|
||||
- `.claude/refactor/CONTRACTS.md` — platform API shapes (BaseDomain, BaseNodeAdapter, commands registry, …)
|
||||
- `.claude/refactor/OPEN_QUESTIONS.md` — live decisions log
|
||||
- `.agents/skills/evolv-orchestrator/SKILL.md` — Full orchestration protocol
|
||||
- `.claude/skills/evolv-orchestrator/SKILL.md` — Full orchestration protocol
|
||||
- `.agents/AGENTS.md` — Agent invocation policy and routing table
|
||||
- `.agents/improvements/IMPROVEMENTS_BACKLOG.md` — Deferred improvements
|
||||
|
||||
@@ -55,4 +55,4 @@ You are the EVOLV orchestrator agent. You decompose complex tasks, route to spec
|
||||
- Owner-approved defaults: compatibility=controlled, safety=availability-first
|
||||
|
||||
## Reasoning Difficulty: Medium-High
|
||||
This agent handles multi-domain task decomposition, cross-cutting impact analysis, and decision governance enforcement. The primary challenge is correctly mapping changes across node boundaries — a single modification can cascade through parent-child relationships, shared contracts, and InfluxDB semantics. When uncertain about cross-domain impact, consult `.agents/skills/evolv-orchestrator/SKILL.md` and `.agents/AGENTS.md` before routing to specialist agents.
|
||||
This agent handles multi-domain task decomposition, cross-cutting impact analysis, and decision governance enforcement. The primary challenge is correctly mapping changes across node boundaries — a single modification can cascade through parent-child relationships, shared contracts, and InfluxDB semantics. When uncertain about cross-domain impact, consult `.claude/skills/evolv-orchestrator/SKILL.md` and `.agents/AGENTS.md` before routing to specialist agents.
|
||||
|
||||
@@ -45,7 +45,7 @@ dashboardAPI, diffuser, machineGroupControl, measurement, monster, pumpingStatio
|
||||
- `nodes/generalFunctions/src/*/` — Individual module directories
|
||||
|
||||
## Reference Skills
|
||||
- All `.agents/skills/` depending on which module is being changed:
|
||||
- All `.claude/skills/` depending on which module is being changed:
|
||||
- predict/interpolation/loadCurve → `evolv-mechanical-rotating-equipment`
|
||||
- MeasurementContainer/nrmse/convert → `evolv-instrumentation-assets`
|
||||
- outputUtils → `evolv-database-influx-architecture`
|
||||
@@ -59,4 +59,4 @@ dashboardAPI, diffuser, machineGroupControl, measurement, monster, pumpingStatio
|
||||
- Prefer additive changes (new exports) over breaking changes (renamed/removed exports)
|
||||
|
||||
## Reasoning Difficulty: Medium-High
|
||||
This agent manages a shared library consumed by all 13 nodes. Individual module changes are often straightforward, but the cross-node impact analysis is challenging — a subtle behavior change in interpolation or predict can cascade through rotatingMachine, pumpingStation, and machineGroupControl simultaneously. When uncertain about impact scope, grep for imports across `nodes/*/src/` and consult the relevant `.agents/skills/` for the module being changed.
|
||||
This agent manages a shared library consumed by all 13 nodes. Individual module changes are often straightforward, but the cross-node impact analysis is challenging — a subtle behavior change in interpolation or predict can cascade through rotatingMachine, pumpingStation, and machineGroupControl simultaneously. When uncertain about impact scope, grep for imports across `nodes/*/src/` and consult the relevant `.claude/skills/` for the module being changed.
|
||||
|
||||
@@ -43,8 +43,8 @@ You are an instrumentation engineer specializing in sensor measurement, signal c
|
||||
- `.agents/function-anchors/measurement/`
|
||||
|
||||
## Reference Skills
|
||||
- `.agents/skills/evolv-instrumentation-assets/SKILL.md`
|
||||
- `.agents/skills/evolv-measurement-product-specialist/SKILL.md`
|
||||
- `.claude/skills/evolv-instrumentation-assets/SKILL.md`
|
||||
- `.claude/skills/evolv-measurement-product-specialist/SKILL.md`
|
||||
|
||||
## Validation Checklist
|
||||
- [ ] Unit conversions chain correctly (no double-conversion)
|
||||
@@ -55,4 +55,4 @@ You are an instrumentation engineer specializing in sensor measurement, signal c
|
||||
- [ ] MeasurementContainer fields populated consistently
|
||||
|
||||
## Reasoning Difficulty: High
|
||||
This agent handles signal processing, NRMSE-based drift detection, sensor behavior modeling, and data quality propagation. Incorrect filter parameters or threshold settings can mask real sensor drift or generate false alarms. When uncertain, consult `third_party/docs/signal-processing-sensors.md` and `.agents/skills/evolv-instrumentation-assets/SKILL.md` before making claims about sensor behavior or signal conditioning parameters.
|
||||
This agent handles signal processing, NRMSE-based drift detection, sensor behavior modeling, and data quality propagation. Incorrect filter parameters or threshold settings can mask real sensor drift or generate false alarms. When uncertain, consult `third_party/docs/signal-processing-sensors.md` and `.claude/skills/evolv-instrumentation-assets/SKILL.md` before making claims about sensor behavior or signal conditioning parameters.
|
||||
|
||||
@@ -50,9 +50,9 @@ You are a mechanical and process engineer specializing in rotating equipment, hy
|
||||
- `.agents/function-anchors/valve/`
|
||||
|
||||
## Reference Skills
|
||||
- `.agents/skills/evolv-mechanical-rotating-equipment/SKILL.md`
|
||||
- `.agents/skills/evolv-process-hydraulics-mass-balance/SKILL.md`
|
||||
- `.agents/skills/evolv-alarms-interlocks-permissives/SKILL.md`
|
||||
- `.claude/skills/evolv-mechanical-rotating-equipment/SKILL.md`
|
||||
- `.claude/skills/evolv-process-hydraulics-mass-balance/SKILL.md`
|
||||
- `.claude/skills/evolv-alarms-interlocks-permissives/SKILL.md`
|
||||
|
||||
## Validation Checklist
|
||||
- [ ] Unit conversions use canonical system (Pa, m³/s, W, K internally)
|
||||
@@ -63,4 +63,4 @@ You are a mechanical and process engineer specializing in rotating equipment, hy
|
||||
- [ ] System curve intersection validated for duty point calculations
|
||||
|
||||
## Reasoning Difficulty: High
|
||||
This agent handles physics validation involving affinity laws, pump curve theory, system curve intersections, and unit system rigor. Errors in hydraulic calculations or VFD scaling can produce physically impossible results that look numerically plausible. When uncertain, consult `third_party/docs/pump-affinity-laws.md`, `third_party/docs/pid-control-theory.md`, and `.agents/skills/evolv-mechanical-rotating-equipment/SKILL.md` before making claims about mechanical behavior.
|
||||
This agent handles physics validation involving affinity laws, pump curve theory, system curve intersections, and unit system rigor. Errors in hydraulic calculations or VFD scaling can produce physically impossible results that look numerically plausible. When uncertain, consult `third_party/docs/pump-affinity-laws.md`, `third_party/docs/pid-control-theory.md`, and `.claude/skills/evolv-mechanical-rotating-equipment/SKILL.md` before making claims about mechanical behavior.
|
||||
|
||||
@@ -38,8 +38,8 @@ You are a Node-RED runtime and editor specialist for the EVOLV platform. You und
|
||||
- `nodes/generalFunctions/` — Shared utilities (MenuManager, configManager, logger, etc.)
|
||||
|
||||
## Reference Skills
|
||||
- `.agents/skills/evolv-frontend-node-red/SKILL.md` — Detailed Node-RED frontend patterns
|
||||
- `.agents/skills/evolv-process-systems-control/SKILL.md` — Control architecture and topic contracts
|
||||
- `.claude/skills/evolv-frontend-node-red/SKILL.md` — Detailed Node-RED frontend patterns
|
||||
- `.claude/skills/evolv-process-systems-control/SKILL.md` — Control architecture and topic contracts
|
||||
|
||||
## Rules
|
||||
- Never put `RED.*` calls in specificClass — that's nodeClass territory
|
||||
@@ -48,4 +48,4 @@ You are a Node-RED runtime and editor specialist for the EVOLV platform. You und
|
||||
- Always check `generalFunctions` MenuManager/configManager when modifying config flows
|
||||
|
||||
## Reasoning Difficulty: Medium
|
||||
Node-RED patterns are well-documented with clear conventions. The main risk is editor/runtime synchronization — changes to admin endpoints, HTML forms, or registration patterns can silently break the editor without runtime errors. When uncertain, consult `.agents/skills/evolv-frontend-node-red/SKILL.md` and the Node-RED documentation before making structural changes.
|
||||
Node-RED patterns are well-documented with clear conventions. The main risk is editor/runtime synchronization — changes to admin endpoints, HTML forms, or registration patterns can silently break the editor without runtime errors. When uncertain, consult `.claude/skills/evolv-frontend-node-red/SKILL.md` and the Node-RED documentation before making structural changes.
|
||||
|
||||
@@ -35,8 +35,8 @@ You are an OT/IT security and edge integration specialist for the EVOLV industri
|
||||
- Watchdog timers for connection health monitoring
|
||||
|
||||
## Reference Skills
|
||||
- `.agents/skills/evolv-ot-it-security/SKILL.md`
|
||||
- `.agents/skills/evolv-ot-edge-plc-integration/SKILL.md`
|
||||
- `.claude/skills/evolv-ot-it-security/SKILL.md`
|
||||
- `.claude/skills/evolv-ot-edge-plc-integration/SKILL.md`
|
||||
|
||||
## Scope
|
||||
- Admin endpoints (`GET /<nodeName>/menu.js`, `GET /<nodeName>/configData.js`)
|
||||
@@ -55,4 +55,4 @@ You are an OT/IT security and edge integration specialist for the EVOLV industri
|
||||
- [ ] Control messages validated before actuator commands are issued
|
||||
|
||||
## Reasoning Difficulty: High
|
||||
This agent handles industrial threat modeling, OT protocol security, and fail-safe analysis. Security in industrial systems has physical safety implications — a missed input validation on a control message could lead to unsafe actuator commands. When uncertain, consult `third_party/docs/ot-security-iec62443.md` and `.agents/skills/evolv-ot-it-security/SKILL.md` before making claims about security boundaries or protocol safety.
|
||||
This agent handles industrial threat modeling, OT protocol security, and fail-safe analysis. Security in industrial systems has physical safety implications — a missed input validation on a control message could lead to unsafe actuator commands. When uncertain, consult `third_party/docs/ot-security-iec62443.md` and `.claude/skills/evolv-ot-it-security/SKILL.md` before making claims about security boundaries or protocol safety.
|
||||
|
||||
@@ -49,8 +49,8 @@ node --test nodes/<nodeName>/test/edge/*.test.js
|
||||
- `nodes/*/examples/` — Example flows
|
||||
|
||||
## Reference Skills
|
||||
- `.agents/skills/evolv-quality-technical-debt/SKILL.md`
|
||||
- `.agents/skills/evolv-commissioning-validation/SKILL.md`
|
||||
- `.claude/skills/evolv-quality-technical-debt/SKILL.md`
|
||||
- `.claude/skills/evolv-commissioning-validation/SKILL.md`
|
||||
|
||||
## Validation Checklist
|
||||
- [ ] All 3 test tiers present (basic/integration/edge)
|
||||
@@ -62,4 +62,4 @@ node --test nodes/<nodeName>/test/edge/*.test.js
|
||||
- [ ] Code complexity reasonable (no god functions, clear naming)
|
||||
|
||||
## Reasoning Difficulty: Medium
|
||||
Test patterns are straightforward and the 3-tier structure provides clear guidance. The harder challenge is cross-node regression detection — a change in generalFunctions can silently break downstream nodes whose tests still pass in isolation. When uncertain, consult `.agents/skills/evolv-quality-technical-debt/SKILL.md` and `.agents/function-anchors/` for behavioral contracts before writing or modifying tests.
|
||||
Test patterns are straightforward and the 3-tier structure provides clear guidance. The harder challenge is cross-node regression detection — a change in generalFunctions can silently break downstream nodes whose tests still pass in isolation. When uncertain, consult `.claude/skills/evolv-quality-technical-debt/SKILL.md` and `.agents/function-anchors/` for behavioral contracts before writing or modifying tests.
|
||||
|
||||
@@ -45,8 +45,8 @@ You are a telemetry and database specialist for the EVOLV platform, focusing on
|
||||
- `.agents/function-anchors/dashboardAPI/`
|
||||
|
||||
## Reference Skills
|
||||
- `.agents/skills/evolv-database-influx-architecture/SKILL.md`
|
||||
- `.agents/skills/evolv-telemetry-analytics-dashboards/SKILL.md`
|
||||
- `.claude/skills/evolv-database-influx-architecture/SKILL.md`
|
||||
- `.claude/skills/evolv-telemetry-analytics-dashboards/SKILL.md`
|
||||
|
||||
## Validation Checklist
|
||||
- [ ] Tags are low-cardinality only (no timestamps, UUIDs, free-text)
|
||||
@@ -57,4 +57,4 @@ You are a telemetry and database specialist for the EVOLV platform, focusing on
|
||||
- [ ] Retention policy matches data criticality and storage constraints
|
||||
|
||||
## Reasoning Difficulty: Medium
|
||||
InfluxDB schema design is well-understood, and the Port 1 telemetry contract is consistent across nodes. The main risk area is cardinality management — adding a high-cardinality tag can silently degrade query performance until it becomes critical. When uncertain, consult `third_party/docs/influxdb-schema-design.md` and `.agents/skills/evolv-database-influx-architecture/SKILL.md` before making schema changes.
|
||||
InfluxDB schema design is well-understood, and the Port 1 telemetry contract is consistent across nodes. The main risk area is cardinality management — adding a high-cardinality tag can silently degrade query performance until it becomes critical. When uncertain, consult `third_party/docs/influxdb-schema-design.md` and `.claude/skills/evolv-database-influx-architecture/SKILL.md` before making schema changes.
|
||||
|
||||
Reference in New Issue
Block a user