hotsheet

SkillDev tools

Read the Hot Sheet worklist and work through the current priority items

Available today. Use it from your connected AI after setup.

Connect ahel once, and every AI you use reads what you have installed.

Then ask your AI: use the hotsheet skill

What this skill tells your AI

The instructions your AI receives, as published by brianwestphal/glassbox in .agents/skills/hotsheet/SKILL.md and read by ahel’s review.

Read .hotsheet/worklist.md and work through the tickets in priority order.

For each ticket:

  1. Read the ticket details carefully
  2. Implement the work described
  3. When complete, mark it done via the Hot Sheet UI

Work through them in order of priority, where reasonable.

If the worklist says "Auto-Prioritize", follow those instructions to choose and mark tickets as Up Next before working on them.

If API calls fail (connection refused or 403), re-read .hotsheet/settings.json for the current port and secret values — you may be connecting to the wrong Hot Sheet instance.

MCP tools (hotsheet_*) are preferred over curl when the channel is connected — see the worklist for per-operation guidance. The 14-tool surface covers ticket lifecycle (hotsheet_update_ticket, hotsheet_create_ticket, hotsheet_get_ticket, hotsheet_delete_ticket, hotsheet_restore_ticket, hotsheet_toggle_up_next, hotsheet_duplicate_tickets), bulk operations (hotsheet_batch), notes (hotsheet_edit_note, hotsheet_delete_note), attachments (hotsheet_add_attachment), channel signaling (hotsheet_signal_done), feedback sugar (hotsheet_request_feedback), and query (hotsheet_query_tickets). Curl stays supported as the universal fallback for non-Claude AI agents and human terminal callers.

Git: keep the target current + integrate ready branches

You run on the target branch (usually main) in the main worktree, so you are the integrator: a self-claim worker (/hotsheet-worker, working in its own git worktree) commits its work on its own branch and marks its ticket pending_integration with the integration_branch it landed on — you merge those into the target (a worker never writes the target itself). When no such workers are in play this section is simply unused.

  • Stay currentgit fetch then git pull --rebase (when the repo has a remote) before integrating; commit or stash your own in-progress changes first so a merge doesn't tangle with them.
  • Integrate ready branches — for each ticket marked pending_integration (its integration_branch names the branch to merge), in ticket-priority order, git merge that branch into the target from committed state. Auto-resolve trivial/mechanical conflicts; if a conflict is non-trivial or ambiguous, stop and ask the maintainer rather than force it.
  • Run the gates after each merge — type-check, lint, and the relevant tests — before moving on; if they fail in a way you can't quickly and safely fix, stop and ask.
  • Clear the marker — for each ticket you integrated, hotsheet_update_ticket with { "id": <id>, "pending_integration": false }.
  • NEVER git push without the maintainer's explicit permission — local integration only.

Signals

GitHub stars
34
Forks
1
Last commit
Sep 2026
Advanced
Catalog kind
skill
Gateway key
hotsheet
Source
github.com/brianwestphal/glassbox