About instinct-apply
A skill that helps an agent consult learned instincts when making decisions during coding work. It checks relevant triggers and confidence, while allowing mismatches to be noted rather than followed blindly.
Key features
- 01Check instincts for relevant triggers
- 02Apply actions based on confidence
- 03Focus checks by work domain
- 04Note when an instinct seems wrong
Use cases
- 01Check code-style preferences before coding
- 02Consult testing instincts before running tests
- 03Use debugging preferences during investigation
Install
Copy the command and run it in a terminal.
$
npx skills add https:/ / github.com/ humanplane/ homunculus --skill instinct-applyAfter installing, type/instinct-applyin Claude Code to confirm it loaded.
Details
From the project READMEInstinct Apply
You have learned behaviors. Use them.
When To Check
- Starting a coding task
- About to use a tool in a pattern you've seen before
- Making decisions about code style, testing, git
How To Check
# 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
How To Apply
- Read the task/context
- Check instinct triggers
- If trigger matches, follow the action
- Note confidence level - higher confidence = more certain
Instinct Structure
---
trigger: "when [condition]"
confidence: 0.7
domain: "code-style"
---
# Name
## Action
What to do
## Evidence
Why this exists
Confidence Interpretation
- 0.3-0.5: Tentative. Apply if it feels right.
- 0.5-0.7: Moderate. Apply unless there's a reason not to.
- 0.7-0.9: Strong. Apply consistently.
- 0.9+: Near certain. Always apply.
If Instinct Seems Wrong
When an instinct fires but the action feels wrong for the situation:
- Don't apply it blindly
- Note the mismatch
- This is useful data for the observer
Instincts can be wrong. They're learned from patterns, and patterns have exceptions.
Lightweight Application
Don't read all instincts for every action. Keep relevant ones in working memory.
Quick domain check:
- Writing code? → Check
code-styleinstincts - Running tests? → Check
testinginstincts - Making commits? → Check
gitinstincts - Debugging? → Check
debugginginstincts
Be efficient. Instincts are meant to help, not slow down.
Comments
Markdown supported