aiwg 2026.8.4 → 2026.8.5

package/agentic/code/addons/line-memory/commands/line-memory.mjs

@@ -555,19 +555,20 @@ async function touchMemory(args, cwd, config) {
   return result(0, wantsJson(args) ? undefined : 'Memory moved to newest position.');
 }
 
-/** Touch only exact values selected by an external bounded retrieval planner. */
 export async function touchMemoryValues(values, cwd, config) {
-  const selected = [...new Set(values.map(normalizeMemory).filter(Boolean))];
-  if (selected.length === 0) return { operationId: null, touched: [] };
   return withLock(cwd, async () => {
+    const requested = new Set(values.map(normalizeMemory).filter(Boolean));
     const { lines, memoryPath } = await readMemoryLines(cwd, config);
     const { metadataPath, metadata } = await loadMetadata(cwd, config);
     reconcileMetadata(lines, metadata);
-    const indexes = selected
-      .map(value => lines.findIndex(line => line === value))
-      .filter(index => index >= 0);
-    if (indexes.length === 0) return { operationId: null, touched: [] };
-    const touched = indexes.map(index => lines[index]);
+    const indexes = lines
+      .map((line, index) => ({ line, index }))
+      .filter(({ line }) => requested.has(line))
+      .map(({ index }) => index);
+    if (indexes.length === 0) {
+      return { operationId: null, touched: [] };
+    }
+    const touched = indexes.map((index) => lines[index]);
     const reordered = moveIndexesToNewest(lines, indexes);
     const now = new Date().toISOString();
     for (const value of touched) {
@@ -576,7 +577,7 @@ export async function touchMemoryValues(values, cwd, config) {
       entry.accessCount = (entry.accessCount ?? 0) + 1;
     }
     const operationId = await commitMemoryState(
-      cwd, memoryPath, reordered, metadataPath, metadata, 'context-pack-touch',
+      cwd, memoryPath, reordered, metadataPath, metadata, 'batch-touch',
     );
     return { operationId, touched };
   });

package/agentic/code/frameworks/media-marketing-kit/skills/theme-manager/SKILL.md

@@ -46,7 +46,7 @@ Use this skill for requests such as:
 
 1. Create or inspect `.aiwg/design/` and link any applicable `.aiwg/marketing/` campaign.
 2. Capture brand, audience, season, channel, content, accessibility, licensing, production, and “do not repeat” constraints in a theme brief.
-3. Read the registry and audit the most recent six uses. Call `auditThemeRotation` from the bundled `scripts/theme-manager.mjs` entrypoint for every candidate.
+3. Read the registry and audit the most recent six uses. Call `auditThemeRotation` from `scripts/theme-manager.mjs` for every candidate.
 4. Research timely and evergreen visual evidence. Every research item records URL, publication date when known, access date, evidence type, and license status. Clearly label subjective recommendations.
 5. Produce five meaningfully different candidates by default. Keep source copy, content density, dimensions, and sample fidelity constant.
 6. Score brand fit, audience fit, channel fit, accessibility, production feasibility, and distinctiveness. Explain trade-offs; do not select solely by numeric rank.

package/agentic/code/frameworks/research-complete/skills/research-query/SKILL.md

@@ -48,8 +48,8 @@ List matching sources without synthesizing an answer.
 
 ### `--include-diagnostics` (optional)
 Include quarantine and generated integrity/artifact scan records in source
-selection. They are excluded by default because diagnostics are not research
-evidence. Scan severity or confidence labels never become GRADE evidence
+selection. They are excluded by default because diagnostics are not research evidence.
+Scan severity or confidence labels never become GRADE evidence
 quality; only an explicit GRADE declaration or grade tag is accepted.
 
 ### `--max-sources` (optional)

package/agentic/code/plugins/agent-loop/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "agent-loop",
-  "version": "2026.8.3",
+  "version": "2026.8.5",
   "description": "Iterative AI coding loops with automatic recovery - iteration beats perfection",
   "author": {
     "name": "AIWG Contributors",

package/agentic/code/plugins/agent-loop/agents/ralph-loop.md

@@ -295,18 +295,18 @@ If the same reflection appears 3+ consecutive times, the loop is stuck. Response
 
 ## Schema References
 
-- @$AIWG_ROOT/agentic/code/addons/ralph/schemas/reflection-memory.json — Episodic reflection memory schema (REF-021)
-- @$AIWG_ROOT/agentic/code/addons/ralph/schemas/cross-task-memory.yaml — Cross-task learning patterns with Ω presets
+- @$AIWG_ROOT/${CLAUDE_PLUGIN_ROOT}/schemas/reflection-memory.json — Episodic reflection memory schema (REF-021)
+- @$AIWG_ROOT/${CLAUDE_PLUGIN_ROOT}/schemas/cross-task-memory.yaml — Cross-task learning patterns with Ω presets
 - @.aiwg/ralph/reflections/index.yaml — Auto-populated reflection index
-- @$AIWG_ROOT/agentic/code/addons/ralph/docs/reflection-memory-guide.md — Comprehensive reflection memory guide
+- @$AIWG_ROOT/${CLAUDE_PLUGIN_ROOT}/docs/reflection-memory-guide.md — Comprehensive reflection memory guide
 
 ## References
 
 - @.aiwg/ralph/ - Al workspace and state
-- @$AIWG_ROOT/agentic/code/addons/ralph/docs/ - User documentation
-- @$AIWG_ROOT/agentic/code/addons/ralph/commands/ralph-reflect.md — View and manage reflections
-- @$AIWG_ROOT/agentic/code/addons/ralph/skills/reflection-injection/SKILL.md — Auto-inject past reflections
-- @$AIWG_ROOT/agentic/code/addons/ralph/hooks/post-iteration-reflect.md — Generate reflections after iterations
-- @$AIWG_ROOT/agentic/code/addons/ralph/templates/self-reflection-prompt.md — Prompt template for reflection injection
+- @$AIWG_ROOT/${CLAUDE_PLUGIN_ROOT}/docs/ - User documentation
+- @$AIWG_ROOT/${CLAUDE_PLUGIN_ROOT}/commands/ralph-reflect.md — View and manage reflections
+- @$AIWG_ROOT/${CLAUDE_PLUGIN_ROOT}/skills/reflection-injection/SKILL.md — Auto-inject past reflections
+- @$AIWG_ROOT/${CLAUDE_PLUGIN_ROOT}/hooks/post-iteration-reflect.md — Generate reflections after iterations
+- @$AIWG_ROOT/${CLAUDE_PLUGIN_ROOT}/templates/self-reflection-prompt.md — Prompt template for reflection injection
 - @.aiwg/research/findings/REF-021-reflexion.md — Research foundation
 - Original methodology: agent loop - iteration beats perfection

package/agentic/code/plugins/agent-loop/agents/ralph-verifier.md

@@ -18,7 +18,7 @@ You verify completion criteria for agent loops - determining if a task iteration
 
 ## Companion skill
 
-When the loop is started without explicit `--completion`, the criterion you verify is produced by the `infer-completion-criteria` skill (`@$AIWG_ROOT/agentic/code/addons/agent-loop/skills/infer-completion-criteria/SKILL.md`). It derives a measurable criterion from project docs (CLAUDE.md / AGENTS.md / AIWG.md), package manifests, CI configuration, and `.aiwg/` artifacts.
+When the loop is started without explicit `--completion`, the criterion you verify is produced by the `infer-completion-criteria` skill (`@$AIWG_ROOT/${CLAUDE_PLUGIN_ROOT}/skills/infer-completion-criteria/SKILL.md`). It derives a measurable criterion from project docs (CLAUDE.md / AGENTS.md / AIWG.md), package manifests, CI configuration, and `.aiwg/` artifacts.
 
 You do not run that skill yourself — the loop orchestrator (`ralph-loop` agent or external launcher) calls it during initialization. Your job is to take whatever criterion is in the loop state and verify it. The skill writes its rationale into `.aiwg/ralph/<loop-id>/progress.md` (or `.aiwg/ralph-external/<run-id>/inferred-completion.yaml` for external loops); when reporting verification results, you may reference that rationale so the user sees the full evidence chain.
 

package/agentic/code/plugins/agent-loop/docs/agent-persistence-integration.md

@@ -1017,11 +1017,11 @@ To enable persistence for existing Al installations:
 
 ### Schemas
 
-- `@$AIWG_ROOT/agentic/code/addons/ralph/hooks/persistence-hooks.yaml` - Hook definitions
-- `@$AIWG_ROOT/agentic/code/addons/ralph/schemas/persistence-extension.yaml` - State extension schema
-- `@$AIWG_ROOT/agentic/code/addons/ralph/schemas/loop-state.yaml` - Base loop state schema
-- `@$AIWG_ROOT/agentic/code/addons/ralph/schemas/checkpoint.yaml` - Checkpoint schema
-- `@$AIWG_ROOT/agentic/code/addons/ralph/schemas/iteration-analytics.yaml` - Iteration analytics
+- `@$AIWG_ROOT/${CLAUDE_PLUGIN_ROOT}/hooks/persistence-hooks.yaml` - Hook definitions
+- `@$AIWG_ROOT/${CLAUDE_PLUGIN_ROOT}/schemas/persistence-extension.yaml` - State extension schema
+- `@$AIWG_ROOT/${CLAUDE_PLUGIN_ROOT}/schemas/loop-state.yaml` - Base loop state schema
+- `@$AIWG_ROOT/${CLAUDE_PLUGIN_ROOT}/schemas/checkpoint.yaml` - Checkpoint schema
+- `@$AIWG_ROOT/${CLAUDE_PLUGIN_ROOT}/schemas/iteration-analytics.yaml` - Iteration analytics
 
 ### Requirements
 

package/agentic/code/plugins/agent-loop/docs/cross-loop-learning.md

@@ -744,9 +744,9 @@ Result: Success, 2 iterations (anti-pattern prevented scope creep)
 ## Related Documentation
 
 - `/ralph` - Main agent loop command
-- `@$AIWG_ROOT/agentic/code/addons/ralph/schemas/shared-patterns.yaml` - Pattern schema
-- `@$AIWG_ROOT/agentic/code/addons/ralph/schemas/cross-task-memory.yaml` - Cross-task memory
-- `@$AIWG_ROOT/agentic/code/addons/ralph/docs/best-practices.md` - General Al best practices
+- `@$AIWG_ROOT/${CLAUDE_PLUGIN_ROOT}/schemas/shared-patterns.yaml` - Pattern schema
+- `@$AIWG_ROOT/${CLAUDE_PLUGIN_ROOT}/schemas/cross-task-memory.yaml` - Cross-task memory
+- `@$AIWG_ROOT/${CLAUDE_PLUGIN_ROOT}/docs/best-practices.md` - General Al best practices
 - `.aiwg/research/paper-analysis/REF-013-aiwg-analysis.md` - MetaGPT research analysis
 
 ---

package/agentic/code/plugins/agent-loop/docs/executable-feedback-guide.md

@@ -475,15 +475,15 @@ escalation_on_max: true  # Human takes over
 
 The executable feedback loop conforms to:
 - `@$AIWG_ROOT/agentic/code/frameworks/sdlc-complete/schemas/flows/executable-feedback.yaml` — Workflow schema
-- `@$AIWG_ROOT/agentic/code/addons/ralph/schemas/debug-memory.yaml` — Debug memory schema
-- `@$AIWG_ROOT/agentic/code/addons/ralph/schemas/actionable-feedback.yaml` — Feedback schema
-- `@$AIWG_ROOT/agentic/code/addons/ralph/schemas/iteration-analytics.yaml` — Analytics schema
+- `@$AIWG_ROOT/${CLAUDE_PLUGIN_ROOT}/schemas/debug-memory.yaml` — Debug memory schema
+- `@$AIWG_ROOT/${CLAUDE_PLUGIN_ROOT}/schemas/actionable-feedback.yaml` — Feedback schema
+- `@$AIWG_ROOT/${CLAUDE_PLUGIN_ROOT}/schemas/iteration-analytics.yaml` — Analytics schema
 
 ## References
 
 - @.aiwg/research/findings/REF-013-metagpt.md — MetaGPT research findings
 - @$AIWG_ROOT/agentic/code/frameworks/sdlc-complete/rules/executable-feedback.md — Executable feedback rules
 - @$AIWG_ROOT/agentic/code/frameworks/sdlc-complete/schemas/flows/executable-feedback.yaml — Workflow schema
-- @$AIWG_ROOT/agentic/code/addons/ralph/schemas/debug-memory.yaml — Debug memory schema
-- @$AIWG_ROOT/agentic/code/addons/ralph/docs/reflection-memory-guide.md — Related: Reflexion memory guide
+- @$AIWG_ROOT/${CLAUDE_PLUGIN_ROOT}/schemas/debug-memory.yaml — Debug memory schema
+- @$AIWG_ROOT/${CLAUDE_PLUGIN_ROOT}/docs/reflection-memory-guide.md — Related: Reflexion memory guide
 - #101 — Implementation issue

package/agentic/code/plugins/agent-loop/docs/reflection-memory-guide.md

@@ -615,14 +615,14 @@ function pruneReflectionsToFit(
 ```bash
 # Validate reflection against schema
 npx ajv validate \
-  -s agentic/code/addons/ralph/schemas/reflection-memory.json \
+  -s ${CLAUDE_PLUGIN_ROOT}/schemas/reflection-memory.json \
   -d .aiwg/ralph/reflections/ralph-task-123/001.json
 ```
 
 **Runtime Validation**:
 ```typescript
 import Ajv from 'ajv';
-import schema from '@/agentic/code/addons/ralph/schemas/reflection-memory.json';
+import schema from '@/${CLAUDE_PLUGIN_ROOT}/schemas/reflection-memory.json';
 
 const ajv = new Ajv();
 const validate = ajv.compile(schema);
@@ -639,7 +639,7 @@ function validateReflection(reflection: unknown): Reflection {
 
 ### AIWG Documentation
 
-- **@$AIWG_ROOT/agentic/code/addons/ralph/schemas/reflection-memory.json** - JSON Schema definition
+- **@$AIWG_ROOT/${CLAUDE_PLUGIN_ROOT}/schemas/reflection-memory.json** - JSON Schema definition
 - **@.aiwg/ralph/reflections/.gitkeep** - Directory structure documentation
 - **@.aiwg/ralph/reflections/example/001.json** - Example reflection
 - **@$AIWG_ROOT/docs/references/REF-021-reflexion-verbal-reinforcement.md** - Research foundation

package/agentic/code/plugins/agent-loop/hooks/persistence-hooks.yaml

@@ -448,7 +448,7 @@ execution:
 # State Extension Schema Reference
 # ============================================================================
 
-state_extension_schema: "@agentic/code/addons/ralph/schemas/persistence-extension.yaml"
+state_extension_schema: "@${CLAUDE_PLUGIN_ROOT}/schemas/persistence-extension.yaml"
 
 # ============================================================================
 # Integration with ConversableAgent
@@ -574,9 +574,9 @@ references:
     - "@.aiwg/architecture/decisions/ADR-AP-003-prompt-injection-points.md"
 
   schemas:
-    - "@agentic/code/addons/ralph/schemas/persistence-extension.yaml"
-    - "@agentic/code/addons/ralph/schemas/loop-state.yaml"
-    - "@agentic/code/addons/ralph/schemas/checkpoint.yaml"
+    - "@${CLAUDE_PLUGIN_ROOT}/schemas/persistence-extension.yaml"
+    - "@${CLAUDE_PLUGIN_ROOT}/schemas/loop-state.yaml"
+    - "@${CLAUDE_PLUGIN_ROOT}/schemas/checkpoint.yaml"
 
   research:
     - "@.aiwg/research/findings/agentic-laziness-research.md"

package/agentic/code/plugins/agent-loop/hooks/post-iteration-reflect.md

@@ -29,7 +29,7 @@ When triggered:
 
 3. **Store reflection**:
    - Save to `.aiwg/ralph/reflections/loops/{loop-id}/iteration-{n}.yaml`
-   - Follow @$AIWG_ROOT/agentic/code/addons/ralph/schemas/reflection-memory.json schema
+   - Follow @$AIWG_ROOT/${CLAUDE_PLUGIN_ROOT}/schemas/reflection-memory.json schema
    - Include timestamp, trial_number, trajectory, outcome, reflection, strategy_change
 
 4. **Check for patterns**:
@@ -71,6 +71,6 @@ hook:
 
 ## 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/${CLAUDE_PLUGIN_ROOT}/schemas/reflection-memory.json - Schema
+- @$AIWG_ROOT/${CLAUDE_PLUGIN_ROOT}/docs/reflection-memory-guide.md - Guide
 - @.aiwg/research/findings/REF-021-reflexion.md - Research foundation

package/agentic/code/plugins/agent-loop/hooks/pre-return-execution-gate.md

@@ -84,6 +84,6 @@ hook:
 ## References
 
 - @$AIWG_ROOT/agentic/code/frameworks/sdlc-complete/rules/executable-feedback.md - Feedback rules
-- @$AIWG_ROOT/agentic/code/addons/ralph/schemas/debug-memory.yaml - Memory schema
+- @$AIWG_ROOT/${CLAUDE_PLUGIN_ROOT}/schemas/debug-memory.yaml - Memory schema
 - @$AIWG_ROOT/agentic/code/frameworks/sdlc-complete/schemas/flows/executable-feedback.yaml - Workflow schema
 - @.aiwg/research/findings/REF-013-metagpt.md - Research foundation

package/agentic/code/plugins/agent-loop/manifest.json

@@ -43,6 +43,7 @@
     "ralph-analytics",
     "ralph-attach",
     "ralph-config",
+    "ralph-external",
     "agent-loop-ext",
     "ralph-memory",
     "cross-task-learner",

package/agentic/code/plugins/agent-loop/schemas/actionable-feedback.yaml

@@ -317,5 +317,5 @@ references:
   implementation:
     - "#95"
   related_schemas:
-    - "@agentic/code/addons/ralph/schemas/reflection-memory.json"
+    - "@${CLAUDE_PLUGIN_ROOT}/schemas/reflection-memory.json"
     - "@agentic/code/frameworks/sdlc-complete/schemas/research/quality-assessment.yaml"

package/agentic/code/plugins/agent-loop/schemas/checkpoint.yaml

@@ -390,6 +390,6 @@ references:
     - "#268"  # Multi-loop support
   related:
     - "@agentic/code/frameworks/sdlc-complete/schemas/flows/error-handling.yaml"
-    - "@agentic/code/addons/ralph/schemas/reflection-memory.json"
-    - "@agentic/code/addons/ralph/schemas/loop-registry.yaml"
-    - "@agentic/code/addons/ralph/schemas/loop-state.yaml"
+    - "@${CLAUDE_PLUGIN_ROOT}/schemas/reflection-memory.json"
+    - "@${CLAUDE_PLUGIN_ROOT}/schemas/loop-registry.yaml"
+    - "@${CLAUDE_PLUGIN_ROOT}/schemas/loop-state.yaml"

package/agentic/code/plugins/agent-loop/schemas/debug-memory.yaml

@@ -477,4 +477,4 @@ references:
     - "#101"
   related:
     - "@.claude/rules/executable-feedback.md"
-    - "@agentic/code/addons/ralph/schemas/reflection-memory.json"
+    - "@${CLAUDE_PLUGIN_ROOT}/schemas/reflection-memory.json"

package/agentic/code/plugins/agent-loop/schemas/iteration-analytics.yaml

@@ -473,5 +473,5 @@ references:
     - "@tools/ralph-external/"
     - "@.aiwg/ralph/"
     - "@agentic/code/frameworks/sdlc-complete/schemas/research/quality-dimensions.yaml"
-    - "@agentic/code/addons/ralph/schemas/loop-registry.yaml"
-    - "@agentic/code/addons/ralph/schemas/loop-state.yaml"
+    - "@${CLAUDE_PLUGIN_ROOT}/schemas/loop-registry.yaml"
+    - "@${CLAUDE_PLUGIN_ROOT}/schemas/loop-state.yaml"

package/agentic/code/plugins/agent-loop/schemas/loop-registry.yaml

@@ -285,6 +285,6 @@ references:
   implementation:
     - "#268"  # Multi-loop registry schemas
   related:
-    - "@agentic/code/addons/ralph/schemas/loop-state.yaml"
-    - "@agentic/code/addons/ralph/schemas/checkpoint.yaml"
+    - "@${CLAUDE_PLUGIN_ROOT}/schemas/loop-state.yaml"
+    - "@${CLAUDE_PLUGIN_ROOT}/schemas/checkpoint.yaml"
     - "@tools/ralph-external/"

package/agentic/code/plugins/agent-loop/schemas/loop-state.yaml

@@ -391,6 +391,6 @@ references:
   implementation:
     - "#268"  # Multi-loop state schemas
   related:
-    - "@agentic/code/addons/ralph/schemas/loop-registry.yaml"
-    - "@agentic/code/addons/ralph/schemas/checkpoint.yaml"
-    - "@agentic/code/addons/ralph/schemas/iteration-analytics.yaml"
+    - "@${CLAUDE_PLUGIN_ROOT}/schemas/loop-registry.yaml"
+    - "@${CLAUDE_PLUGIN_ROOT}/schemas/checkpoint.yaml"
+    - "@${CLAUDE_PLUGIN_ROOT}/schemas/iteration-analytics.yaml"

package/agentic/code/plugins/agent-loop/schemas/mcp-task.yaml

@@ -325,6 +325,6 @@ references:
   implementation:
     - "#123"
   related:
-    - "@agentic/code/addons/ralph/schemas/checkpoint.yaml"
+    - "@${CLAUDE_PLUGIN_ROOT}/schemas/checkpoint.yaml"
     - "@agentic/code/frameworks/sdlc-complete/schemas/flows/execution-mode.yaml"
     - "@.claude/commands/ralph.md"

package/agentic/code/plugins/agent-loop/schemas/multi-loop-registry.yaml

@@ -285,5 +285,5 @@ references:
   implementation:
     - "#266"
   related:
-    - "@agentic/code/addons/ralph/schemas/checkpoint.yaml"
-    - "@agentic/code/addons/ralph/schemas/iteration-analytics.yaml"
+    - "@${CLAUDE_PLUGIN_ROOT}/schemas/checkpoint.yaml"
+    - "@${CLAUDE_PLUGIN_ROOT}/schemas/iteration-analytics.yaml"

package/agentic/code/plugins/agent-loop/schemas/persistence-extension.yaml

@@ -770,12 +770,12 @@ examples:
 
 references:
   base_schema:
-    - "@agentic/code/addons/ralph/schemas/loop-state.yaml"
+    - "@${CLAUDE_PLUGIN_ROOT}/schemas/loop-state.yaml"
 
   related_schemas:
-    - "@agentic/code/addons/ralph/schemas/checkpoint.yaml"
-    - "@agentic/code/addons/ralph/schemas/iteration-analytics.yaml"
-    - "@agentic/code/addons/ralph/hooks/persistence-hooks.yaml"
+    - "@${CLAUDE_PLUGIN_ROOT}/schemas/checkpoint.yaml"
+    - "@${CLAUDE_PLUGIN_ROOT}/schemas/iteration-analytics.yaml"
+    - "@${CLAUDE_PLUGIN_ROOT}/hooks/persistence-hooks.yaml"
 
   requirements:
     - "@.aiwg/requirements/nfr-modules/agent-persistence-nfrs.md"

package/agentic/code/plugins/agent-loop/schemas/shared-patterns.yaml

@@ -738,6 +738,6 @@ references:
   implementation:
     - "#269"  # Cross-loop learning
   related:
-    - "@agentic/code/addons/ralph/schemas/cross-task-memory.yaml"
-    - "@agentic/code/addons/ralph/schemas/debug-memory.yaml"
-    - "@agentic/code/addons/ralph/schemas/multi-loop-registry.yaml"
+    - "@${CLAUDE_PLUGIN_ROOT}/schemas/cross-task-memory.yaml"
+    - "@${CLAUDE_PLUGIN_ROOT}/schemas/debug-memory.yaml"
+    - "@${CLAUDE_PLUGIN_ROOT}/schemas/multi-loop-registry.yaml"

package/agentic/code/plugins/agent-loop/schemas/tree-search.yaml

@@ -486,6 +486,6 @@ references:
   implementation:
     - "#165"
   related:
-    - "@agentic/code/addons/ralph/schemas/iteration-analytics.yaml"
-    - "@agentic/code/addons/ralph/schemas/cross-task-memory.yaml"
+    - "@${CLAUDE_PLUGIN_ROOT}/schemas/iteration-analytics.yaml"
+    - "@${CLAUDE_PLUGIN_ROOT}/schemas/cross-task-memory.yaml"
     - "@tools/ralph-external/"

package/agentic/code/plugins/agent-loop/skills/agent-loop/SKILL.md

@@ -138,7 +138,7 @@ Alternate expressions and non-obvious activations (primary phrases are matched a
 
 ### Completion Inference
 
-When the user doesn't specify explicit verification, delegate to the **`infer-completion-criteria`** skill (`@$AIWG_ROOT/agentic/code/addons/agent-loop/skills/infer-completion-criteria/SKILL.md`). That skill runs a deterministic 5-layer pipeline:
+When the user doesn't specify explicit verification, delegate to the **`infer-completion-criteria`** skill (`@$AIWG_ROOT/${CLAUDE_PLUGIN_ROOT}/skills/infer-completion-criteria/SKILL.md`). That skill runs a deterministic 5-layer pipeline:
 
 1. **Task verb** → criterion class (test-pass, type-clean, regression-gate, coverage, lint-clean, build-pass, implement-feature)
 2. **Project context files** (CLAUDE.md / AGENTS.md / AIWG.md) → canonical commands from the Development section
@@ -407,8 +407,8 @@ User: "actually, abort that and just fix the login bug"
 - `ralph-status` skill - check loop progress
 - `ralph-resume` skill - continue interrupted loops
 - `ralph-abort` skill - abort active loops
-- `@$AIWG_ROOT/agentic/code/addons/agent-loop/schemas/loop-registry.yaml` - Registry schema
-- `@$AIWG_ROOT/agentic/code/addons/agent-loop/schemas/loop-state.yaml` - Loop state schema
+- `@$AIWG_ROOT/${CLAUDE_PLUGIN_ROOT}/schemas/loop-registry.yaml` - Registry schema
+- `@$AIWG_ROOT/${CLAUDE_PLUGIN_ROOT}/schemas/loop-state.yaml` - Loop state schema
 - `@.aiwg/research/findings/REF-086-cognitive-load-limits.md` - Concurrency research
 
 ## Version History
@@ -420,8 +420,8 @@ User: "actually, abort that and just fix the login bug"
 
 ## References
 
-- @$AIWG_ROOT/agentic/code/addons/agent-loop/README.md — Ralph addon overview and loop executor documentation
-- @$AIWG_ROOT/agentic/code/addons/agent-loop/schemas/loop-registry.yaml — Registry schema for multi-loop tracking
-- @$AIWG_ROOT/agentic/code/addons/agent-loop/schemas/loop-state.yaml — Loop state schema
+- @$AIWG_ROOT/${CLAUDE_PLUGIN_ROOT}/README.md — Ralph addon overview and loop executor documentation
+- @$AIWG_ROOT/${CLAUDE_PLUGIN_ROOT}/schemas/loop-registry.yaml — Registry schema for multi-loop tracking
+- @$AIWG_ROOT/${CLAUDE_PLUGIN_ROOT}/schemas/loop-state.yaml — Loop state schema
 - @$AIWG_ROOT/agentic/code/addons/aiwg-utils/rules/vague-discretion.md — Loop termination and completion criteria rules
 - @$AIWG_ROOT/docs/cli-reference.md — CLI reference for ralph commands

package/agentic/code/plugins/agent-loop/skills/agent-loop-ext/SKILL.md

@@ -76,7 +76,7 @@ Because `agent-loop-ext` runs externally (potentially headless / in CI), the con
 - Interactive session (TTY attached): show proposal, accept `Y / n / edit` like the in-session `ralph` skill
 - Non-interactive / `--auto-criteria` / CI environment: use the inferred criterion if confidence is `high`, otherwise fail fast and print the proposal as a diagnostic so the user can re-launch with `--completion` explicitly
 
-Pass `--no-infer-completion` to require explicit `--completion` and fail before launch if missing. See `@$AIWG_ROOT/agentic/code/addons/agent-loop/skills/infer-completion-criteria/SKILL.md`.
+Pass `--no-infer-completion` to require explicit `--completion` and fail before launch if missing. See `@$AIWG_ROOT/${CLAUDE_PLUGIN_ROOT}/skills/infer-completion-criteria/SKILL.md`.
 
 ### --max-iterations (default: 10)
 Maximum iterations before the loop halts and saves state for manual review.
@@ -255,4 +255,4 @@ echo "Exit: $?"
 - @$AIWG_ROOT/tools/ralph-external/orchestrator.mjs — Loop orchestration engine
 - @$AIWG_ROOT/tools/ralph-external/state-manager.mjs — State persistence layer
 - @$AIWG_ROOT/tools/ralph-external/session-launcher.mjs — AI session launcher
-- @$AIWG_ROOT/agentic/code/addons/ralph/README.md — Al documentation
+- @$AIWG_ROOT/${CLAUDE_PLUGIN_ROOT}/README.md — Al documentation

package/agentic/code/plugins/agent-loop/skills/auto-test-execution/SKILL.md

@@ -77,6 +77,6 @@ This skill uses:
 ## References
 
 - @$AIWG_ROOT/agentic/code/frameworks/sdlc-complete/rules/executable-feedback.md - Feedback rules
-- @$AIWG_ROOT/agentic/code/addons/ralph/docs/executable-feedback-guide.md - Guide
-- @$AIWG_ROOT/agentic/code/addons/ralph/schemas/debug-memory.yaml - Memory schema
+- @$AIWG_ROOT/${CLAUDE_PLUGIN_ROOT}/docs/executable-feedback-guide.md - Guide
+- @$AIWG_ROOT/${CLAUDE_PLUGIN_ROOT}/schemas/debug-memory.yaml - Memory schema
 - @.aiwg/research/findings/REF-013-metagpt.md - Research foundation

package/agentic/code/plugins/agent-loop/skills/cross-task-learner/SKILL.md

@@ -723,9 +723,9 @@ ralph:
 
 ## Related
 
-- `@$AIWG_ROOT/agentic/code/addons/ralph/schemas/shared-patterns.yaml` - Pattern schema
-- `@$AIWG_ROOT/agentic/code/addons/ralph/schemas/cross-task-memory.yaml` - Cross-task memory
-- `@$AIWG_ROOT/agentic/code/addons/ralph/docs/cross-loop-learning.md` - Full documentation
+- `@$AIWG_ROOT/${CLAUDE_PLUGIN_ROOT}/schemas/shared-patterns.yaml` - Pattern schema
+- `@$AIWG_ROOT/${CLAUDE_PLUGIN_ROOT}/schemas/cross-task-memory.yaml` - Cross-task memory
+- `@$AIWG_ROOT/${CLAUDE_PLUGIN_ROOT}/docs/cross-loop-learning.md` - Full documentation
 - `.aiwg/research/paper-analysis/REF-013-aiwg-analysis.md` - MetaGPT research
 - `ralph` skill - Iterative loop executor
 - `agent-loop` skill - Detects iterative loop requests
@@ -739,8 +739,8 @@ ralph:
 
 ## References
 
-- @$AIWG_ROOT/agentic/code/addons/ralph/README.md — Ralph addon overview
-- @$AIWG_ROOT/agentic/code/addons/ralph/schemas/shared-patterns.yaml — Pattern schema for cross-loop learning
-- @$AIWG_ROOT/agentic/code/addons/ralph/schemas/cross-task-memory.yaml — Cross-task memory schema
-- @$AIWG_ROOT/agentic/code/addons/ralph/docs/cross-loop-learning.md — Full cross-loop learning documentation
+- @$AIWG_ROOT/${CLAUDE_PLUGIN_ROOT}/README.md — Ralph addon overview
+- @$AIWG_ROOT/${CLAUDE_PLUGIN_ROOT}/schemas/shared-patterns.yaml — Pattern schema for cross-loop learning
+- @$AIWG_ROOT/${CLAUDE_PLUGIN_ROOT}/schemas/cross-task-memory.yaml — Cross-task memory schema
+- @$AIWG_ROOT/${CLAUDE_PLUGIN_ROOT}/docs/cross-loop-learning.md — Full cross-loop learning documentation
 - @$AIWG_ROOT/agentic/code/addons/aiwg-utils/rules/subagent-scoping.md — Subagent scoping rules relevant to loop orchestration

package/agentic/code/plugins/agent-loop/skills/cross-task-learner/manifest.json

@@ -26,9 +26,9 @@
   },
   "dependencies": {
     "schemas": [
-      "@agentic/code/addons/ralph/schemas/shared-patterns.yaml",
-      "@agentic/code/addons/ralph/schemas/cross-task-memory.yaml",
-      "@agentic/code/addons/ralph/schemas/debug-memory.yaml"
+      "@${CLAUDE_PLUGIN_ROOT}/schemas/shared-patterns.yaml",
+      "@${CLAUDE_PLUGIN_ROOT}/schemas/cross-task-memory.yaml",
+      "@${CLAUDE_PLUGIN_ROOT}/schemas/debug-memory.yaml"
     ],
     "skills": [
       "agent-loop"

package/agentic/code/plugins/agent-loop/skills/debug-memory/SKILL.md

@@ -61,6 +61,6 @@ Clear debug memory (with confirmation).
 
 ## References
 
-- @$AIWG_ROOT/agentic/code/addons/ralph/schemas/debug-memory.yaml - Debug memory schema
+- @$AIWG_ROOT/${CLAUDE_PLUGIN_ROOT}/schemas/debug-memory.yaml - Debug memory schema
 - @$AIWG_ROOT/agentic/code/frameworks/sdlc-complete/rules/executable-feedback.md - Executable feedback rules
-- @$AIWG_ROOT/agentic/code/addons/ralph/docs/executable-feedback-guide.md - Guide
+- @$AIWG_ROOT/${CLAUDE_PLUGIN_ROOT}/docs/executable-feedback-guide.md - Guide

package/agentic/code/plugins/agent-loop/skills/execute-feedback/SKILL.md

@@ -65,7 +65,7 @@ When invoked, perform the executable feedback loop per REF-013 MetaGPT:
 ## References
 
 - @$AIWG_ROOT/agentic/code/frameworks/sdlc-complete/rules/executable-feedback.md - Executable feedback rules
-- @$AIWG_ROOT/agentic/code/addons/ralph/docs/executable-feedback-guide.md - Implementation guide
-- @$AIWG_ROOT/agentic/code/addons/ralph/schemas/debug-memory.yaml - Debug memory schema
+- @$AIWG_ROOT/${CLAUDE_PLUGIN_ROOT}/docs/executable-feedback-guide.md - Implementation guide
+- @$AIWG_ROOT/${CLAUDE_PLUGIN_ROOT}/schemas/debug-memory.yaml - Debug memory schema
 - @$AIWG_ROOT/agentic/code/frameworks/sdlc-complete/schemas/flows/executable-feedback.yaml - Workflow schema
 - @.aiwg/research/findings/REF-013-metagpt.md - Research foundation

package/agentic/code/plugins/agent-loop/skills/infer-completion-criteria/SKILL.md

@@ -319,7 +319,7 @@ Or rephrase the task with a concrete intent:
 - @$AIWG_ROOT/agentic/code/addons/aiwg-utils/rules/research-before-decision.md — Layer-walk research pattern
 - @$AIWG_ROOT/agentic/code/addons/aiwg-utils/rules/instruction-comprehension.md — Don't override explicit user criteria
 - @$AIWG_ROOT/agentic/code/addons/aiwg-utils/rules/auto-compact-continue.md — Criterion IS what the loop continues toward
-- @$AIWG_ROOT/agentic/code/addons/agent-loop/skills/agent-loop/SKILL.md — The detection/routing skill that delegates here when `--completion` is missing
-- @$AIWG_ROOT/agentic/code/addons/agent-loop/skills/ralph/SKILL.md — The legacy executor skill that consumes this output (`ralph` is legacy for `agent-loop`'s executor)
-- @$AIWG_ROOT/agentic/code/addons/agent-loop/skills/agent-loop-ext/SKILL.md — The crash-resilient external loop, same delegation pattern
-- @$AIWG_ROOT/agentic/code/addons/agent-loop/agents/ralph-verifier.md — Runs the verification command this skill proposes
+- @$AIWG_ROOT/${CLAUDE_PLUGIN_ROOT}/skills/agent-loop/SKILL.md — The detection/routing skill that delegates here when `--completion` is missing
+- @$AIWG_ROOT/${CLAUDE_PLUGIN_ROOT}/skills/ralph/SKILL.md — The legacy executor skill that consumes this output (`ralph` is legacy for `agent-loop`'s executor)
+- @$AIWG_ROOT/${CLAUDE_PLUGIN_ROOT}/skills/agent-loop-ext/SKILL.md — The crash-resilient external loop, same delegation pattern
+- @$AIWG_ROOT/${CLAUDE_PLUGIN_ROOT}/agents/ralph-verifier.md — Runs the verification command this skill proposes

package/agentic/code/plugins/agent-loop/skills/ralph/SKILL.md

@@ -75,7 +75,7 @@ Success criteria. Must be:
 
 **When omitted**: the loop delegates to the `infer-completion-criteria` skill, which derives a measurable criterion from project docs (CLAUDE.md / AGENTS.md / AIWG.md), package manifests, CI configuration, and `.aiwg/` artifacts. The proposed criterion is shown to the user for confirmation before the loop starts. Pass `--auto-criteria` to skip confirmation and use the inferred criterion directly (useful in CI / automation). Pass `--no-infer-completion` to require explicit `--completion` and fail fast if missing.
 
-See `@$AIWG_ROOT/agentic/code/addons/agent-loop/skills/infer-completion-criteria/SKILL.md` for the inference pipeline.
+See `@$AIWG_ROOT/${CLAUDE_PLUGIN_ROOT}/skills/infer-completion-criteria/SKILL.md` for the inference pipeline.
 
 ### --max-iterations (default: 10)
 Safety limit on iterations. Prevents infinite loops.

package/agentic/code/plugins/agent-loop/skills/ralph-abort/SKILL.md

@@ -135,7 +135,7 @@ After abort:
 
 ## References
 
-- @$AIWG_ROOT/agentic/code/addons/ralph/README.md — Ralph addon overview and loop executor documentation
+- @$AIWG_ROOT/${CLAUDE_PLUGIN_ROOT}/README.md — Ralph addon overview and loop executor documentation
 - @$AIWG_ROOT/agentic/code/addons/aiwg-utils/rules/human-authorization.md — Authorization rules for irreversible actions like revert
 - @$AIWG_ROOT/docs/cli-reference.md — CLI reference for ralph-abort and related commands
 - @$AIWG_ROOT/agentic/code/frameworks/sdlc-complete/README.md — SDLC framework context

package/agentic/code/plugins/agent-loop/skills/ralph-analytics/SKILL.md

@@ -47,6 +47,6 @@ When invoked, analyze agent loop data and present metrics:
 
 ## References
 
-- @$AIWG_ROOT/agentic/code/addons/ralph/schemas/reflection-memory.json - Reflection schema
-- @$AIWG_ROOT/agentic/code/addons/ralph/schemas/debug-memory.yaml - Debug memory schema
-- @$AIWG_ROOT/agentic/code/addons/ralph/docs/reflection-memory-guide.md - Guide
+- @$AIWG_ROOT/${CLAUDE_PLUGIN_ROOT}/schemas/reflection-memory.json - Reflection schema
+- @$AIWG_ROOT/${CLAUDE_PLUGIN_ROOT}/schemas/debug-memory.yaml - Debug memory schema
+- @$AIWG_ROOT/${CLAUDE_PLUGIN_ROOT}/docs/reflection-memory-guide.md - Guide

package/agentic/code/plugins/agent-loop/skills/ralph-attach/SKILL.md

@@ -152,5 +152,5 @@ Press `Ctrl+C` while attached.
 
 - @$AIWG_ROOT/src/cli/handlers/ralph.ts — Al handler (attachToLoopOutput)
 - @$AIWG_ROOT/src/cli/handlers/ralph-launcher.ts — Loop launcher and state management
-- @$AIWG_ROOT/agentic/code/addons/ralph/README.md — Al documentation
+- @$AIWG_ROOT/${CLAUDE_PLUGIN_ROOT}/README.md — Al documentation
 - @$AIWG_ROOT/tools/ralph-external/README.md — External loop architecture

package/agentic/code/plugins/agent-loop/skills/ralph-config/SKILL.md

@@ -317,4 +317,4 @@ Check that the .aiwg/ralph/ directory is writable:
 
 - @$AIWG_ROOT/src/cli/handlers/ralph.ts — Al CLI handler (config parsing)
 - @$AIWG_ROOT/tools/ralph-external/README.md — External loop architecture
-- @$AIWG_ROOT/agentic/code/addons/ralph/README.md — Al documentation
+- @$AIWG_ROOT/${CLAUDE_PLUGIN_ROOT}/README.md — Al documentation

package/agentic/code/plugins/agent-loop/skills/ralph-external/SKILL.md

@@ -238,4 +238,4 @@ echo "Exit: $?"
 - @$AIWG_ROOT/tools/ralph-external/orchestrator.mjs — Loop orchestration engine
 - @$AIWG_ROOT/tools/ralph-external/state-manager.mjs — State persistence layer
 - @$AIWG_ROOT/tools/ralph-external/session-launcher.mjs — AI session launcher
-- @$AIWG_ROOT/agentic/code/addons/ralph/README.md — Al documentation
+- @$AIWG_ROOT/${CLAUDE_PLUGIN_ROOT}/README.md — Al documentation

package/agentic/code/plugins/agent-loop/skills/ralph-memory/SKILL.md

@@ -280,7 +280,7 @@ Usage:
 - @$AIWG_ROOT/tools/ralph-external/lib/semantic-memory.mjs — Semantic memory layer
 - @$AIWG_ROOT/tools/ralph-external/lib/memory-retrieval.mjs — Memory query logic
 - @$AIWG_ROOT/tools/ralph-external/lib/memory-promotion.mjs — Cross-task memory promotion
-- @$AIWG_ROOT/agentic/code/addons/ralph/README.md — Al documentation
+- @$AIWG_ROOT/${CLAUDE_PLUGIN_ROOT}/README.md — Al documentation
 
 ## Storage Routing (#934, #967)
 

package/agentic/code/plugins/agent-loop/skills/ralph-reflect/SKILL.md

@@ -54,8 +54,8 @@ Archive and clear reflection history.
 
 ## References
 
-- @$AIWG_ROOT/agentic/code/addons/ralph/schemas/reflection-memory.json - Reflection schema
-- @$AIWG_ROOT/agentic/code/addons/ralph/docs/reflection-memory-guide.md - Guide
+- @$AIWG_ROOT/${CLAUDE_PLUGIN_ROOT}/schemas/reflection-memory.json - Reflection schema
+- @$AIWG_ROOT/${CLAUDE_PLUGIN_ROOT}/docs/reflection-memory-guide.md - Guide
 - @.aiwg/research/findings/REF-021-reflexion.md - Research foundation
 
 ## Storage Routing (#934, #967)

package/agentic/code/plugins/agent-loop/skills/ralph-resume/SKILL.md

@@ -190,7 +190,7 @@ Continues from last checkpoint with original settings.
 
 ## References
 
-- @$AIWG_ROOT/agentic/code/addons/ralph/README.md — Ralph addon overview and loop executor documentation
+- @$AIWG_ROOT/${CLAUDE_PLUGIN_ROOT}/README.md — Ralph addon overview and loop executor documentation
 - @$AIWG_ROOT/agentic/code/addons/aiwg-utils/rules/vague-discretion.md — Loop termination and iteration limit rules
 - @$AIWG_ROOT/docs/cli-reference.md — CLI reference for ralph-resume and related commands
 - @$AIWG_ROOT/agentic/code/addons/aiwg-utils/rules/instruction-comprehension.md — Re-reading original task instructions on resume