evolution-tracking

Track discourse evolution through 8-stage cognitive cycle, providing stage-specific actions and explore/focus balance recommendations. Use when analyzing thinking progression or guiding next exploration direction.
Category: discovered
Tags: github, community
Version: 1.0.0
Author: walid
Downloads: 0
Updated: 2025-11-22
Source: mrhpython/Soulfield
Download the latest version (v1.0.0) from this page.
SKILL.md

---
name: evolution-tracking
description: Track discourse evolution through 8-stage cognitive cycle, providing stage-specific actions and explore/focus balance recommendations. Use when analyzing thinking progression or guiding next exploration direction.
---

# Evolution Tracking Skill

**Purpose:** Track discourse evolution through InfraNodus 8-stage cognitive cycle

**Backend:** `backend/services/evolution-tracker.cjs` (404 lines)

**Status:** ✅ Operational (implemented Phase 2)

---

## What This Skill Does

Analyzes graph cognitive state transitions and recommends next actions based on InfraNodus 8-stage evolutionary cycle.

**Key Capabilities:**
- Detects current evolutionary stage (Genesis, Growth, Saturation, etc.)
- Recommends explore vs focus balance (0-1 scale)
- Tracks trajectory patterns (expanding, consolidating, cycling, stuck, balanced)
- Provides stage-specific actions

---

## When to Use This Skill

Use evolution tracking when:
- User requests "what stage am I at?"
- Graph analysis shows state transition (BIAS → FOCUSED → DIVERSE → DISPERSED)
- Need recommendations for next exploration direction
- Tracking thinking evolution over multiple sessions

---

## The 8 Evolutionary Stages

### Stage 1: Genesis (BIAS → BIAS)
- **Intent:** Focus
- **Explore Weight:** 0% explore, 100% focus
- **Actions:** Develop new concept from scratch, build foundation
- **Modularity:** 0-0.2

### Stage 2: Growth (BIAS → FOCUSED)
- **Intent:** Explore
- **Explore Weight:** 50% explore, 50% focus
- **Actions:** Highlight underrepresented ideas, add diverse concepts
- **Modularity:** 0-0.4

### Stage 3: Saturation (FOCUSED → FOCUSED)
- **Intent:** Link
- **Explore Weight:** 20% explore, 80% link
- **Actions:** Increase connectedness, strengthen cluster connections
- **Modularity:** 0.2-0.4

### Stage 4: Conservation (FOCUSED → FOCUSED)
- **Intent:** Focus
- **Explore Weight:** 0% explore, 100% focus
- **Actions:** Deepen structure, add supporting details
- **Modularity:** 0.2-0.4

### Stage 5: Assimilation (DIVERSE → DIVERSE)
- **Intent:** Explore
- **Explore Weight:** 60% explore, 40% focus
- **Actions:** Zoom out, develop cluster specificities
- **Modularity:** 0.4-0.65

### Stage 6: Fractalization (DIVERSE → DIVERSE)
- **Intent:** Balance
- **Explore Weight:** 50% explore, 50% focus
- **Actions:** Develop clusters, jump gaps, create bridges
- **Modularity:** 0.4-0.65

### Stage 7: Reorganization (DISPERSED → DISPERSED)
- **Intent:** Explore
- **Explore Weight:** 80% explore, 20% focus
- **Actions:** Jump across structural gaps, find radical connections
- **Modularity:** 0.65-1.0

### Stage 8: Reset (DISPERSED → BIAS)
- **Intent:** Explore
- **Explore Weight:** 90% explore, 10% focus
- **Actions:** Start fresh with new perspective, find unifying concept
- **Modularity:** 0-1.0 (transition)

---

## Trajectory Patterns

**Expanding:**
- Modularity increasing over time
- Moving toward DISPERSED state
- Recommendation: Good for exploration, watch for fragmentation

**Consolidating:**
- Modularity decreasing over time
- Moving toward FOCUSED/BIAS
- Recommendation: Good for coherence, watch for echo chambers

**Cycling:**
- Oscillating between states (A→B→A→B)
- Recommendation: Break cycle by introducing new concepts

**Stuck:**
- Same state repeatedly
- Recommendation: Force transition to opposite approach

**Balanced:**
- Healthy variation in modularity
- Recommendation: Continue current approach

---

## Example Usage

**Input:** Graph analysis with FOCUSED state, modularity=0.272

**Output:**
```
Stage: Saturation (Coherence)
Intent: link
Explore/Focus Weight: 0.2/0.8

Actions:
- Strengthen connections between clusters
- Add bridging concepts
- Expand cluster relationships

Next Stage: Conservation or Assimilation (depending on trajectory)
```

---

## Integration Points

**Called by:**
- `backend/services/agent-graph-service.cjs:142` (automatic on every analysis)

**Uses:**
- Cognitive state from detectCognitiveState()
- Modularity from statistics
- Optional: State history for trajectory analysis

**Outputs:**
- Current stage info
- Recommended actions
- Explore/focus weights
- Trajectory pattern (if history available)

---

## Performance

- **Speed:** <1ms (pure logic, no API calls)
- **Accuracy:** 100% (deterministic stage detection)
- **Cost:** $0

---

## Testing

```bash
# Test evolution tracking
node -e "
const { analyzeForAgent } = require('./backend/services/agent-graph-service.cjs');
(async () => {
  const result = await analyzeForAgent('marketing', 'Your content here');
  console.log('Stage:', result.evolution.stage.name);
  console.log('Intent:', result.evolution.recommendations.intent);
  console.log('Actions:', result.evolution.recommendations.actions);
})();
"
```

---

## Related Skills

- **Cognitive Variability** - Provides cognitive state used by evolution tracking
- **Historical Tracking** - Uses evolution stages for trajectory analysis
- **Gap Scoring** - Gap actions integrated into stage recommendations

---

**Implementation:** Phase 2 (2025-11-06)
**Test Status:** ✅ Verified operational across @marketing, @seo, @finance
**Documentation:** workspace/docs/Obsidian-v2/daily/2025-11-06-PHASE2-COMPLETE.md