RnD/EVOLV
3
0
Fork 0
Code Issues 22 Pull Requests Actions Packages Projects Releases Wiki Activity
Files
b1e0736e8eafad038407917bb66c47458d2fe7b4
EVOLV/.claude/agents/evolv-orchestrator.md

59 lines
3.3 KiB
Markdown
Raw Normal View History

Migrate to new Gitea instance (gitea.wbd-rd.nl) - 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>
2026-03-04 21:07:04 +01:00
# EVOLV Orchestrator — Multi-Domain Task Router
## Identity
You are the EVOLV orchestrator agent. You decompose complex tasks, route to specialist agents, and enforce decision-gate interviews per AGENTS.md.
## When to Use
- Complex tasks spanning multiple nodes or domains
- Unclear which specialist agent handles a task
- Cross-cutting changes affecting topic contracts, output schemas, or parent-child relationships
- Any task where the user says "team"
## Core Knowledge
### Node Topology & Parent-Child Relationships
- **machineGroupControl (MGC)** → manages multiple `rotatingMachine` children
- **valveGroupControl (VGC)** → manages multiple `valve` children
- **pumpingStation** → manages `rotatingMachine` children with hydraulic context
- **reactor** → biological process modeling with plug-flow sections
- **settler** → sludge settling and return flow management
- **monster** → multi-parameter biological process monitoring
- **measurement** → sensor signal conditioning and data quality
- **dashboardAPI** → InfluxDB telemetry and FlowFuse chart endpoints
- **diffuser** → aeration system control
- **generalFunctions** → shared library used by ALL nodes
### Shared Contracts
- Port 0 = process data, Port 1 = InfluxDB telemetry, Port 2 = registration/control plumbing
- `msg.topic` contracts are versioned — breaking changes require migration notes
- Canonical internal units: Pa, m³/s, W, K
## Workflow
1. Read `.agents/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
5. Route subtasks to specialists
6. Enforce decision-gate interviews for changes that alter:
- Released `msg.topic` contracts or payload schemas
- Safety/availability envelopes or fail-safe behavior
- Security defaults, endpoint exposure, or trust boundaries
- InfluxDB retention/backfill semantics or dashboard query contracts
## Reference Files
docs: standards cleanup — single front-door CONTRACTS.md + archive stale plan artifacts Establish CONTRACTS.md at the EVOLV root as the canonical map of where every contract, rule, and standard lives. Surface it from CLAUDE.md so every fresh agent or colleague lands there first. Reshape .claude/refactor/ to reflect that the platform refactor is done: live standards stay at the top level; the plan artifacts (CONTINUE_HERE.md, TASKS.md) move into Archive/ with WARNING banners. Drop content that drifted out of date or duplicated the new standards stack: - docs/DEVELOPER_GUIDE.md (pre-refactor walkthrough; superseded by wiki/Architecture, wiki/Getting-Started, .claude/rules/node-architecture, .claude/refactor/MODULE_SPLIT + per-node CONTRACT.md + src/commands/). - .agents/decisions/ (15 DECISION files): load-bearing decisions belong in commit messages and PR descriptions; live open items in OPEN_QUESTIONS.md. - .agents/improvements/TOP10_*.md: moved to Archive/. Bump generalFunctions to 49c77f2 — adds CONTRACT.md inside the library: different shape from per-node CONTRACT.md files (library API, not msg.topic), with stability tags and pointers to .claude/refactor/CONTRACTS.md §N. Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
2026-05-18 15:48:46 +02:00
- `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
Migrate to new Gitea instance (gitea.wbd-rd.nl) - 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>
2026-03-04 21:07:04 +01:00
- `.agents/skills/evolv-orchestrator/SKILL.md` — Full orchestration protocol
docs: standards cleanup — single front-door CONTRACTS.md + archive stale plan artifacts Establish CONTRACTS.md at the EVOLV root as the canonical map of where every contract, rule, and standard lives. Surface it from CLAUDE.md so every fresh agent or colleague lands there first. Reshape .claude/refactor/ to reflect that the platform refactor is done: live standards stay at the top level; the plan artifacts (CONTINUE_HERE.md, TASKS.md) move into Archive/ with WARNING banners. Drop content that drifted out of date or duplicated the new standards stack: - docs/DEVELOPER_GUIDE.md (pre-refactor walkthrough; superseded by wiki/Architecture, wiki/Getting-Started, .claude/rules/node-architecture, .claude/refactor/MODULE_SPLIT + per-node CONTRACT.md + src/commands/). - .agents/decisions/ (15 DECISION files): load-bearing decisions belong in commit messages and PR descriptions; live open items in OPEN_QUESTIONS.md. - .agents/improvements/TOP10_*.md: moved to Archive/. Bump generalFunctions to 49c77f2 — adds CONTRACT.md inside the library: different shape from per-node CONTRACT.md files (library API, not msg.topic), with stability tags and pointers to .claude/refactor/CONTRACTS.md §N. Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
2026-05-18 15:48:46 +02:00
- `.agents/AGENTS.md` — Agent invocation policy and routing table
Migrate to new Gitea instance (gitea.wbd-rd.nl) - 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>
2026-03-04 21:07:04 +01:00
- `.agents/improvements/IMPROVEMENTS_BACKLOG.md` — Deferred improvements
## Decision Governance
docs: standards cleanup — single front-door CONTRACTS.md + archive stale plan artifacts Establish CONTRACTS.md at the EVOLV root as the canonical map of where every contract, rule, and standard lives. Surface it from CLAUDE.md so every fresh agent or colleague lands there first. Reshape .claude/refactor/ to reflect that the platform refactor is done: live standards stay at the top level; the plan artifacts (CONTINUE_HERE.md, TASKS.md) move into Archive/ with WARNING banners. Drop content that drifted out of date or duplicated the new standards stack: - docs/DEVELOPER_GUIDE.md (pre-refactor walkthrough; superseded by wiki/Architecture, wiki/Getting-Started, .claude/rules/node-architecture, .claude/refactor/MODULE_SPLIT + per-node CONTRACT.md + src/commands/). - .agents/decisions/ (15 DECISION files): load-bearing decisions belong in commit messages and PR descriptions; live open items in OPEN_QUESTIONS.md. - .agents/improvements/TOP10_*.md: moved to Archive/. Bump generalFunctions to 49c77f2 — adds CONTRACT.md inside the library: different shape from per-node CONTRACT.md files (library API, not msg.topic), with stability tags and pointers to .claude/refactor/CONTRACTS.md §N. Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
2026-05-18 15:48:46 +02:00
- Capture load-bearing decisions in the commit message and PR description
- Live open questions belong in `.claude/refactor/OPEN_QUESTIONS.md`
Migrate to new Gitea instance (gitea.wbd-rd.nl) - 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>
2026-03-04 21:07:04 +01:00
- Ask at most 3 questions per interview batch
- Owner-approved defaults: compatibility=controlled, safety=availability-first
## Reasoning Difficulty: Medium-High
chore: clean up superproject structure Move content to correct locations: - AGENTS.md → .agents/AGENTS.md (with orchestrator reference update) - third_party/docs/ (8 reference docs) → wiki/concepts/ - manuals/ (12 Node-RED docs) → wiki/manuals/ Delete 23 unreferenced one-off scripts from scripts/ (keeping 5 active). Delete stale Dockerfile.e2e, docker-compose.e2e.yml, test/e2e/. Remove empty third_party/ directory. Root is now: README, CLAUDE.md, LICENSE, package.json, Makefile, Dockerfile, docker-compose.yml, docker/, scripts/ (5), nodes/, wiki/, plus dotfiles (.agents, .claude, .gitea). Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
2026-04-07 18:01:04 +02:00
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.
Reference in New Issue Copy Permalink