Tap the Sign

Auto thermo sign-off on your plan before you build.

After Plan mode drafts a plan, tap-the-sign auto-sends a thermonuclear review follow-up and updates the plan with a Thermonuclear pre-flight section. Post-plan only — no pre-plan injection.

tap-the-sign is a standalone hook add-on. It does not bundle the thermonuclear review rubric — install thermo-nuclear-code-quality-review separately.

What it does

1. You enable the hook and submit a task in Plan mode.
2. When the plan is created (CreatePlan on Cursor, or the plan turn ends), the hook auto-injects this follow-up:

@thermo-nuclear-code-quality-review

Read and apply the full rubric from the thermo-nuclear-code-quality-review skill
(code judo, 1k-line rule, spaghetti growth, HIGH/MID/LOW bar) to **this plan**
(not a diff yet).

Complete Pass 1, Pass 2, and Pass 3 in this single response as three numbered
subsections. Do not spawn subagents in plan mode. Include a **Thermonuclear pre-flight**
section, then stop and wait for the user to approve or click Build.

3. After the plan is updated with the pre-flight section, the hook stops (no further auto follow-ups).

On Cursor, injection prefers postToolUse on CreatePlan (additional_context) so plan-card turns still get thermo even when stop → followup_message does not fire. stop remains the fallback.

A Cursor rule (tap-the-sign.mdc) is installed with tap-the-sign install as a soft guard: do not implement from the first plan draft until Thermonuclear pre-flight is present. It cannot block the Build button — only remind the agent to wait.

If the thermo skill is missing, planning still works; the hook auto-sends a chat follow-up with install instructions (also logged to the Hooks output channel).

Quick start

npx tap-the-sign install && npx tap-the-sign install-thermo && npx tap-the-sign on
npx tap-the-sign doctor

Use Plan mode in Cursor, Claude Code, or Codex.

Install

npx tap-the-sign install              # all IDEs, project-local (default)
npx tap-the-sign install --global     # user-global (~/.cursor, ~/.claude, ~/.codex)
npx tap-the-sign install-thermo       # thermo skill only (recommended)
npx tap-the-sign install --no-codex   # subset of IDEs

From a git clone:

git clone https://github.com/john-prem/tap-the-sign.git
cd tap-the-sign
./install.sh
npx tap-the-sign install-thermo && npx tap-the-sign on

Or one-liner:

curl -fsSL https://raw.githubusercontent.com/john-prem/tap-the-sign/main/install.sh | bash
npx tap-the-sign install-thermo && npx tap-the-sign on

Requires Node.js 18+.

Thermo skill: npx tap-the-sign install-thermo (see below).

Thermo skill

Required for auto follow-up. Install via:

npx tap-the-sign install-thermo
# equivalent:
npx skills add cursor/plugins --skill thermo-nuclear-code-quality-review \
  -a cursor -a claude-code -a codex --copy -y

The auto follow-up invokes @thermo-nuclear-code-quality-review and applies the skill rubric to your plan.

Toggle

| Command | Action | |---------|--------| | npx tap-the-sign on | Enable hook | | npx tap-the-sign off | Disable hook | | npx tap-the-sign status | Show hook + skill status | | npx tap-the-sign doctor | Fail if thermo skill missing | | npx tap-the-sign doctor --fix | Run install-thermo if skill missing | | npx tap-the-sign install-thermo | Install thermo skill via npx skills add |

Cursor slash commands: /tap-the-sign-on, /tap-the-sign-off, /tap-the-sign-status

Requirements

See docs/REQUIREMENTS.md.

• Required for auto follow-up: thermo-nuclear-code-quality-review skill
• Local IDE only — Cursor Cloud Agents do not run stop / beforeSubmitPrompt hooks
• Codex: review and trust hooks in /hooks after install

Plan mode detection

| IDE | Field | |-----|-------| | Cursor | composer_mode === "plan" | | Claude Code | permission_mode === "plan" | | Codex | permission_mode === "plan" |

Uninstall

npx tap-the-sign uninstall

License

MIT — see LICENSE.