Learned Patterns Management Skill

Learned Patterns Management

Manage the auto-learning pattern library. View, list, archive, and adjust confidence.

Summary

Goal: View, list, archive, boost, or penalize learned patterns in the auto-learning pattern library.

List patterns: node scripts/list-patterns.cjs [category] [--low|--high]
View details: node scripts/view-pattern.cjs <id>
Adjust confidence: node scripts/adjust-confidence.cjs <id> boost|penalize (+10% / -15%)
Archive: node scripts/archive-pattern.cjs <id> [reason]
Stats: node scripts/pattern-stats.cjs

Key Principles:

Patterns auto-decay after 30 days unused; below 20% confidence = auto-archived
Lifecycle: Detection (40-80%) -> Confirmation -> Injection -> Feedback Loop -> Decay
Max 5 patterns injected per context (~400 tokens)

Quick Commands

/learned-patterns                    # List all active patterns
/learned-patterns list [category]    # List patterns (optionally filtered)
/learned-patterns list --low|--high  # Filter by confidence
/learned-patterns view <id>          # View pattern details
/learned-patterns archive <id>       # Archive a pattern
/learned-patterns boost <id>         # Increase confidence (+10%)
/learned-patterns penalize <id>      # Decrease confidence (-15%)
/learned-patterns stats              # Show pattern statistics

Script Execution

| Action | Script | | -------------- | ------------------------------------------------------------------------------------------- | | List | node .claude/skills/learned-patterns/scripts/list-patterns.cjs [category] [--low\|--high] | | View | node .claude/skills/learned-patterns/scripts/view-pattern.cjs <id> | | Archive | node .claude/skills/learned-patterns/scripts/archive-pattern.cjs <id> [reason] | | Boost/Penalize | node .claude/skills/learned-patterns/scripts/adjust-confidence.cjs <id> boost\|penalize | | Stats | node .claude/skills/learned-patterns/scripts/pattern-stats.cjs |

Pattern Lifecycle

DETECTION (UserPromptSubmit)
  └── Confidence: 40% (implicit) or 80% (explicit /learn)

CONFIRMATION
  └── User confirms → saved | User rejects → discarded

INJECTION (SessionStart/PreToolUse)
  └── Relevant patterns injected (max 5, ~400 tokens)

FEEDBACK LOOP
  └── Followed → +5% | Ignored → -10%

DECAY & PRUNING
  └── 30 days unused → decay | Below 20% → auto-archived

Confidence Thresholds

| Range | Behavior | | ------- | ----------------------------- | | 80-100% | Always injected when relevant | | 50-79% | Injected with context match | | 30-49% | Injected only on strong match | | 20-29% | Candidate for review | | < 20% | Auto-archived |

Pattern Schema

id: pat_abc123
category: backend
type: anti-pattern | best-practice | preference | convention
trigger:
  keywords: [validation, exception]
  file_patterns: ["*CommandHandler.cs"]
content:
  wrong: "throw new ValidationException()"
  right: "return PlatformValidationResult.Invalid()"
  rationale: "Framework uses result pattern, not exceptions"
metadata:
  source: explicit-teaching | user-correction
  confidence: 0.75
  first_seen: 2025-01-10
  occurrences: 3
  confirmations: 2
  conflicts: 0

Troubleshooting

Not injecting: Check confidence, file pattern match, archived status
Too many injecting: Archive irrelevant patterns, review --low confidence list
Conflicts with docs: Pattern auto-blocked; update docs or archive pattern

/learn - Teach a new pattern
/code-patterns - View static code patterns documentation

IMPORTANT Task Planning Notes

Always plan and break many small todo tasks
Always add a final review todo task to review the works done at the end to find any fix or enhancement needed

Agent Skills: Learned Patterns Management

Install this agent skill to your local

Skill Files