{
  "name": "LLM Ambiguity Lab v1 DCRL Specification",
  "version": "1.0",
  "creator": "Deshimaru Sakaguchi",
  "responsible_maintainer": "Deshimaru Sakaguchi",
  "project_url": "https://deshimarusakaguchi.com/llm-ambiguity-lab/",
  "canonical_url": "https://deshimarusakaguchi.com/llm-ambiguity-lab/data/dcrl-spec.json",
  "acronym": "DCRL",
  "expansion": [
    "Detect",
    "Clarify",
    "Resolve",
    "Learn"
  ],
  "purpose": "A control loop for deciding what an agent should do before executing an instruction whose operational meaning may be incomplete.",
  "phases": [
    {
      "order": 1,
      "id": "detect",
      "label": "Detect",
      "short_description": "Evaluate what is known and what is missing.",
      "inputs": [
        "user instruction",
        "available context representation"
      ],
      "actions": [
        "identify target_task",
        "identify target_object",
        "assess context_grounding",
        "identify unresolved referents",
        "identify missing_parameters",
        "represent materially different interpretations when useful"
      ],
      "output": "resolution evidence and unresolved parameters"
    },
    {
      "order": 2,
      "id": "clarify",
      "label": "Clarify",
      "short_description": "Ask only for information that changes the decision.",
      "inputs": [
        "resolution evidence",
        "missing execution-relevant parameters"
      ],
      "actions": [
        "pause execution when ambiguity is material",
        "prefer bounded clarification over broad restatement requests",
        "present concrete alternatives when they reduce user effort"
      ],
      "output": "additional information needed to resolve the task"
    },
    {
      "order": 3,
      "id": "resolve",
      "label": "Resolve",
      "short_description": "Build an operational task specification.",
      "inputs": [
        "explicit instruction",
        "available context",
        "clarification",
        "safely disclosed defaults where allowed"
      ],
      "actions": [
        "integrate resolved task information",
        "select a resolution state",
        "allow execution only when the policy permits it"
      ],
      "output": "task specification ready for execution or assumption-disclosed execution",
      "meaning_of_resolved": "Sufficiently specified under the current policy; not proof of the user's objectively true internal intention."
    },
    {
      "order": 4,
      "id": "learn",
      "label": "Learn",
      "short_description": "Represent resolved patterns when memory is available.",
      "inputs": [
        "resolved ambiguity patterns",
        "user corrections",
        "established preferences"
      ],
      "actions": [
        "preserve reusable information only when an appropriate memory mechanism exists"
      ],
      "output": "context or preference information available to later interactions",
      "v1_status": "conceptual",
      "persistent_learning_in_public_v1": false
    }
  ],
  "loop": {
    "clarification_reentry": "A full implementation may return clarified information to Detect for re-evaluation.",
    "persistent_multi_turn_required_in_v1": false
  },
  "non_claims": [
    "DCRL does not guarantee hallucination elimination.",
    "DCRL does not by itself guarantee agent safety.",
    "DCRL resolution does not prove recovery of a user's true internal intention."
  ]
}