Soul-Brews-Studio/resonance

/resonance — Capture What Resonates

When something clicks — log it. The pattern, the insight, the spark.

Usage

/resonance                    # Auto-detect from recent conversation
/resonance "skills as marketplace"  # With explicit note

When to Trigger

AI should consider auto-suggesting /resonance when user says:

• "yes!", "cool!", "very cool!", "love it!", "exactly!"
• "that's it!", "perfect!", "นี่แหละ!", "ใช่เลย!"
• Strong agreement after a design decision or insight

Steps

0. Anchor (date-stamp + root)

date "+🕐 %H:%M %Z (%A %d %B %Y)"

# Find oracle root — git toplevel that has CLAUDE.md + ψ/
ORACLE_ROOT=$(git rev-parse --show-toplevel 2>/dev/null)
if [ -n "$ORACLE_ROOT" ] && [ -f "$ORACLE_ROOT/CLAUDE.md" ] && { [ -d "$ORACLE_ROOT/ψ" ] || [ -L "$ORACLE_ROOT/ψ" ]; }; then
  PSI="$ORACLE_ROOT/ψ"
elif [ -f "$(pwd)/CLAUDE.md" ] && { [ -d "$(pwd)/ψ" ] || [ -L "$(pwd)/ψ" ]; }; then
  ORACLE_ROOT="$(pwd)"
  PSI="$ORACLE_ROOT/ψ"
else
  echo "⚠️ Not in oracle repo (no CLAUDE.md + ψ/ at git root). Writing to pwd."
  ORACLE_ROOT="$(pwd)"
  PSI="$ORACLE_ROOT/ψ"
fi

1. Analyze Recent Conversation

Look back at the last 5-10 messages. Find:

• What: The specific idea, pattern, or decision that sparked the reaction
• When: Timestamp (from hook context or current time)
• Why: Why did this resonate? What problem does it solve?
• How: How was it discovered? What led to this moment?
• Connection: Does this connect to existing Oracle learnings?

2. Log to Vault

mkdir -p "$PSI/memory/resonance"

Write to: $PSI/memory/resonance/YYYY-MM-DD_HHMM_slug.md

# Resonance: [short title]

**When**: YYYY-MM-DD HH:MM
**Session**: [session-id]
**Context**: [what we were working on]

## What Resonated
[The specific idea/pattern/decision]

## Why It Matters
[Why this clicked — what problem it solves, what it enables]

## How We Got Here
[The conversation path that led to this moment]

## Connection
[Links to existing patterns, principles, or learnings]

## Tags
[concept tags for future search]

3. Sync to Oracle (if available, two-layer pattern)

1. Write to $PSI/memory/learnings/YYYY-MM-DD_resonance-<slug>.md with frontmatter:

   ---
   pattern: "[resonance title]: [what resonated]"
   date: <today>
   source: resonance: [repo-name]
   concepts: ["resonance", <tags>]
   ---
   
   # [resonance title]
   [what resonated and why]
   

2. The Oracle's auto-memory layer picks up new files in $PSI/memory/learnings/ automatically — no separate API call needed.

4. Confirm (announce-mode — absolute paths required)

announce-mode → absolute path (no ψ/, no ~/, no $VAR, no ...).

Use: echo "marker: $RESOLVED_PATH" — bash substitutes. See CONVENTIONS.md.

RES_FILE="$PSI/memory/resonance/$(date +%Y-%m-%d)_$(date +%H%M)_${SLUG}.md"
LESSON_FILE="$PSI/memory/learnings/$(date +%Y-%m-%d)_resonance-${SLUG}.md"
echo "✨ Resonance captured: ${TITLE}"
echo "📥 Saved:   $RES_FILE"
echo "💡 Lesson:  $LESSON_FILE"

Short. Don't over-explain. The moment speaks for itself.

Philosophy

Resonance is the signal. When something resonates, it means the pattern matches reality. Log it before it fades.

Resonance logs are different from learnings:

• Learnings = what you figured out (head)
• Resonance = what clicked (heart)

Over time, resonance logs reveal what matters most — not what's logical, but what's alive.

ARGUMENTS: $ARGUMENTS