nudge

Nudge

Manage the Claude Code feature-adoption nudge cycle against the Basic Memory note main/reference/claude-code-noteworthy-features. Two modes on the same data (same note, same cache, same contract):

• Bare /nudge (or no argument) → Mode A (sync). Re-read the note, filter out adopted/declined features, and regenerate the tip cache.
• /nudge check → Mode B (adoption check). Scan transcripts for real feature-use evidence, preview status transitions, write approved changes to the note's frontmatter, then regenerate the same cache.

Route by the argument: no argument / sync phrasing → Mode A; check / adoption phrasing → Mode B.

Intentionally Claude-Code-specific, not a template for a generic mechanism. This skill hardcodes the note permalink (main/reference/claude-code-noteworthy-features) and Claude-Code slug vocabulary — a deliberate, stated exception to this project's general domain-generic-skill convention, because the whole task is specifically about Claude Code feature adoption.

The single rule and line grammar both modes share when regenerating the cache live in references/tip-cache-contract.md — the single source of truth, so the two independent write paths never drift.

Mode A: sync

Follows the same vendor-sync pattern as tag-sync: registry (BM note) → fetch via MCP → filter → write to a synced local file the SessionStart hook (hooks/tip-fragment.sh) reads without ever touching Basic Memory. Always re-fetches on invocation — no same-day guard (read_note is one cheap call and the hook already throttles tip display to once/day independently).

Step 1: Fetch the note

mcp__basic-memory__read_note(
  identifier="main/reference/claude-code-noteworthy-features",
  output_format="json",
  include_frontmatter=true
)

On failure or an empty/malformed result, report the error and exit without writing — never overwrite a working cache with partial content. A missing note is reported, never auto-created (that's /intel's kind of job, not this skill's). Zero [nudge] observations is a legitimate state — write an empty cache file.