instinctslisted

Atomic behavioral instincts system. Captures micro-learnings as lightweight YAML entries with confidence scoring (0.3-0.9). Project-scoped instincts are stored locally; universal instincts feed into the reflect-kb GraphRAG knowledge base for cross-project retrieval. Use when: (1) A behavioral pattern should be remembered but is too small for a full learning note, (2) Building up project-specific conventions, (3) User wants quick lightweight corrections captured, (4) Accumulating micro-patterns during a session, (5) User requests /instincts.
stevengonsalvez/agents-in-a-box · ★ 14 · AI & Automation · score 71

Install: claude install-skill stevengonsalvez/agents-in-a-box

# Instincts — Atomic Behavioral Micro-Learnings ## Philosophy Not every learning needs a full knowledge note. Some are tiny: - "This project uses tabs, not spaces" - "Always run `pnpm` not `npm` here" - "The API returns dates as Unix timestamps, not ISO" These are **instincts** — atomic rules with confidence that grow stronger through reinforcement and decay through contradiction. ## Quick Reference | Command | Action | |---------|--------| | `/instincts` | Show active instincts for current project | | `/instincts add` | Manually add an instinct | | `/instincts review` | Review and adjust confidence of existing instincts | | `/instincts promote` | Promote high-confidence instincts to global learnings | | `/instincts prune` | Remove low-confidence or stale instincts | ## Instinct Format Each instinct is a single YAML entry: ```yaml - id: inst-20260310-a1b2c3 rule: "Use pnpm instead of npm for this project" confidence: 0.7 scope: project # project | domain | universal category: tooling # tooling | style | api | testing | architecture | convention created: 2026-03-10 last_reinforced: 2026-03-10 reinforcement_count: 1 source: "User corrected npm to pnpm" tags: [pnpm, npm, package-manager] ``` ## Storage ### Project-Scoped Instincts Stored in `.agents/instincts.yaml` at the project root: ```yaml # .agents/instincts.yaml # Auto-managed by /instincts skill. Edit manually if needed. version: 1 instincts: - id: inst-20260310-a1b2c3 ru