PX4-Autopilot/.github/instructions/control.instructions.md
Ramon Roche b142342c3a
ci(claude): add review-pr skill for domain-aware PR reviews (#26814)
* ci(claude): add review-pr skill for domain-aware PR reviews

Add a Claude Code skill that reviews pull requests with checks
tailored to the domains touched (estimation, control, drivers,
simulation, system, CI/build, messages, board additions).

Built from analysis of 800+ PR reviews across 8 PX4 maintainers.
Includes merge strategy recommendation, interactive dialog for
submitting reviews, and human-sounding PR comment formatting.

Signed-off-by: Ramon Roche <mrpollo@gmail.com>

* ci(copilot): add domain-scoped review instructions for GitHub Copilot

Add .github/instructions/ files that give GitHub Copilot PR reviews
the same domain-aware context as the Claude Code review-pr skill.

Each file is scoped via applyTo to the relevant source paths:
core review, estimation, control, drivers/CAN, simulation, system,
CI/build, messages/protocol, and board additions.

Signed-off-by: Ramon Roche <mrpollo@gmail.com>

* fix(claude): address Copilot review feedback

- Fix step reference in review-pr skill (step 8 -> step 9)
- Capitalize CMake consistently in skill and Copilot instructions

Signed-off-by: Ramon Roche <mrpollo@gmail.com>

---------

Signed-off-by: Ramon Roche <mrpollo@gmail.com>
2026-04-01 17:56:23 -07:00

928 B

applyTo
applyTo
src/modules/mc_*control*/**,src/modules/fw_*control*/**,src/modules/flight_mode_manager/**,src/lib/rate_control/**,src/lib/npfg/**,src/modules/vtol_att_control/**

Control Review Guidelines

In addition to the core code review guidelines:

  • Phase margin: output filters consume margin for no benefit; prefer adjusting gyro/d-gyro cutoffs
  • Check for circular dependencies: sensor data feeding back into its own control loop (e.g., throttle-based airspeed in TECS)
  • NaN propagation in flight-critical math; check PX4_ISFINITE before magnitude checks
  • Prefer proper setpoint smoothing over controller output filtering (setpoint generation vs output-stage hacks)
  • Check yaw control edge cases: heading lock, drift, setpoint propagation
  • Verify flight task inheritance chain uses the correct base class for desired behavior
  • Control allocation: verify actuator function ordering and motor index mapping