---

name: dialogue-resolve-reference description: Resolves framework reference IDs to their content. Use when you need to look up a document, decision, observation, task, or ADR by its ID. Triggers on "resolve reference", "look up THY-001", "find DEC-...", "get content of", "what is ADR-001". allowed-tools: Bash

Dialogue: Reference Resolver

Resolves framework reference IDs to their content. This skill implements the retrieval operation for the framework's Transactive Memory System.

When to Use

Use this skill when you need to:

• Look up a project document by its ID (THY-001, REF-001, STR-001, ADR-001)
• Find a decision or observation log entry
• Retrieve a task's details
• Look up a process definition, instance, or execution log

Do NOT use for:

• External URLs → use WebFetch
• File paths → use Read tool directly
• Creating new references → use appropriate logging/creation skills
• Framework source references (F-N, C-N, etc.) → see Framework Source References below

Configuration

Artifact locations are configured in the script. Projects can customise via .dialogue/config.yaml (config parsing TODO).

Default locations:

• THY/REF/STR documents: implementation/ (framework dev) or docs/ (typical deployments)
• ADR documents: decisions/
• Decisions: .dialogue/logs/decisions/ (per-file)
• Observations: .dialogue/logs/observations/ (per-file)
• Tasks: .dialogue/tasks/ (per-file)
• Process definitions: claude-plugin-evo/processes/
• Process instances: .dialogue/processes/
• Execution logs: .dialogue/logs/executions/

How to Resolve a Reference

Execute the following bash command:

Copy${CLAUDE_PLUGIN_ROOT}/skills/dialogue-resolve-reference/scripts/resolve-reference.sh <id> [output_format]

Required Parameters

Optional Parameters

Output Formats

Supported Reference Types

Project Documents (Resolvable)

Log Entries (Resolvable)

Tasks (Resolvable)

Process Execution (Resolvable)

Actors (Metadata Only)

Framework Source References (NOT Resolvable)

These reference framework source documentation, not available in deployed projects:

See FW-005 (Deployment Artifact Definition) for the deployment model that separates framework source from runtime artifacts.

Examples

Resolve a Theory Document

Copy${CLAUDE_PLUGIN_ROOT}/skills/dialogue-resolve-reference/scripts/resolve-reference.sh THY-001

Get Just the Path to an ADR

Copy${CLAUDE_PLUGIN_ROOT}/skills/dialogue-resolve-reference/scripts/resolve-reference.sh ADR-001 path

Look Up a Decision Log Entry

Copy${CLAUDE_PLUGIN_ROOT}/skills/dialogue-resolve-reference/scripts/resolve-reference.sh DEC-20260114-091633

Get Task Metadata

Copy${CLAUDE_PLUGIN_ROOT}/skills/dialogue-resolve-reference/scripts/resolve-reference.sh SH-002 metadata

Look Up a Process Definition

Copy${CLAUDE_PLUGIN_ROOT}/skills/dialogue-resolve-reference/scripts/resolve-reference.sh PROC-3.1

Find a Process Instance

Copy${CLAUDE_PLUGIN_ROOT}/skills/dialogue-resolve-reference/scripts/resolve-reference.sh PINST-20260118-143052

Get Execution Log Path

Copy${CLAUDE_PLUGIN_ROOT}/skills/dialogue-resolve-reference/scripts/resolve-reference.sh EXEC-20260118-143055 path

Output

The script returns JSON with the resolution result:

Success

Copy{
  "status": "RESOLVED",
  "id": "THY-001",
  "type": "DOCUMENT",
  "location": "implementation/theory_framework.md",
  "content": "..."
}

Not Found

Copy{
  "status": "NOT_FOUND",
  "id": "THY-999",
  "error": "No document matching pattern found",
  "searched": ["implementation/theory_*.md"]
}

Not Supported (Framework Source)

Copy{
  "status": "NOT_SUPPORTED",
  "id": "C-1",
  "type": "CONCEPT",
  "error": "Framework source reference - not available in deployed framework",
  "note": "See FW-005 for deployment model."
}

Invalid ID

Copy{
  "status": "INVALID_ID",
  "id": "UNKNOWN-123",
  "error": "ID does not match any known pattern"
}

Error Handling

Framework Grounding

The resolver implements TMS Retrieval for runtime artifacts:

• Directory: Pattern matching identifies what type of reference
• Retrieval: Fetch content from project locations
• Deployment-aware: Distinguishes runtime artifacts from framework source

This enables the Context Graph (SH-003) to resolve edges to actual content within a deployed project.