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/observability.md

View on GitHub
# Observability (OBS)

## OBS-001 · No `print()` in runtime code
`severity: warning` · `scope: general` · `detect: static`

**Rule.** Use the logging facade. `print` bypasses log files, levels and HMI listeners.

NOVA: `from nova.logging import logger` or the standard `logging` module.

---

## OBS-002 · Structured, tagged log lines
`severity: info` · `scope: general` · `detect: static`

**Rule.** Prefix log lines with domain tags (`[STATE]`, `[JOB]`, `[NOVA]`, `[IO]`, `[FIX_TIP]`,
`[TIMING]`) or emit key=value/JSON. Silence noisy SDK loggers to WARNING; raise them temporarily
during startup diagnostics.

NOVA: the SDK log level follows the `LOG_LEVEL` environment variable.

---

## OBS-003 · Log every state transition with timing
`severity: info` · `scope: robotics` · `detect: review`

**Rule.** Log source, target, trigger and time-in-previous-state for every supervisor transition.

---

## OBS-004 · Measure cycle time by segment, plan vs execute
`severity: info` · `scope: robotics` · `detect: review`

**Rule.** Record per-job and per-segment durations, and split plan time from execute time and from
IO wait time. Without this split you cannot tell whether to optimise motion, planning or
handshakes.

NOVA: `ctx.cycle()` (`nova.events.Cycle`) publishes cycle start/finish events; call `plan` and
`execute` separately to time them.

---

## OBS-005 · Measure fault-detection-to-stop latency
`severity: info` · `scope: robotics` · `detect: review`

**Rule.** Timestamp first fault detection and the completed motion stop. Report the latency on
every fault.
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