tgd1975

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

Scaffold a new task file in docs/developers/tasks/open/ and update OVERVIEW.md

Pause an active task that is blocked — moves it to paused/, sets status: paused, records the blocker as a prerequisite

Verify the project's hard memory + storage budgets — definite-leak-free under valgrind, peak host-heap below the v2 ceiling, ESP32 flash + RAM headroom non-negative, and (informational) RTC-Slow-Memory budget. Use when the user asks to "check budgets", "verify no leaks", "measure peak heap", "is the firmware too big", or as the §9 Heap-Profiling gate before tagging v2.0.0. Do NOT invoke as a side-effect of an unrelated build/test failure — it costs ~5–10 minutes wall-clock.

Convert PGM dumps (from `make test-native`) to PNG using the existing `scripts/pgm-to-png.py` converter — never reach for `convert`/`magick`/`ffmpeg`/PIL one-liners/`for`-loops. The script already handles batch mode (whole `.tmp/v2-pgm/`), single-file mode, and `--bands` for pixel-band Y-ranges. Use whenever the user asks to convert, visualize, render, or "look at" PGM output, or asks for pixel-band/Y-range info.

Check whether a CLI tool or package is available; if not, ask the user to install it before continuing

Run clang-format (auto-fix) across every C/C++ file in the repo and report what was changed; then run cppcheck and surface any remaining static-analysis warnings as a punch list. Mirrors fix-markdown — formatter auto-fixes, linter reports. Use when the user asks to "fix the C++ lint issues", "format the C++ code", or "run the C++ linters". Do NOT invoke as a side-effect to clear an unrelated hook failure.

Cut a new tagged release of bustaferl. Enforces the Tier 2/3 test-gate (host + device + soak), composes release notes from git log, and creates an annotated tag. Use when the user wants to "tag a release", "ship v1.x", "cut a release", or asks to verify pre-tag readiness. Optional `--major` flag adds the 24h test gate. Refuses if tests are stale or rot, blocks force-push to main.

Auto-fix markdown lint issues across all .md files and report what changed

Edit baked-in text labels on the project's PNG illustrations (the stick-figure role cards in Bilder/, diagrams, etc.) while keeping the artwork untouched. Use when asked to rename a figure ("replace Walter with Kerstin"), fix a typo in a label, or change any text rendered into a raster image.

Render a Markdown file in this project to a styled PDF (with embedded images). Use when the user asks to "render/convert/export a .md to PDF", "rebuild/regenerate the PDF", or mentions creating the Berufsvorstellung / Diplom Konzept PDF.