Menu
Run clang-tidy on C++ files changed relative to main and report violations
Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.
Based on SOC occupation classification
Write Bash commands that don't trigger unnecessary permission prompts. Use Read/Edit/Grep instead of head/tail/sed/awk/cat/echo; split chained commands (&&, ;, ||) into separate Bash calls; drop diagnostic suffixes like `; echo "EXIT=$?"`. The allowlist matches whole command strings — every mismatch costs the user attention.
Commit user-named files atomically via scripts/commit-pathspec.sh (which wraps `git commit -m "..." -- <files>` and writes the provenance token the pre-commit hook validates). Applies the CLAUDE.md "Pre-commit hook failures on unrelated changes" protocol when the hook fails. Never adds --no-verify silently — explicit user approval is required.
Scaffold a new epic file in docs/developers/tasks/open/ and run housekeep
Scaffold a new idea file in docs/developers/ideas/open/ and regenerate the ideas OVERVIEW.md
Set a task to active — updates status, moves to active/, runs housekeep. Also resumes paused tasks (paused/ → active/ or active/ with closed prerequisites).
Mark a task as closed — writes effort_actual, moves the file to closed/, runs housekeep, and commits
| name | clang-tidy |
| description | Run clang-tidy on C++ files changed relative to main and report violations |
Run clang-tidy on every C++ file that differs from main and report violations with
file:line context.
Steps:
Check that .vscode/build/compile_commands.json exists. If not, tell the user to run
cmake -B .vscode/build first and stop.
Find changed C++ files:
git diff --name-only main...HEAD -- '*.cpp' '*.h' '*.hpp'
Also include any untracked files in src/, lib/, or include/ that are not in
.pio/, build/, or _deps/.
If no C++ files are changed, report "No C++ files changed relative to main." and stop.
For each file, run:
clang-tidy -p .vscode/build <file>
Collect all output. Report:
If clang-tidy is not installed, report the error and stop. Do not auto-fix — report only.