---
name: Reflection Injection
slug: reflection-injection
category: AI Engineering
description: "Reflection Injection loads relevant past reflections into an agent's context at the start of an iteration or retry. Use it to carry forward lessons from prior failures and avoid repeating mistakes."
github: "https://github.com/jmagly/aiwg/tree/main/agentic/code/addons/agent-loop/skills/reflection-injection"
language: TypeScript
stars: 209
forks: 32
install: "npx degit https://github.com/jmagly/aiwg/tree/main/agentic/code/addons/agent-loop/skills/reflection-injection ~/.claude/skills/reflection-injection"
installs_to: ~/.claude/skills/reflection-injection
source_path: agentic/code/addons/agent-loop/skills/reflection-injection/SKILL.md
collection_size: 25
category_size: 2970
collection_url: "https://dirskills.com/collections/jmagly/aiwg"
added: 2026-09-04T05:27:02.135Z
last_synced: 2026-09-04T05:27:02.135Z
canonical_url: "https://dirskills.com/skills/reflection-injection"
---

# Reflection Injection

Reflection Injection loads relevant past reflections into an agent's context at the start of an iteration or retry. Use it to carry forward lessons from prior failures and avoid repeating mistakes.

**Install:**

```bash
npx degit https://github.com/jmagly/aiwg/tree/main/agentic/code/addons/agent-loop/skills/reflection-injection ~/.claude/skills/reflection-injection
```

## README

# reflection-injection

Automatically inject relevant past reflections into agent context when starting new iterations or retrying after failures.

## Triggers


Alternate expressions and non-obvious activations (primary phrases are matched automatically from the skill description):

- "inject reflection" → explicit reflection injection shorthand
- "add metacognition" → metacognitive step insertion

## Purpose

This skill implements the Reflexion episodic memory injection pattern. Before each iteration, it loads relevant past reflections and injects them into the agent's context, enabling learning from past mistakes without repeating them.

## Behavior

When triggered, this skill:

1. **Load reflection history**:
   - Read `.aiwg/ralph/reflections/loops/` for current loop reflections
   - Read `.aiwg/ralph/reflections/patterns/` for cross-loop patterns
   - Apply sliding window: k=5 most recent reflections

2. **Filter for relevance**:
   - Match reflections by task type similarity
   - Match by error type if retrying after failure
   - Match by file/module if working on specific code

3. **Format for injection**:
   - Convert reflections to natural language summary
   - Use @$AIWG_ROOT/agentic/code/addons/ralph/templates/self-reflection-prompt.md template
   - Prepend to agent context

4. **Track usage**:
   - Record which reflections were injected
   - Track whether injected reflections led to success
   - Update pattern effectiveness scores

## Activation Conditions

```yaml
activation:
  always_active_for:
    - ralph-loop-orchestrator
    - ralph-verifier

  triggered_by:
    - ralph_iteration_start
    - agent_retry_after_failure
    - explicit_user_request

  skip_when:
    - no_reflection_history: true
    - first_iteration_of_first_loop: true
```

## Integration

This skill uses:
- `project-awareness`: Context for relevance filtering
- Agent Loop Orchestrator: Provides iteration state
- Reflection memory at `.aiwg/ralph/reflections/`

## References

- @$AIWG_ROOT/agentic/code/addons/ralph/schemas/reflection-memory.json - Schema
- @$AIWG_ROOT/agentic/code/addons/ralph/docs/reflection-memory-guide.md - Guide
- @$AIWG_ROOT/agentic/code/addons/ralph/templates/self-reflection-prompt.md - Prompt template
- @.aiwg/research/findings/REF-021-reflexion.md - Research foundation

## Storage Routing (#934, #967)

This skill's persistence flows through `resolveStorage('reflections')`. On the default `fs` backend reflections live at `.aiwg/reflections/`. To redirect into Obsidian, Logseq, Fortemi, or another backend without changing this skill, configure `roots.reflections` or `backends.reflections` in `.aiwg/storage.config` (#934).

When this skill needs to read/write reflections from a Bash step, prefer the storage-routed CLI:

```bash
aiwg reflections list --prefix sessions/
aiwg reflections get sessions/2026-04-28.md
echo "# reflection" | aiwg reflections put sessions/2026-04-28.md
echo '{"event":"reflect","summary":"..."}' | aiwg reflections append-log sessions/log.jsonl
```

The legacy direct-fs paths continue to work on the default `fs` backend — byte-identical to what the adapter writes — but only the adapter route honors `storage.config` redirection.