cortex

Category: Development & Coding | Uploader: fermonterom | Downloads: 0 | Version: v1.0（Latest）

Continuous learning system for Claude Code. Observes sessions, crystallizes patterns as atomic instincts with confidence scoring, distills proven knowledge into laws. Commands: /cx-status, /cx-dashboard, /cx-analyze, /cx-distill, /cx-validate, /cx-evolve, /cx-eod, /cx-gotcha, /cx-audit, /cx-downvote, /cx-retro, /cx-timeline, /cx-export, /cx-backup, /cx-restore, /cx-dream, /cx-router, /cx-promote, /cx-feedback, /cx-feedback-auto.

Changelog: Source: GitHub https://github.com/fermonterom/fs-cortex

Directory Structure

Current level: tree/main/skills/cortex/

📄 SKILL.md 5.5 KB

SKILL.md

---
name: cortex
description: |
  Continuous learning system for Claude Code. Observes sessions,
  crystallizes patterns as atomic instincts with confidence scoring,
  distills proven knowledge into laws. Commands: /cx-status, /cx-dashboard,
  /cx-analyze, /cx-distill, /cx-validate, /cx-evolve, /cx-eod, /cx-gotcha,
  /cx-audit, /cx-downvote, /cx-retro, /cx-timeline, /cx-export, /cx-backup,
  /cx-restore, /cx-dream, /cx-router, /cx-promote, /cx-feedback,
  /cx-feedback-auto.
auto_activate: true
---

# Cortex v3.19.2 — Continuous Learning System

> Every session creates a connection. Cortex turns them into instinct.

## Architecture

3-level knowledge distillation with dual injection:

```
Observations (JSONL, async hooks, 0 tokens)
    ↓ /cx-analyze (cortex-observer agent, Opus 1M)
Instincts (YAML, confidence 0.0-0.95, injected via PreToolUse)
    ↓ confidence >= 0.90 via /cx-distill
Laws (TXT one-liners ≤120 chars, injected every SessionStart)
    ↓ clusters of 3+ mature instincts via /cx-evolve
Evolved artifacts (skills, commands, rules in evolved/)
```

## Data Location

`~/.claude/cortex/`

## How It Works

### Automatic (no user action needed)
- **Laws** injected at SessionStart (~300 tokens for max 10 laws)
- **Context bridge** injected at SessionStart (project context.md, 14d TTL)
- **EOD Resume** injected at SessionStart — Claude MUST present it proactively
- **Instincts** injected per PreToolUse via injector.sh (Unix) / injector.js (Windows) (max 3 instincts + 2 reflexes)
- **Observations** captured silently via async hooks (0 tokens)
- **Session analysis** runs at Stop (session-learner.js: proposals, context.md)
- After ~50 observations, session-start suggests running /cx-analyze

### Session Start Behavior (MANDATORY)

When the system prompt contains `EOD RESUME`, Claude MUST proactively present it in the **first response**, WITHOUT the user asking:

1. **Greeting** — Brief saludo
2. **Yesterday's summary** — Paraphrase EOD RESUME (1-2 lines)
3. **Learning status** — If pending observations, mention `/cx-analyze`
4. **Priorities** — List PRIORITIES as numbered list
5. **Ask** — Ask where to start (user's language from memory.json)

### Commands (20)

| Command | Purpose |
|---------|---------|
| `/cx-status` | Dashboard: laws, instincts, projects, reflexes, health |
| `/cx-dashboard` | Generate a visual HTML dashboard of Cortex state with Fersora brand — open in browser |
| `/cx-analyze` | Detect patterns in observations → proposals |
| `/cx-distill` | Distill laws, apply decay, check Jaccard promotions |
| `/cx-validate` | Review/confirm/reject proposals and weak instincts |
| `/cx-evolve` | Cluster mature instincts → skills/commands/rules |
| `/cx-audit` | Token overhead, duplicates, conflicts, cleanup proposals |
| `/cx-eod` | End-of-day summary for next session |
| `/cx-gotcha` | Capture error→fix as high-priority instinct |
| `/cx-downvote` | Negative feedback on incorrect instinct injection |
| `/cx-retro` | Weekly retrospective: command usage, health trend |
| `/cx-timeline` | Knowledge event log: creations, promotions, decays, archives, evolutions |
| `/cx-export` | Portable skill for Claude.ai or sharing |
| `/cx-backup` | .tar.gz backup for machine transfer |
| `/cx-restore` | Import backup with intelligent merge |
| `/cx-router` | Show command catalog with token costs and next action suggestion |
| `/cx-promote` | Promote project instincts to global when found in 2+ projects |
| `/cx-dream` | Dream Cycle: dedup, contradictions, staleness, regex, health, cleanup |
| `/cx-feedback` | Cierra el loop humano del funnel de impacto — marca la última inyección como útil o ruido |
| `/cx-feedback-auto` | Agent self-rating on tool-choice reflexes — emits feedback with source=agent |

### Learning Pipeline

```
Observe (hooks) → Analyze → Validate → Distill → Evolve → Audit
   auto            manual    manual     manual    manual   manual
```

## Confidence System

Continuous 0.0–0.95 (capped, always refinable):

| Range | Label | Injection |
|-------|-------|-----------|
| 0.00-0.29 | Observation | Not injected |
| 0.30-0.49 | Hypothesis | Only if trigger+tool match |
| 0.50-0.69 | Pattern | When trigger matches |
| 0.70-0.89 | Instinct | Automatic, promotion candidate |
| 0.90-0.95 | Law | Auto-distilled, injected always |

**Up**: +0.10/occurrence (max +0.30/cycle), +0.20 user validation, +0.20 cross-project
**Down**: -0.20 contradiction, -0.10 failed application, -0.05/30 days unused
**Promotion**: Jaccard ≥0.70 + 2 projects + avg conf ≥0.80

## Instinct Format (v2.0 YAML)

```yaml
---
id: supabase-rls-auth-uid
trigger: "rls|policy|supabase|auth\\.uid"
action: "Verify auth.uid() in WHERE. Test with auth and service roles."
confidence: 0.75
domain: database
tags: [supabase, rls, security]
scope: project
project_id: "hash"
source: session-observation
first_seen: "2026-03-28"
last_seen: "2026-04-03"
occurrences: 4
evidence:
  - "2026-03-28: User corrected missing auth.uid()"
---
```

## Domains

workflow-general | web-development | saas-development | database |
deployment | automation | documentation | testing | security

## Agents

| Agent | Model | Purpose |
|-------|-------|---------|
| cortex-observer | Opus 1M | Detect patterns in observations (cross-project, full context) |
| cortex-reviewer | Sonnet x3 | Parallel code review (security + quality + correctness) |
| cortex-planner | Sonnet | Task decomposition |

## Token Budget (~1,750/session)

- SessionStart: ~550 (laws + EOD + context bridge)
- PreToolUse: ~40 avg per tool use (max 3 instincts + 2 reflexes)

Comments 0

Latest | Hot

Please login before commenting.

Loading comments...

cortex

Directory Structure

SKILL.md

Report

Notice