Instinct Clustering
Overview
Cluster related instincts into higher-level abstractions: skills, commands, or agents. This skill analyzes accumulated behavioral patterns (instincts) and identifies groups that can be consolidated into reusable components.
Pipeline position: observe → instincts → cluster (this skill) → skills/commands/agents
Quick Reference
| Task | Command |
|---|---|
| Scan instincts | node "${SKILL_ROOT}/scripts/learn.js" scan --project {p} |
| Preview clusters | node "${SKILL_ROOT}/scripts/learn.js" preview --project {p} |
| List evolved | node "${SKILL_ROOT}/scripts/learn.js" list --project {p} |
Workflow
- •Scan: Load all instincts from
~/.claude/instincts/{project}/andglobal/ - •Cluster: Group by domain, then within each domain use trigger fingerprint similarity (Jaccard >= 0.6) to find sub-clusters
- •Filter: Only process clusters with 3+ instincts, at least 1 with confidence >= 0.6
- •Preview: Display candidate clusters for user review
- •Generate: User decides what to create (skill, command, or agent)
- •Track: Record which instincts were consolidated
When to Use
- •
instinct evolvesuggests clustering candidates - •5+ instincts accumulated in the same domain
- •User wants to consolidate behavioral patterns into reusable components
- •User explicitly asks to cluster or organize instincts
When NOT to Use
- •Fewer than 3 instincts in any domain
- •User wants to save a single pattern (use /recall instead)
- •User wants to reflect on diaries (use /reflect instead)
- •User wants to confirm/contradict individual instincts (use arc-observing)
Key Principles
- •User-driven: Preview clusters and let user decide what to create
- •Minimum cluster size: 3+ instincts required per cluster
- •Quality threshold: At least 1 instinct must have confidence >= 0.6
- •Source tracking: Record which instincts were consumed by each cluster