instinct-system

Convert repeated project observations into confidence-scored hypotheses in .claude/instincts.md.

1|Updated Apr 28, 2026
One-click install
npx skills add https://github.com/Trossitec/dotnet-claude-kit --skill instinct-system-trossitec
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: instinct-system
Source: https://github.com/Trossitec/dotnet-claude-kit/tree/main/skills/instinct-system
Command: npx skills add https://github.com/Trossitec/dotnet-claude-kit --skill instinct-system-trossitec

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

It prevents Claude from mistaking one-off observations for project conventions by using a confidence-scored observe-hypothesize-confirm loop that only promotes confirmed instincts to permanent rules.

Core Features & Use Cases

  • Confidence-scored instinct tracking (0.3–0.9): Records patterns as hypotheses and controls whether Claude notes, suggests, follows, or promotes them based on certainty.
  • Project-scoped memory in .claude/instincts.md: Learns per-repository conventions without incorrectly transferring “rules” across different codebases.
  • Active confirmation workflow: Requires checking 2–3 related files to confirm or disconfirm patterns before increasing confidence.
  • Promotion to MEMORY.md at 0.9: Offers evidence-backed upgrades to permanent rules, or keeps instincts capped if the user declines.

Quick Start

Use the instinct-system skill when you notice a recurring pattern and tell Claude to start by loading existing instincts from .claude/instincts.md for this session.

Frequently Asked Questions about instinct-system

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I track recurring codebase patterns without mistaking one-off observations for project conventions?▼

Track recurring codebase patterns by recording them as confidence-scored hypotheses in a dedicated instincts file, requiring active confirmation across multiple files before promoting them to permanent project conventions.

How does confidence scoring work for hypothesis tracking in codebase analysis?▼

Confidence scoring for hypothesis tracking works by assigning a 0.3 to 0.9 range to observed patterns, controlling whether the system notes, suggests, follows, or promotes them based on certainty levels.

How do I safely confirm project conventions during codebase navigation?▼

Safely confirm project conventions during codebase navigation by checking 2 to 3 related files to verify or disconfirm recurring style, architecture, naming, testing, or EF Core patterns before increasing confidence.

Can I use instinct tracking for dotnet patterns and EF Core conventions?▼

Yes, you can use instinct tracking for dotnet patterns and EF Core conventions by loading project-scoped instincts to learn per-repository conventions without incorrectly transferring rules across different codebases.

When does a confirmed instinct get promoted to permanent memory rules?▼

A confirmed instinct gets promoted to permanent memory rules when its confidence score reaches 0.9, offering evidence-backed upgrades to permanent rules or keeping instincts capped if the user declines.

What is the best way to manage project-scoped memory for repository-specific conventions?▼

The best way to manage project-scoped memory for repository-specific conventions is maintaining a dedicated instincts file with an observe-hypothesize-confirm lifecycle, ensuring patterns are validated before becoming acting conventions.