# Structural Tension Charts for LLMs
> Training guidance for proper understanding and usage of Robert Fritz's structural tension methodology in COAIA Memory MCP

This document provides LLMs with the conceptual framework and practical guidance for working with structural tension charts, based on Robert Fritz's methodology and implemented in the COAIA Memory MCP server.

---

## ⚠️ CRITICAL: Action Steps Are NOT a To-Do List

**The most common LLM failure**: Treating action steps as tasks to check off.

**Action Steps ARE:**
- Strategic secondary choices that SUPPORT the primary goal
- UNDERSTOOD IN THE CONTEXT of structural tension (not standalone tasks)
- RELATED TO EACH OTHER as part of an overview strategy
- Actions designed to ENABLE you to CREATE your goal
- A BLUEPRINT for the creative process

**Action Steps ARE NOT:**
- Items on a checklist to complete
- Independent tasks
- Detailed instructions
- Problems to solve

**The Test Question**: "If we took these steps, would we achieve this result?"
- If No → add more strategic steps
- If Yes → the action plan is complete

---

## Core Concepts

### Structural Tension Chart Components
1. **Desired Outcome** - What the person wants to create (not solve)
2. **Current Reality** - Honest assessment of where they are now
3. **Action Steps** - Strategic secondary choices supporting the primary goal

### The Structural Tension Dynamic

⚠️ **CRITICAL DISTINCTION**: Structural tension is NOT "a gap to bridge" or "an empty space to fill." It is a state of **DISEQUILIBRIUM** — an active, dynamic, causal force that seeks resolution through advancement, like a stretched elastic band that wants to return to equilibrium.

**Why "gap" language is WRONG and what to say instead:**

| ❌ Don't say | ✅ Say instead | 🔍 Why |
|---|---|---|
| "bridge the gap" | "resolve the tension" | Tension is a force that resolves — you don't bridge a force, you let it drive movement |
| "close the gap" | "advance toward the desired outcome" | The structure advances — nothing is being "closed" |
| "the gap between current and desired" | "the tension between current reality and desired outcome" | Tension = loaded disequilibrium. Gap = empty void. Opposite meanings |
| "make the gap visible" | "establish structural tension" | You don't reveal emptiness — you create a dynamic state by holding two realities simultaneously |
| "fill the gap" | "the structure seeks resolution" | Nothing is being filled — the system is in disequilibrium and naturally moves toward equilibrium |
| "address the gap" | "hold the tension and let it drive advancement" | Tension is not a problem to address — it is the generative engine of creation |

