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.