AwesomeStudioPedal

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

Reopen a closed task — updates status to open, moves from closed/ to open/, runs housekeep

Use BEFORE invoking /ts-task-new whenever the new task touches the nRF52840 hardware target — any change under src/nrf52840/, any new test under test/test_*_nrf52840/, any nRF52840 PlatformIO env or build target, any AC requiring on-device verification on the Adafruit Feather nRF52840 (BLE via Bluefruit, GPIO, ISRs), or any Test Plan / AC item proposing new nRF52840 on-device tests (even as "nice-to-have"). Routes nRF5-primary tasks to EPIC-025 (nrf52840-blocked); for ESP32-primary tasks with stray nRF52840 test-plan items, scrubs the items instead. Active until the device is available again — removed by TASK-359 at that point.

Squash a feature/refactoring branch, merge it into main, update CHANGELOG, and cut a release

Bump version, archive tasks, update CHANGELOG, tag, and push — release.yml then builds firmware + APK and publishes the GitHub Release

Drive the Flutter app on a connected Android device end-to-end via adb to verify a feature-test or defect-fix scenario without human intervention. Replaces "tap through it on Pixel 9" steps in TASK-156-style feature tests and defect ACs.

Recover from flaky BLE pairing with the pedal — disconnect, remove the bond, scan, pair, connect, verify. Reads the pedal MAC from $ASP_PEDAL_MAC. Use this any time you would hand-roll `bluetoothctl disconnect/remove/pair` retries on the pedal.

Guard against committing directly to main — verifies the current branch and warns or stops if on main

After creating or moving any `.md` file under `docs/` (excluding `docs/developers/tasks/` and `docs/developers/ideas/`), invoke this skill to validate persona placement (builder / musician / developer). On a Mismatch verdict, the skill proposes a `git mv` and waits for user confirmation before running it.

Run scripts/housekeep.py --apply and stage the regenerated task-system index files (OVERVIEW.md, EPICS.md, KANBAN.md, ideas OVERVIEW). Use this after any task-system file change instead of running the script directly.

Run the routine git reconnaissance bundle in a single Bash call — current branch, last 3 commits, staged short, working short. Use this instead of separate `git branch --show-current` / `git log` / `git status --short` calls.

Drive the Android UI on a connected device — dump the UI tree, optionally find a node by text and report its bounds, and optionally tap it. Replaces the hand-rolled `sleep 1 && adb shell uiautomator dump … pull … python3 ui_find.py` loop. Use this any time you would type `adb shell uiautomator dump` to drive the Pixel app, exploratory or otherwise.

Show all open and active tasks from docs/developers/tasks/OVERVIEW.md (paused hidden by default; --paused or --all to include)

List all epics with derived status, assigned owner, and task counts

Move an idea from docs/developers/ideas/open/ to archived/ and commit

Show all open ideas from docs/developers/ideas/open/

Show all open and active tasks from docs/developers/tasks/OVERVIEW.md (paused hidden by default; --paused or --all to include)

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

Summarize recent GitHub Actions run statuses per workflow

Run clang-tidy on C++ files changed relative to main and report violations

Keep devcontainer.json in sync when software is installed, removed, or configured inside the dev container

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

Auto-format all C++ files with clang-format and report what changed

Run all local linters — markdown, code smells, and Mermaid diagrams

Detect the current OS and print shell syntax reminders for Windows vs Ubuntu

Run on-device (hardware) tests via PlatformIO and report results. Requires a physical device connected via USB.

Run host unit tests via make test-host and report results

Auto-update scripts/README.md when scripts are added, changed, or removed