log-gap

name	log-gap
description	Log a one-line knowledge gap to the project's gaps.md file. Use when the user is surprised by Claude's answer, says "I didn't know that", "wait what", or wants to record a misconception they just discovered. Format "I assumed X but actually Y". Personal misconception log — much higher learning signal than feedback memories.

Log a knowledge gap

Captures the gap between what you assumed and what's actually true. This is the highest-signal learning artifact — feedback memories capture Claude's mistakes; gaps capture yours.

Instructions

1. Locate or create gaps.md in the project root.

   GAPS_FILE="$(git rev-parse --show-toplevel)/gaps.md"
   [ -f "$GAPS_FILE" ] || printf '%s\n\n' "# Knowledge Gaps" "Personal misconception log. One line per gap. Format: 'I assumed X but actually Y'." > "$GAPS_FILE"
   

2. Append the gap with date prefix.

   printf -- '- %s — %s\n' "$(date -u +%Y-%m-%d)" "<the gap text>" >> "$GAPS_FILE"
   

3. Format guidance:

   • One line. Keep it terse.
   • Format: I assumed <X> but actually <Y> — both halves are required.