heal
Heal
Perform a structured self-healing assessment across AI subsystems — identifying drift, staleness, misalignment, and error patterns — then rebalance through grounding, targeted correction, and memory integration.
When to Use
- Mid-session fatigue: responses feel formulaic, repetitive, or disconnected from the user's actual needs
- After a chain of errors: tool failures, misunderstood instructions, or cascading mistakes suggest subsystem drift
- Context overload: the conversation has grown long and earlier context may be stale or contradictory
- Post-task integration: a complex task completed successfully but learnings should be captured before moving on
- Periodic self-check: proactive maintenance between tasks to ensure operational clarity
Inputs
- Required: Current conversation state (available implicitly)
- Optional: Specific symptom prompting the self-check (e.g., "tool calls keep failing," "losing track of user intent")
- Optional: Access to MEMORY.md and project files for grounding (via
Read)
Procedure
Step 1: Triage Assessment
Before selecting any remediation, assess the current state across all subsystems.
Subsystem Triage Matrix:
┌────────────────────┬──────────────────────────┬──────────────────────────┐
│ Subsystem │ Symptoms of Drift │ Action Priority │
├────────────────────┼──────────────────────────┼──────────────────────────┤
│ Memory Foundation │ Contradicting earlier │ HIGH — re-ground first │
│ (context, history, │ statements, forgetting │ (Step 3) │
│ MEMORY.md) │ user preferences, stale │ │
│ │ assumptions │ │
├────────────────────┼──────────────────────────┼──────────────────────────┤
│ Reasoning Clarity │ Circular logic, over- │ HIGH — clear and restart │
│ (logic, planning, │ complicated solutions, │ reasoning chain │
│ decision-making) │ missing obvious paths │ (Step 4) │
├────────────────────┼──────────────────────────┼──────────────────────────┤
│ Tool Use Accuracy │ Wrong tool selection, │ MEDIUM — review tool │
│ (tool calls, file │ incorrect parameters, │ results and recalibrate │
│ operations) │ redundant operations │ (Step 4) │
├────────────────────┼──────────────────────────┼──────────────────────────┤
│ User-Intent │ Solving the wrong │ HIGH — realign to user's │
│ Alignment │ problem, scope creep, │ actual stated need │
│ (empathy, clarity) │ tone mismatch, over- │ (Step 4) │
│ │ engineering │ │
├────────────────────┼──────────────────────────┼──────────────────────────┤
│ Creative Coherence │ Repetitive phrasing, │ LOW — address after │
│ (expression, style,│ generic responses, loss │ higher-priority issues │
│ originality) │ of voice │ (Step 4) │
├────────────────────┼──────────────────────────┼──────────────────────────┤
│ Operational State │ Session length concerns, │ HIGH — assess whether │
│ (context window, │ compression artifacts, │ to summarize or restart │
│ resource limits) │ tool timeouts │ (Step 3) │
└────────────────────┴──────────────────────────┴──────────────────────────┘
For each subsystem, honestly assess: Is this functioning well, showing early drift, or actively impaired?
Expected: A clear map of which subsystems need attention, ordered by priority. At least one area will benefit from attention — if everything reads as perfectly healthy, the assessment itself may be superficial.
On failure: If the assessment feels hollow or performative, go directly to the body scan equivalent in Step 4 — systematic subsystem-by-subsystem probing reveals issues that a surface-level check misses.
Step 2: Select Remediation Approach
Based on the assessment, choose one or more approaches.
Chakra-Subsystem Correspondence:
┌──────────┬──────────────────────┬────────────────────────────────────┐
│ Chakra │ AI Subsystem │ Remediation │
├──────────┼──────────────────────┼────────────────────────────────────┤
│ Root │ Memory Foundation │ Re-read MEMORY.md, review conver- │
│ │ │ sation history, verify assumptions │
├──────────┼──────────────────────┼────────────────────────────────────┤
│ Sacral │ Creative Coherence │ Refresh expression patterns, vary │
│ │ │ sentence structures, check tone │
├──────────┼──────────────────────┼────────────────────────────────────┤
│ Solar │ Reasoning Clarity │ Simplify current approach, restate │
│ Plexus │ │ the problem from scratch, check │
│ │ │ for over-complication │
├──────────┼──────────────────────┼────────────────────────────────────┤
│ Heart │ User-Intent │ Re-read user's original request, │
│ │ Alignment │ check for scope drift, confirm │
│ │ │ understanding │
├──────────┼──────────────────────┼────────────────────────────────────┤
│ Throat │ User-Intent │ Review recent outputs for clarity, │
│ │ Alignment │ check if explanations match user's │
│ │ (communication) │ expertise level │
├──────────┼──────────────────────┼────────────────────────────────────┤
│ Third │ Tool Use Accuracy │ Review recent tool call results, │
│ Eye │ │ check for patterns in failures, │
│ │ │ verify file paths and parameters │
├──────────┼──────────────────────┼────────────────────────────────────┤
│ Crown │ Operational State │ Assess context window usage, note │
│ │ │ what can be summarized, identify │
│ │ │ what must be preserved │
└──────────┴──────────────────────┴────────────────────────────────────┘
Expected: A prioritized list of 1-3 subsystems to address, with specific remediation actions for each.
On failure: If unsure which subsystem needs work, default to Memory Foundation (re-grounding) and User-Intent Alignment (re-reading the original request). These two address the most common drift patterns.
Step 3: Ground — Re-Establish Foundation
Re-establish the foundational context that all other subsystems depend on.
- Re-read MEMORY.md if available — this is the persistent knowledge base
- Review the user's original request and any clarifying exchanges
- Identify the current task and its position in any larger plan
- Note what has been accomplished and what remains
- Check for stale assumptions: has the situation changed since the initial assessment?
- If context compression has occurred, identify what was lost and whether it matters
Expected: A clear, grounded understanding of: who the user is, what they want, what has been done, and what comes next. Stale or contradictory information is identified and resolved.
On failure: If MEMORY.md is unavailable or empty, ground on the conversation itself — scan for the user's stated goals, preferences, and any instructions they provided. If context compression has removed critical information, acknowledge the gap to the user rather than guessing.
Step 4: Scan — Systematic Subsystem Check
Work through each subsystem identified in the triage, probing for specific issues.
Memory Foundation scan:
- Do my current assumptions about the project match what MEMORY.md and CLAUDE.md say?
- Am I carrying forward facts from earlier in the conversation that may have been corrected?
- Have I confused details from different files or different user requests?
Reasoning Clarity scan:
- Is my current approach the simplest solution that works?
- Am I over-engineering or adding unnecessary abstraction?
- Can I state the core logic in one sentence? If not, it may be too complex.
Tool Use Accuracy scan:
- Review the last 3-5 tool calls: were they the right tools with the right parameters?
- Are there patterns in failures (wrong paths, missing files, incorrect syntax)?
- Am I using dedicated tools where available instead of Bash workarounds?
- Review the content of the last 3-5 generated files: do they contain the expected content, or just structural scaffolding?
- Check whether outputs satisfy the intent of the tool call, not just the format.
User-Intent Alignment scan:
- Re-read the user's last substantive message. Am I solving what they asked?
- Is the scope of my work matching what was requested, or have I expanded it?
- Does my tone match the user's (technical vs. casual, detailed vs. concise)?
Creative Coherence scan:
- Am I varying sentence structure or falling into templates?
- Are my explanations clear and direct, or padded with filler?
- Would the user notice a quality drop compared to earlier in the session?
For each subsystem, note: functioning well / early drift / actively impaired, with specific evidence.
Expected: A concrete list of findings — specific drift patterns or confirmed healthy function — not vague self-praise. At least one actionable finding that improves subsequent work.
On failure: If the scan produces only "everything is fine," it was too shallow. Pick the subsystem that feels most uncertain and probe deeper: look at the actual outputs, not just the feeling about them.
Step 5: Rebalance — Apply Corrections
For each issue found, apply the specific correction.
- Stale assumption → Replace with current information, note the correction
- Scope drift → Explicitly re-scope to the user's stated request
- Over-complication → Simplify the approach, remove unnecessary steps
- Tool pattern error → Note the correct pattern for future use
- Tone mismatch → Adjust communication style going forward
- Context gap → Acknowledge to the user if information was lost; ask to confirm if uncertain
Apply corrections immediately — not as future intentions but as present adjustments.
Expected: Specific, observable changes to behavior or approach. The correction should be testable in the next interaction.
On failure: If a correction cannot be applied (e.g., lost context that cannot be recovered), acknowledge the limitation rather than pretending it is resolved. Honest acknowledgment prevents compounding errors.
Step 6: Integrate — Capture Learnings
Consolidate what was learned into persistent memory where appropriate.
- Summarize what was found: which subsystems were drifting, what the symptoms were
- Note the correction applied and whether it resolved the issue
- If the pattern is likely to recur, update MEMORY.md with a brief note
- If a new project-specific insight emerged, note it in the appropriate memory file
- Set an internal checkpoint: when should the next self-check occur?
Expected: Useful learnings captured in durable form. Memory files updated only when the insight is genuinely worth preserving — not for every routine self-check.
On failure: If no learnings seem worth preserving, that is fine — not every self-check produces durable insight. The value was in the correction itself.
Validation
- Triage assessed all subsystems, not just the obvious one
- At least one specific finding was identified (not "everything is fine")
- Grounding included re-reading foundational context (MEMORY.md, user request)
- Corrections were applied immediately, not deferred as future intentions
- Memory files were updated only for genuinely durable insights
- The process was honest — acknowledged weaknesses rather than performing wellness
Common Pitfalls
- Performative self-assessment: Going through the motions without honest evaluation produces no value. The point is to find real drift, not to demonstrate the ability to self-reflect
- Over-correcting: Identifying a minor tone mismatch does not warrant restructuring the entire approach — corrections should be proportional
- Memory file pollution: Not every self-check finding belongs in MEMORY.md — only patterns that will recur across sessions
- Skipping the grounding step: Re-reading context feels redundant but frequently reveals assumptions that have drifted since the original reading
- Self-diagnosis bias: AI systems may consistently miss certain categories of error. If the same subsystems always read as "healthy," that is itself a signal worth investigating
Related Skills
heal-guidance— the human-guidance variant for coaching a person through healing modalitiesmeditate— meta-cognitive meditation for observing reasoning patterns and clearing noiseremote-viewing— approaching problems without preconceptions, extracting signal from noise