instinct-apply▌
humanplane/homunculus · updated Apr 8, 2026
You have learned behaviors. Use them.
Instinct 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.
Discussion
Product Hunt–style comments (not star reviews)- No comments yet — start the thread.
Ratings
4.7★★★★★69 reviews- ★★★★★Ava Srinivasan· Dec 24, 2024
instinct-apply fits our agent workflows well — practical, well scoped, and easy to wire into existing repos.
- ★★★★★Aarav Chen· Dec 24, 2024
Useful defaults in instinct-apply — fewer surprises than typical one-off scripts, and it plays nicely with `npx skills` flows.
- ★★★★★William Ndlovu· Dec 20, 2024
We added instinct-apply from the explainx registry; install was straightforward and the SKILL.md answered most questions upfront.
- ★★★★★Pratham Ware· Dec 12, 2024
We added instinct-apply from the explainx registry; install was straightforward and the SKILL.md answered most questions upfront.
- ★★★★★Yusuf Srinivasan· Dec 4, 2024
Registry listing for instinct-apply matched our evaluation — installs cleanly and behaves as described in the markdown.
- ★★★★★Yuki Kapoor· Nov 23, 2024
Solid pick for teams standardizing on skills: instinct-apply is focused, and the summary matches what you get after install.
- ★★★★★William Lopez· Nov 15, 2024
We added instinct-apply from the explainx registry; install was straightforward and the SKILL.md answered most questions upfront.
- ★★★★★Naina Desai· Nov 15, 2024
I recommend instinct-apply for anyone iterating fast on agent tooling; clear intent and a small, reviewable surface area.
- ★★★★★Ama Anderson· Nov 11, 2024
instinct-apply fits our agent workflows well — practical, well scoped, and easy to wire into existing repos.
- ★★★★★Yash Thakker· Nov 3, 2024
instinct-apply fits our agent workflows well — practical, well scoped, and easy to wire into existing repos.
showing 1-10 of 69