git:20260530.8903322 to git:20260707.f0ac903

1 added, 1 removed. Audit A to A.

---

name: evolve

- description: Cluster hardened instincts (high-confidence feedback_*/discovery_* memories) into a proposed higher-level structure — a Command, Skill, or Agent. Run when many related instincts have accumulated in one domain. Part of the Instinct Engine. Do NOT use for one-off pattern capture (use /patterns) or daily journaling.

+ description: Use when many related hardened instincts (high-confidence feedback_*/discovery_* memories) have piled up in one domain, when the user runs /evolve or asks to promote, cluster, graduate, or consolidate accumulated instincts into a Command, Skill, or Agent, or when files in Instinct Proposals need review. Part of the Instinct Engine. Not for one-off pattern capture (use patterns), daily journaling, or sharing instinct packs (use instinct-export / instinct-import).

trigger: /evolve

---

# /evolve — promote a cluster of instincts into a structure

When many related, high-confidence instincts pile up in one domain, that is a

signal to promote them into ONE reusable structure instead of leaving them as

loose memories. `/evolve` finds those clusters deterministically and drafts a

proposal you refine.

ECC source pattern: "/evolve clusters related instincts into higher-level

structures: Commands / Skills / Agents." Reimplemented clean per license-hygiene.

## Step 1 — run the clusterer (deterministic, zero LLM cost)

```bash

python3 ~/.claude/skills/ai-brain-starter/scripts/instinct.py evolve

```

It groups every instinct by inferred `domain`, computes each cluster's median

effective confidence, and for clusters that clear the propose bar

(>= 2 instincts AND median confidence >= 0.80) writes a scaffold to

`<vault>/⚙️ Meta/Instinct Proposals/proposed-skill-<domain>.md`. Clusters below

the bar print as `watch` (not yet ripe).

## Step 2 — judge each PROPOSE cluster

For each proposal the script wrote, decide the structure:

- **Command** — the cluster is ONE repeatable procedure with a clear trigger.

- **Skill** — the cluster is a coherent body of domain guidance (most common).

- **Agent** — the cluster describes an autonomous multi-step workflow.

A cluster that is really just 2-3 facets of an existing rule should be

CONSOLIDATED into that rule, not promoted. Reject those.

## Step 3 — draft (only on confirm)

For an accepted cluster, draft the real skill/command body from the member

instincts (keep each instinct's Action + Evidence). Place it in the right repo

per the install rules, wire its discoverability + automation + verification in

the SAME session (the three-layer wiring rule), then retire or link the source

memories. Delete the proposal file once adopted or rejected — proposals are

scratch, not a backlog.

## Headless/auto mode

In a cron/`--print` session: run Step 1, report the PROPOSE clusters and the

proposal paths, and STOP. Promotion to a real skill is a judgment call that

needs a human — never auto-create skills.