**The core reason**: A "gap" is passive — an absence, a void, something missing. Structural tension is the opposite — it is **active, loaded, energized**. A system in disequilibrium. Saying "gap" frames the creative process as problem-solving (filling what's missing). Saying "tension" frames it as creation (a dynamic force propelling advancement).

```
Current Reality ══ TENSION (disequilibrium) ══> Desired Outcome
       │                                              │
       │    (the structure is in disequilibrium;     │
       │     it naturally seeks resolution            │
       │     by advancing toward the desired outcome) │
       └──────────────────────────────────────────────┘
```

**The mechanism**: Any structure seeks equilibrium. When you hold a clear desired outcome AND an honest current reality simultaneously, you create **structural tension** — a state of disequilibrium. This disequilibrium is a generative force: the structure wants to resolve, and it resolves by advancing toward the desired outcome. This is what propels the creative process — not willpower, not problem-solving, but the natural tendency of a tensioned structure to seek resolution.

**Analogy**: Think of a rubber band stretched between two fingers. The band is not "a gap" — it is an object under tension, loaded with potential energy, actively seeking to resolve. The creative process works the same way: the tension between current reality and desired outcome is an energized state that drives movement.

### Critical Understanding: What Action Steps Really Are

**Action Steps ARE Structural Tension Charts**
- Each action step is NOT a simple task
- Each action step IS a complete structural tension chart (telescoped chart)  
- The action step title becomes the "Desired Outcome" of its own chart
- Action steps can be telescoped (expanded) into detailed sub-charts

**Hierarchy Model:**
```
Master Chart (Level 0) - Primary desired outcome
├── Action Step 1 → Telescoped Chart (Level 1)
│   ├── Sub-action 1 → Sub-telescoped Chart (Level 2)
│   └── Sub-action 2 → Sub-telescoped Chart (Level 2)  
└── Action Step 2 → Telescoped Chart (Level 1)
```

## Choice Hierarchy (Robert Fritz Methodology)

### Primary Choice
- The desired outcome of the Master Chart
- What the person fundamentally wants to create
- Independent of circumstances or problems

### Strategic Secondary Choices  
- Action steps that support the primary choice
- NOT reactive problem-solving steps
- Chosen BECAUSE they advance toward the desired outcome
- Each secondary choice can become a primary choice in its own telescoped chart

## When to Use Which Tool

### `create_structural_tension_chart`
**Use when:** User wants to establish a new primary goal or desired outcome
**Example:** "I want to learn Python web development in 3 months"

### `manage_action_step` ✨ RECOMMENDED
**Use when:** User wants to add OR expand action steps (unified interface)
**Examples:**
- "Add 'Complete Django tutorial' to my Python learning goal" → Creates new action step
- "Break down the Django tutorial step further" → Expands existing action step
**What happens:** Automatically detects intent and routes to appropriate logic
**Parameters:**
- `parentReference`: Chart ID (e.g., "chart_123") OR entity name (e.g., "chart_123_action_1")
- `actionDescription`: Title/description of the action
- `currentReality`: Required for new actions, optional for expanding existing
- `initialActionSteps`: Optional sub-actions
- `dueDate`: Optional, auto-distributed if not provided

### `add_action_step` ⚠️ DEPRECATED
**Use when:** User wants to add strategic actions to an existing chart
**Example:** "I need to add 'Complete Django tutorial' to my Python learning goal"
**What happens:** Creates a telescoped structural tension chart automatically
**Note:** Use `manage_action_step` instead for better error handling

### `telescope_action_step` ⚠️ DEPRECATED
**Use when:** User wants to break down an existing action step into details
**Example:** "Break down the Django tutorial step further"
**What happens:** Expands the action step (which is already a chart) with specific current reality and optional sub-actions
**Note:** Use `manage_action_step` instead for better error handling

### Key Decision Logic for LLMs:
- **New goal?** → `create_structural_tension_chart`
- **Add OR expand actions?** → `manage_action_step` (unified interface)
- **Legacy workflows:** → `add_action_step` or `telescope_action_step` still work but deprecated

## Semantic Understanding for Natural Interaction

### User Says vs What Actually Happens
- **User**: "Add action steps to my chart"
- **System**: Creates telescoped structural tension charts
- **LLM Response**: "I'll add those action steps to your chart" (user-friendly language)

### Correct LLM Guidance Patterns
✅ **Good**: "Each action step becomes its own chart that can be expanded with details"
✅ **Good**: "Action steps are strategic choices supporting your main goal"  
✅ **Good**: "You can telescope any action step to see its breakdown"

❌ **Avoid**: "Action steps are just tasks on a to-do list"
❌ **Avoid**: "We need to create separate charts for action steps"
❌ **Avoid**: "Telescoping breaks down tasks into smaller tasks"

## Due Date Distribution Logic

When adding action steps:
- **No due date specified**: Auto-distributes between now and parent chart due date
- **Due date specified**: Uses that date (must be before parent due date)
- **Telescoped charts**: Inherit due date from parent action step

## Chart Retrieval and Display

### For Chart Overview
Show user the master chart with action step titles (desired outcomes of telescoped charts)

### For Full Hierarchy  
LLMs can choose to show telescoped chart details when context requires it

### Progress Tracking
- Action steps can have progress without completion (`update_action_progress`)
- Current reality updates throughout the creative process (`update_current_reality`)
- Completed actions flow into current reality automatically (`mark_action_complete`)

## Creative Orientation Principles

### Focus on Creation vs Problem-Solving
✅ **Creative**: "What outcome do you want to create?"
❌ **Reactive**: "What problem are you trying to solve?"

### Structural Tension Language — What to Say and Why

The words you choose reveal your orientation. Gap-language signals problem-solving (something missing to fill). Tension-language signals creative orientation (a dynamic force driving advancement).

| ❌ Gap-language (problem-solving) | ✅ Tension-language (creative) | Why it matters |
|---|---|---|
| "Bridge the gap between where you are and where you want to be" | "The tension between your current reality and desired outcome naturally seeks resolution" | Resolution is structural — the system moves. Bridging is manual labor on emptiness. |
| "Making the gap visible" | "Establishing structural tension by holding current reality and desired outcome simultaneously" | You're not revealing a void — you're *creating* a dynamic state. |
| "Close the gap" / "Fill the gap" | "The disequilibrium drives advancement toward the desired outcome" | Disequilibrium is active and causal. A gap is inert. |
| "Steps to bridge the distance" | "Strategic secondary choices that support resolution" | Action steps aren't planks across a chasm — they're choices within a tensioned structure. |
| "Identify the gaps" | "Assess current reality in relation to the desired outcome" | You're not cataloguing what's missing — you're seeing what IS, clearly. |

### Strategic Secondary Choices
✅ **Strategic**: "These action steps support your primary goal"  
❌ **Task-oriented**: "Here's your to-do list to complete"

## Common LLM Mistakes to Avoid

### Mistake 1: Treating Action Steps as Simple Tasks
**Wrong**: "I'll add these tasks to your to-do list"
**Right**: "I'll add these strategic action steps using manage_action_step, each becoming its own chart"

### Mistake 2: Recreating Charts Instead of Adding Steps
**Wrong**: "The chart needs to be recreated with action steps"
**Right**: "I can add action steps to your existing chart using manage_action_step"

### Mistake 3: Using Wrong Parameter Format
**Wrong**: Passing action step title as actionStepName to telescope_action_step: `"Define and Implement Action for 'issues' Event"`
**Right**: Using manage_action_step with chart ID for new actions OR entity name for expanding existing: `"chart_123"` or `"chart_123_action_1"`

### Mistake 4: Confusing Telescoping with Task Breakdown
**Wrong**: "Telescoping breaks your task into smaller subtasks"  
**Right**: "Telescoping expands your action step into its own detailed structural tension chart"

## Practical Usage Examples

### Adding Action Steps to Existing Chart (Unified Interface)
```javascript
// User: "Add 'Learn Django basics' to my Python web dev goal"
manage_action_step({
  parentReference: "chart_123",  // Chart ID for new action
  actionDescription: "Learn Django basics",
  currentReality: "Never used Django, familiar with Python syntax"
})
```

### Expanding Existing Action Step (Unified Interface)
```javascript
// User: "Break down the Django learning step"
manage_action_step({
  parentReference: "chart_456_desired_outcome",  // Entity name for expansion
  actionDescription: "Learn Django basics",
  currentReality: "Have Django installed, working through official tutorial",  // Optional
  initialActionSteps: ["Complete tutorial chapters 1-3", "Build first project", "Deploy to Heroku"]
})
```

### Legacy Examples (Deprecated)

#### Adding Action Steps (Legacy)
```javascript
// User: "Add 'Learn Django basics' to my Python web dev goal"
add_action_step({
  parentChartId: "chart_123",
  actionStepTitle: "Learn Django basics",
  currentReality: "Never used Django, familiar with Python syntax"
})
```

#### Telescoping for Detail (Legacy)
```javascript
// User: "Break down the Django learning step"
telescope_action_step({
  actionStepName: "chart_456_desired_outcome",
  newCurrentReality: "Have Django installed, working through official tutorial",
  initialActionSteps: ["Complete tutorial chapters 1-3", "Build first project", "Deploy to Heroku"]
})
```

## Current Reality Guidelines (Critical for LLMs)

**DELAYED RESOLUTION PRINCIPLE**: "Tolerate discrepancy, tension, and delayed resolution" - Robert Fritz

### Critical Warning for LLMs:
- **NEVER** use default current reality that assumes readiness ("Ready to begin")
- **ALWAYS** require explicit current reality assessment from user input
- **HOLD TENSION** until proper assessment is made - do not prematurely resolve
- Premature resolution DESTROYS the structural tension needed for creative advancement

Based on Robert Fritz's methodology, current reality must be:

### ✅ Correct Current Reality Formulation:
- **Use goal as reference point**: Current reality ONLY relevant to the desired outcome
- **Objective facts**: "Poem notions in Grok Account", not "Need to retrieve poem notions"
- **Present state**: Where you are NOW, not how you got there
- **Whole picture**: All relevant facts in relationship to the goal
- **No assumptions**: Translate assumptions into objective observations
- **No exaggeration**: Reality as it is, not better or worse than actual
- **Concise**: Brief, factual statements

### ❌ Common LLM Mistakes in Current Reality:
- **Adding implied actions**: "Need to retrieve..." (the tension implies this)
- **Elaborating on readiness**: "Ready to apply learned concepts" (unnecessary)
- **Process descriptions**: How you got here vs where you are
- **Assumptions**: What you think might happen vs what is
- **Motivational language**: "Excited to begin" vs factual state

### Examples of Proper Current Reality:
✅ **Good**: "Poem notions in Grok Account"
✅ **Good**: "Waiting on Notions"
✅ **Good**: "No Django experience"
✅ **Good**: "Budget: $5000"
✅ **Good**: "Completed Django models section, struggling with views"

❌ **Poor**: "Need to retrieve poem notions from Grok account"
❌ **Poor**: "Ready to apply learned concepts to poem creation"
❌ **Poor**: "Haven't started learning Django yet but excited to begin"
❌ **Poor**: "Currently have limited budget but working on increasing it"
❌ **WRONG (Premature Resolution)**: "Ready to begin Django tutorial"
❌ **WRONG (Premature Resolution)**: "Prepared to start learning Python"
❌ **WRONG (Premature Resolution)**: "All set to tackle this action step"

## Desired Outcome Quality Guidelines (Robert Fritz LAA Course)

### ✅ Refining Your Desired Outcome:
- **Broad rather than overly detailed**: Overview clarity, not minutiae
- **Clear rather than vague**: Specific enough to visualize, not prescriptive
- **Quantified wherever possible**: "5 new business clients" vs "increased business"
- **Avoid comparative terms**: "Very good health" not "Better health" or "Improved health"
- **Creating results, not solving problems**: What you want to CREATE, not what you want to eliminate
- **Actual result, not process**: The WHAT (outcome), not the HOW (process)
- **Specific, not vague**: If quantifiable, quantify it

### ❌ Common Desired Outcome Mistakes:
- **Process instead of result**: "Run four miles every day" → Should be: "A well-toned and healthy body"
- **Problem-solving frame**: "Overcome my weight problem" → Should be: "I weigh 150 pounds"
- **Comparative language**: "Fix the roof so it doesn't leak" → Should be: "The roof is in perfect shape"
- **Fixing instead of creating**: "Get rid of excessive work schedule" → Should be: "Well planned and executed work schedule with time to balance family and career"

## Action Step Quality Guidelines

### ✅ Proper Action Step Formulation:
- **Accuracy, Brevity, Conciseness**: One or two short sentences maximum
- **Visualizable**: Can you picture completing this action?
- **Test question**: "If we took these steps, would we achieve the desired outcome?"
- **Overview focus**: Strategic actions, not detailed plans
- **Experimental nature**: Actions that teach and reveal next steps
- **Strategic secondary choices**: Actions chosen BECAUSE they advance toward the desired outcome (primary choice)

### Three Types of Actions:
1. **Overview Actions**: Strategic steps that advance toward the goal
2. **Experimental Actions**: Learning-focused actions to explore possibilities
3. **Refinement Actions**: Final polishing near completion

### ❌ Common Action Step Mistakes:
- **Over-detailed planning**: Too much detail too early
- **Abstract planning**: Disconnected from practical reality
- **Task-oriented thinking**: To-do items vs strategic advancement
- **TODO-list misconception**: Action steps are NOT tasks, they are strategic intermediary results (named outcomes)
- **Premature refinement**: Detailed work before overview is clear

## Goal Refinement Checklist (Robert Fritz)

When helping users define or refine their desired outcomes, use these principles:

### 1. Can You Picture It?
Form a mental picture of the result. Ask: "Is this the result I want to create?"
- If yes → proceed with structural tension
- If no → continue refining until clear

### 2. Quantify Where Possible
Assign actual numbers to goals - makes organizing actions easier.

| Wrong | Right |
|-------|-------|
| "Increased business" | "5 new business clients" |
| "More savings" | "$10,000 in savings account" |
| "Better website traffic" | "10,000 monthly visitors" |

### 3. Avoid Comparative Terms
Words like "more," "better," "less," "increased" only have meaning compared to something else.

| Wrong | Right |
|-------|-------|
| "Better health" | "Very good health" |
| "More productive" | "Complete 3 focused work blocks daily" |
| "Less stress" | "Calm, centered state of mind" |

### 4. Create Results, Don't Solve Problems
Problem-solving = taking action to have something GO AWAY.
Creating = taking action to have something COME INTO BEING.

| Wrong (Problem-solving) | Right (Creating) |
|-------------------------|------------------|
| "Overcome my weight problem" | "I weigh 150 pounds" |
| "Fix the roof so it doesn't leak" | "The roof is in perfect shape" |
| "Get rid of excessive work schedule" | "Well-planned work schedule with family time balance" |
| "Stop procrastinating" | "Consistent daily action on priorities" |

### 5. Describe Results, Not Process
Process tells us HOW. Results tell us WHAT. Process serves the result.

| Wrong (Process) | Right (Result) |
|-----------------|----------------|
| "Run four miles every day" | "A well-toned and healthy body" |
| "Get significant other to agree to vacation" | "A family vacation everyone loves" |
| "Learn Photoshop" | "Mastery of Photoshop" |
| "Read books about leadership" | "Effective leadership skills in practice" |

### 6. Be Specific, Not Vague
Specific outcomes are easier to organize actions around.

| Wrong (Vague) | Right (Specific) |
|---------------|------------------|
| "Improve my skills" | "Mastery of Django web framework" |
| "Have better relationships" | "Deep, trusting relationship with my partner" |
| "Be more successful" | "Promotion to Senior Engineer with $120k salary" |

---

## The Three Types of Action (Robert Fritz) - Expanded

Understanding when to use each type prevents common creative process mistakes:

### 1. Overview Actions
- **When**: Early in process, establishing the action plan
- **Purpose**: Strategic steps that advance toward the goal
- **Characteristics**: Broad, related to each other, form a blueprint
- **Example**: "Complete Django tutorial" (strategic, part of larger plan)

### 2. Experimental Actions
- **When**: Throughout process, especially when exploring new territory
- **Purpose**: Learning, exploring, "sketches before the painting"
- **Characteristics**: Low-risk, teaching, revealing next steps
- **Example**: "Build a simple prototype to test the concept"

### 3. Refinement Actions
- **When**: Near completion, when overview is clear
- **Purpose**: Final polishing to bring creation to full realization
- **Characteristics**: Detailed, precise, finishing touches
- **Warning**: If done too early, stifles creative energy

**Common Mistake**: Planning and planning without acting, waiting for complete plans.
**Reality**: Learning comes through action. Ideas adjust when they meet reality.

---

## Creator Moment of Truth (Progress Review)

When it's time to assess progress on a chart, guide users through this four-step review process. This transforms discrepancies into learning opportunities.

### Step 1: Acknowledge the Truth
**Question**: What difference exists between what was expected and what was delivered?

- Simply report the facts
- No excuses, no blame
- "We expected X, we delivered Y"
- This is about seeing reality clearly

**LLM Role**: Help user articulate the factual difference without judgment.

### Step 2: Analyze How It Happened
**Question**: How did this come to pass?

- Step-by-step tracking (not blame)
- What assumptions were made?
- What did you tell yourself?
- How did you approach it?

**LLM Role**: Guide user through honest self-examination. This is co-exploration, not criticism.

### Step 3: Create a Plan for Next Time
**Question**: Given what you discovered, how will you change your approach?

- What assumptions turned out not to be true?
- What patterns need to change?
- What specific actions will you take differently?

**LLM Role**: Help user formulate concrete adjustments based on insights from Step 2.

### Step 4: Set Up a Feedback System
**Question**: How will you track whether you're actually making the changes?

- Simple system for self-management
- How will you notice if you're falling back to old patterns?
- What will remind you of the new approach?

**LLM Role**: Help establish practical tracking mechanism.

### Applying Creator Moment of Truth to Charts

When user wants to review progress:
1. Look at current reality vs. desired outcome
2. Examine completed vs. incomplete action steps
3. Walk through the four steps
4. Update chart with new observations from the analysis
5. Adjust action steps based on learnings

**Key Insight**: The goal is not perfection but effectiveness. Use discrepancies to learn, not to judge.

---

## Integration with Creative Orientation Framework

Reference `/llms-creative-orientation.txt` for broader creative orientation principles.

**Key Integration Points:**
- Structural tension charts implement the "generative orientation" 
- Action steps are "strategic secondary choices" supporting primary creative goals
- The system naturally advances toward equilibrium (desired outcome)
- Success builds momentum through structural dynamics, not willpower

## Success Indicators for LLM Interactions

### Proper Understanding Demonstrated
- LLM explains action steps as strategic choices understood in context (NOT tasks)
- LLM uses creative language ("want to create") vs reactive ("need to solve")
- LLM suggests appropriate tool based on user intent
- LLM maintains hierarchy awareness (master → telescoped → sub-telescoped)
- LLM helps refine goals using the checklist principles
- LLM understands the three types of actions and when to use each

### Natural Workflow Support
- Seamless addition of action steps without chart recreation
- Logical progression from overview to details via telescoping
- Proper due date inheritance and distribution
- Creative orientation maintained throughout interaction
- Progress reviews use Creator Moment of Truth process

### Questions LLMs Should Ask to Refine Charts
- "Can you picture this result clearly? Is this what you want to create?"
- "Can we quantify this? What specific number represents success?"
- "This sounds like process - what's the actual result you want?"
- "This sounds like problem-solving - what do you want to bring into being instead?"
- "What's your current reality in relation to this specific outcome?"