Files
PX4-Autopilot/.agents
Ramon Roche 8d446794ca docs(skills): say PRs may be squashed at maintainer discretion (#28871)
The pr and commit skills claimed every PR is squash-merged, which
contradicts CONTRIBUTING.md: merge strategy is case by case, with both
squash and rebase merges enabled. The wrong claim led to fix-up commits
being kept on branches on the assumption they would be squashed away.

Assisted-by: Claude:claude-opus-5-5

Signed-off-by: Ramon Roche <mrpollo@gmail.com>
2026-09-27 16:27:20 -06:00
..

Agent instructions

AGENTS.md files hold repository and directory guidance; .agents/skills/ holds the shared skills. Keep skills client-agnostic: no argument variables or client-specific attribution.

Claude Code reads neither location directly. Each CLAUDE.md is a one-line @AGENTS.md import, and each .claude/skills/<name> is a symlink to .agents/skills/<name>; add both when adding a nested AGENTS.md or a skill.

Skill Use
commit Conventional commit with Assisted-by: trailer
pr Pull request with Summary/Problem/Solution body
review-pr PR review debrief and draft comment
rebase-onto-main Rebase, including onto a squash-merged parent
build-px4-linux Board or SITL build on a Linux host
build-px4-macos Board build on macOS, in the px4-dev container

Create worktrees where the user's own agent instructions put them. Without such a rule, put them next to the repository in ../PX4-Autopilot-worktrees/<name>/, never inside it.