Skip to content

wandelbotsgmbh/wandelbots-nova / nova/agent_skills/nova-app-review

nova-app-review

Verified

Review a robot cell application built on the Wandelbots NOVA Python SDK (wandelbots-nova) for safety, motion, PLC/IO, async runtime, performance, lifecycle, device handling and NOVA SDK usage, and report findings with severity, evidence and concrete fixes. Use when the user asks to review, audit, check, lint or harden a NOVA app, a @nova.program, a NOVAx app or any robot application; asks about best practices, common pitfalls, cycle time, safety or commissioning readiness; or asks 'is my robot code OK?'.

references/rules/configuration.md

View on GitHub
# Configuration (CFG)

## CFG-001 · One source of truth for cell configuration
`severity: warning` · `scope: robotics` · `detect: static`

**Rule.** Controller name, motion group, TCPs, speed profiles, device endpoints, station definitions
and part vocabularies live in one configuration module or file. Jobs import from it.

NOVA: connection settings come from `NOVA_API`, `NOVA_ACCESS_TOKEN` and `CELL_NAME`
(`nova.config`); do not re-read them in job code.

---

## CFG-002 · Typed, validated, logged configuration
`severity: info` · `scope: general` · `detect: static`

**Rule.** Environment variables are parsed once into typed values with defaults and range
validation. The effective configuration is logged at startup, with secrets redacted (never log
`NOVA_ACCESS_TOKEN`). Unknown/invalid values fail fast.

**Detect.** `os.environ[` / `os.getenv(` / `decouple.config(` outside the config module.

---

## CFG-003 · Independent simulation flags per subsystem
`severity: info` · `scope: robotics` · `detect: static`

**Rule.** Separate flags for virtual robot, virtual PLC and each virtual device enable
hardware-in-the-loop setups (real robot with simulated PLC, and the reverse).

---

## CFG-004 · Safety-relevant config must not freeze silently at import
`severity: info` · `scope: python-async` · `detect: review`

**Rule.** Values like the reduced-speed divider are computed when the module is imported. Make that
explicit (log the value). If they must be switchable at runtime, compute profiles lazily.
rea-analysis-optimizationmorluto/reaOptimize REA providers and shared analysis workflows for agent context, latency, CPU, and memory while preserving correctness and Evidence. Use for analysis bottlenecks and cache or query design; CI/test-suite optimization belongs to rea-ci-tests-audit.Stars: 472kUpdated Claude CodeCodexVerifiedInstall
rea-ci-tests-auditmorluto/reaAudit REA CI and test suites for correctness, fixture drift, false passes, and measured performance; use for suite or workflow investigations and efficiency changes, rather than ordinary feature testing or a single test failure.Stars: 472kUpdated Claude CodeCodexVerifiedInstall
rea-tool-designmorluto/reaAudit, investigate, design, or change REA investigation tools, CLI/MCP contracts, provider capabilities, and Evidence semantics.Stars: 472kUpdated Claude CodeCodexVerifiedInstall
ponytail-auditDietrichGebert/ponytailQuality audit of the whole repo: bugs, security, real load, missing tests, speed, and what to delete. Most important first.Stars: 194kUpdated Claude CodeCodexVerifiedInstall