session-memory
Maintains awareness across sessions. Spawns observer agent on start, loads context, notifies of evolution opportunities.
Surfaces relevant instincts during work. Use when starting a task to check if any learned behaviors apply.
$ npx -y skills add humanplane/homunculus --skill instinct-apply --agent claude-codeHow it fires
How this skill gets triggered: by you, by Claude, or both.
/instinct-applyContext preview
The summary Claude sees to decide when to auto-load this skill.
Surfaces relevant instincts during work. Use when starting a task to check if any learned behaviors apply.
name: instinct-apply description: Surfaces relevant instincts during work. Use when starting a task to check if any learned behaviors apply.
You have learned behaviors. Use them.
# Read all personal instincts for f in .claude/homunculus/instincts/personal/*.md; do [ -f "$f" ] && echo "=== $(basename "$f") ===" && cat "$f" && echo done 2>/dev/null # Also check inherited instincts for f in .claude/homunculus/instincts/inherited/*.md; do [ -f "$f" ] && echo "=== $(basename "$f") ===" && cat "$f" && echo done 2>/dev/null
1. Read the task/context 2. Check instinct triggers 3. If trigger matches, follow the action 4. Note confidence level - higher confidence = more certain
--- trigger: "when [condition]" confidence: 0.7 domain: "code-style" --- # Name ## Action What to do ## Evidence Why this exists
When an instinct fires but the action feels wrong for the situation:
1. Don't apply it blindly 2. Note the mismatch 3. This is useful data for the observer
Instincts can be wrong. They're learned from patterns, and patterns have exceptions.
Don't read all instincts for every action. Keep relevant ones in working memory.
Quick domain check:
Be efficient. Instincts are meant to help, not slow down.
In old alchemical texts, a homunculus was a tiny being grown in a sealed vessel—alive, aware, bound to its creator alone. This is that idea, alive in your terminal.
Maintains awareness across sessions. Spawns observer agent on start, loads context, notifies of evolution opportunities.