Evolve Command

Implementation

Run the instinct CLI using the plugin root path:

python3 "${CLAUDE_PLUGIN_ROOT}/skills/continuous-learning-v2/scripts/instinct-cli.py" evolve [--generate]

Or if CLAUDE_PLUGIN_ROOT is not set (manual installation):

python3 ~/.claude/skills/continuous-learning-v2/scripts/instinct-cli.py evolve [--generate]

Analyzes instincts and clusters related ones into higher-level structures:

• Commands: When instincts describe user-invoked actions
• Skills: When instincts describe auto-triggered behaviors
• Agents: When instincts describe complex, multi-step processes

Usage

/evolve                    # Analyze all instincts and suggest evolutions
/evolve --generate         # Also generate files under evolved/{skills,commands,agents}

Evolution Rules

→ Command (User-Invoked)

• Multiple instincts about "when user asks to..."
• Instincts with triggers like "when creating a new X"
• Instincts that follow a repeatable sequence

• new-table-step1: "when adding a database table, create migration"
• new-table-step2: "when adding a database table, update schema"
• new-table-step3: "when adding a database table, regenerate types"

→ Skill (Auto-Triggered)

• Pattern-matching triggers
• Error handling responses
• Code style enforcement

• prefer-functional: "when writing functions, prefer functional style"
• use-immutable: "when modifying state, use immutable patterns"
• avoid-classes: "when designing modules, avoid class-based design"

→ Agent (Needs Depth/Isolation)

• Debugging workflows
• Refactoring sequences
• Research tasks

• debug-step1: "when debugging, first check logs"
• debug-step2: "when debugging, isolate the failing component"
• debug-step3: "when debugging, create minimal reproduction"
• debug-step4: "when debugging, verify fix with test"

What to Do

• Detect current project context
• Read project + global instincts (project takes precedence on ID conflicts)
• Group instincts by trigger/domain patterns
• Identify:

• Show promotion candidates (project -> global) when applicable
• If --generate is passed, write files to:

Output Format

============================================================
  EVOLVE ANALYSIS - 12 instincts
  Project: my-app (a1b2c3d4e5f6)
  Project-scoped: 8 | Global: 4
============================================================
High confidence instincts (>=80%): 5
SKILL CANDIDATES
Cluster: "adding tests"
   Instincts: 3
   Avg confidence: 82%
   Domains: testing
   Scopes: project
COMMAND CANDIDATES (2)
  /adding-tests
    From: test-first-workflow [project]
    Confidence: 84%
AGENT CANDIDATES (1)
  adding-tests-agent
    Covers 3 instincts
    Avg confidence: 82%

Flags

• --generate: Generate evolved files in addition to analysis output

Generated File Format

Command

---
name: new-table
description: Create a new database table with migration, schema update, and type generation
command: /new-table
evolved_from:
  - new-table-migration
  - update-schema
  - regenerate-types
New Table Command
[Generated content based on clustered instincts]
Steps
...
...

Skill

---
name: functional-patterns
description: Enforce functional programming patterns
evolved_from:
  - prefer-functional
  - use-immutable
  - avoid-classes
Functional Patterns Skill
[Generated content based on clustered instincts]

Agent

---
name: debugger
description: Systematic debugging agent
model: sonnet
evolved_from:
  - debug-check-logs
  - debug-isolate
  - debug-reproduce
Debugger Agent
[Generated content based on clustered instincts]