Loom Skill Enhancement

{
  "package_id": "Techne.Loom.SkillOrchestrator",
  "channel": "released",
  "resolved_version": "0.2.126",
  "runtime_bundle": [
    {
      "package_id": "Techne.Loom.SkillOrchestrator",
      "resolved_version": "0.2.126"
    },
    {
      "package_id": "Techne.Loom.Common",
      "resolved_version": "0.2.126"
    },
    {
      "package_id": "Techne.Loom.Abstractions",
      "resolved_version": "0.2.126"
    }
  ],
  "runtime_restore": {
    "source": "nuget",
    "fresh_download": true,
    "allow_local_cache_when_exact_version_matches": true,
    "fallback_source": "github-release-asset"
  },
  "enhancement": {
    "resolved_at_utc": "2026-06-24T03:01:34Z",
    "selected_language": "en"
  },
  "notes": [
    "Resolve the exact version from NuGet first.",
    "Freshly download the full runtime bundle unless the local cache already holds the exact same version.",
    "Use GitHub release assets only when NuGet.org is unavailable."
  ]
}

{
  "instanceId": "loom-skill-enhancement-self-bootstrap",
  "templateKind": "so-governed-target-skill",
  "validation": {
    "gates": {
      "gate.bootstrap_plan": {
        "description": "Plan review gate for self-bootstrap evidence.",
        "requiredOutputFamilies": [
          "skill_plan_md",
          "review_plan_md",
          "package_index_links_ref"
        ],
        "requiredMachineReadableOutputFamilies": [
          "package_index_links_ref"
        ],
        "requiredHumanReviewableOutputFamilies": [
          "skill_plan_md",
          "review_plan_md"
        ]
      },
      "gate.bootstrap_runtime_ready": {
        "description": "Hard gate that proves the selected published SO runtime bundle is reacquired, validated, and ready before guide capture.",
        "requiredOutputFamilies": [
          "published_package_workflow_evidence",
          "runtime_preflight_result",
          "resolved_runtime_version_ref",
          "runtime_bundle_packages_ref",
          "unified_runtime_directory_ref"
        ],
        "requiredMachineReadableOutputFamilies": [
          "published_package_workflow_evidence",
          "runtime_preflight_result",
          "resolved_runtime_version_ref",
          "runtime_bundle_packages_ref",
          "unified_runtime_directory_ref"
        ],
        "requiredHumanReviewableOutputFamilies": []
      },
      "gate.bootstrap_runtime_guide": {
        "description": "Hard gate that proves the selected published SO runtime is runnable and has produced a fresh guide result before any downstream planning, authoring, validation, compile, run, resume, or input collection work.",
        "requiredOutputFamilies": [
          "resolved_guide_surface_ref"
        ],
        "requiredMachineReadableOutputFamilies": [
          "resolved_guide_surface_ref"
        ],
        "requiredHumanReviewableOutputFamilies": []
      },
      "gate.bootstrap_compile_review": {
        "description": "Compile review gate for the self-bootstrap template audit artifacts.",
        "requiredOutputFamilies": [
          "workflow_mermaid_md",
          "workflow_html",
          "workflow_analysis_json"
        ],
        "requiredMachineReadableOutputFamilies": [
          "workflow_mermaid_md",
          "workflow_html",
          "workflow_analysis_json"
        ],
        "requiredHumanReviewableOutputFamilies": [
          "workflow_analysis_json"
        ]
      },
      "gate.bootstrap_blocked_governance": {
        "description": "Blocked strongest-earned governance gate for the runtime review boundary.",
        "requiredOutputFamilies": [
          "workflow_runtime_copy_json",
          "workflow_mermaid_md",
          "workflow_html",
          "workflow_analysis_json"
        ],
        "requiredMachineReadableOutputFamilies": [
          "workflow_runtime_copy_json",
          "workflow_analysis_json"
        ],
        "requiredHumanReviewableOutputFamilies": [
          "workflow_mermaid_md",
          "workflow_html",
          "workflow_analysis_json"
        ]
      },
      "gate.bootstrap_done": {
        "description": "Done gate for the self-bootstrap pass.",
        "requiredOutputFamilies": [
          "workflow_template_json",
          "workflow_designer_dispatch_record",
          "weave_out_subagent_review",
          "target_skill_subagent_assets",
          "target_skill_subagent_link_updates",
          "review_fix_loop_evidence",
          "commit_report_ready",
          "checked_in_skill_markdown_asset",
          "checked_in_package_lock_asset",
          "node_to_file_map",
          "completion_manifest_reference",
          "completion_manifest_md"
        ],
        "requiredMachineReadableOutputFamilies": [
          "workflow_template_json",
          "workflow_designer_dispatch_record",
          "weave_out_subagent_review",
          "target_skill_subagent_assets",
          "target_skill_subagent_link_updates",
          "review_fix_loop_evidence",
          "commit_report_ready",
          "checked_in_skill_markdown_asset",
          "checked_in_package_lock_asset",
          "node_to_file_map",
          "completion_manifest_reference",
          "completion_manifest_md"
        ],
        "requiredHumanReviewableOutputFamilies": [
          "workflow_template_json",
          "weave_out_subagent_review",
          "target_skill_subagent_link_updates",
          "review_fix_loop_evidence",
          "node_to_file_map",
          "completion_manifest_md"
        ]
      }
    },
    "routes": {
      "bootstrap_route": {
        "description": "Primary governed route for self-bootstrap.",
        "requiredTerminalGateIds": [
          "gate.bootstrap_done"
        ],
        "requiredBlockedGateIds": [
          "gate.bootstrap_blocked_governance"
        ]
      }
    },
    "declaredUserOwnedFields": [
      "guide_language",
      "target_skill_path",
      "approval_decision",
      "feedback_notes"
    ],
    "reservedRuntimeOwnedFields": [
      "workflow_file",
      "event_log_file",
      "workflow_instance_file",
      "analysis_file",
      "mermaid_file",
      "html_file",
      "audit_artifacts",
      "governance_state",
      "resolved_so_runtime",
      "resolved_guide_surface"
    ]
  },
  "startNodeId": "state.start",
  "currentNodeId": "state.start",
  "endNodeId": "state.done",
  "status": "readyToStart",
  "context": {},
  "nodes": {
    "state.start": {
      "$kind": "state",
      "id": "state.start",
      "name": "Start",
      "description": "Prepare the self-bootstrap pass.",
      "workflowPhase": "01 Channel And Entry",
      "groups": [
        {
          "id": "group.start",
          "transitionIds": [
            "transition.classify_governance"
          ]
        }
      ],
      "waitBehavior": "blockUntilComplete"
    },
    "state.channel_decision": {
      "$kind": "state",
      "id": "state.channel_decision",
      "name": "Bound Runtime Path Decision",
      "description": "Route to the correct bound-runtime path after governance-state classification without asking the user to choose a channel.",
      "workflowPhase": "01 Channel And Entry",
      "groups": [
        {
          "id": "group.channel_decision",
          "transitionIds": [
            "transition.enter_reenhancement_context",
            "transition.use_bound_runtime_path"
          ]
        }
      ],
      "waitBehavior": "blockUntilComplete"
    },
    "state.reenhancement_context": {
      "$kind": "state",
      "id": "state.reenhancement_context",
      "name": "Reenhancement Context",
      "description": "Start the explicit re-enhancement inspection chain before reusing the bound runtime version.",
      "workflowPhase": "02 Existing Asset Inspection",
      "groups": [
        {
          "id": "group.reenhancement_context",
          "transitionIds": [
            "transition.inspect_existing_skill_markdown"
          ]
        }
      ],
      "waitBehavior": "blockUntilComplete"
    },
    "state.inspect_package_lock": {
      "$kind": "state",
      "id": "state.inspect_package_lock",
      "name": "Inspect Package Lock",
      "description": "Inspect the current checked-in SO package lock before reusing the bound runtime version.",
      "workflowPhase": "02 Existing Asset Inspection",
      "groups": [
        {
          "id": "group.inspect_package_lock",
          "transitionIds": [
            "transition.inspect_existing_package_lock"
          ]
        }
      ],
      "waitBehavior": "blockUntilComplete"
    },
    "state.inspect_workflow_assets": {
      "$kind": "state",
      "id": "state.inspect_workflow_assets",
      "name": "Inspect Workflow Assets",
      "description": "Inspect the current checked-in workflow assets before bound-runtime reacquisition.",
      "workflowPhase": "02 Existing Asset Inspection",
      "groups": [
        {
          "id": "group.inspect_workflow_assets",
          "transitionIds": [
            "transition.inspect_existing_workflow_assets"
          ]
        }
      ],
      "waitBehavior": "blockUntilComplete"
    },
    "state.refresh_runtime": {
      "$kind": "state",
      "id": "state.refresh_runtime",
      "name": "Refresh Runtime",
      "description": "Reacquire the selected SO runtime bundle before analysis.",
      "workflowPhase": "03 Runtime Proof",
      "groups": [
        {
          "id": "group.refresh_runtime",
          "transitionIds": [
            "transition.reacquire_runtime"
          ]
        }
      ],
      "waitBehavior": "blockUntilComplete"
    },
    "state.capture_guide": {
      "$kind": "state",
      "id": "state.capture_guide",
      "name": "Capture Guide",
      "description": "Run a fresh guide capture from the selected runtime before editing or validation.",
      "workflowPhase": "03 Runtime Proof",
      "groups": [
        {
          "id": "group.capture_guide",
          "transitionIds": [
            "transition.capture_guide"
          ]
        }
      ],
      "waitBehavior": "blockUntilComplete"
    },
    "state.post_guide_decision": {
      "$kind": "state",
      "id": "state.post_guide_decision",
      "name": "Post Guide Decision",
      "description": "Route to the re-enhancement guide-delta review only when the target is already SO-enhanced.",
      "workflowPhase": "03 Runtime Proof",
      "groups": [
        {
          "id": "group.post_guide_decision",
          "transitionIds": [
            "transition.require_reenhancement_gap_review",
            "transition.skip_reenhancement_gap_review"
          ]
        }
      ],
      "waitBehavior": "blockUntilComplete"
    },
    "state.reenhancement_gap_review": {
      "$kind": "state",
      "id": "state.reenhancement_gap_review",
      "name": "Reenhancement Gap Review",
      "description": "Start the explicit re-enhancement guide-delta review chain before common plan analysis.",
      "workflowPhase": "04 Reenhancement Review",
      "groups": [
        {
          "id": "group.reenhancement_gap_review",
          "transitionIds": [
            "transition.compare_skill_markdown_against_latest_guide"
          ]
        }
      ],
      "waitBehavior": "blockUntilComplete"
    },
    "state.reenhancement_lock_gap_review": {
      "$kind": "state",
      "id": "state.reenhancement_lock_gap_review",
      "name": "Lock Gap Review",
      "description": "Compare the current checked-in package lock against the freshly captured guide before common plan analysis.",
      "workflowPhase": "04 Reenhancement Review",
      "groups": [
        {
          "id": "group.reenhancement_lock_gap_review",
          "transitionIds": [
            "transition.compare_package_lock_against_latest_guide"
          ]
        }
      ],
      "waitBehavior": "blockUntilComplete"
    },
    "state.reenhancement_workflow_gap_review": {
      "$kind": "state",
      "id": "state.reenhancement_workflow_gap_review",
      "name": "Workflow Gap Review",
      "description": "Compare the current checked-in workflow governance assets against the freshly captured guide before common plan analysis.",
      "workflowPhase": "04 Reenhancement Review",
      "groups": [
        {
          "id": "group.reenhancement_workflow_gap_review",
          "transitionIds": [
            "transition.compare_workflow_governance_against_latest_guide"
          ]
        }
      ],
      "waitBehavior": "blockUntilComplete"
    },
    "state.plan": {
      "$kind": "state",
      "id": "state.plan",
      "name": "Plan",
      "description": "Start the explicit common planning analysis chain.",
      "workflowPhase": "05 Planning",
      "groups": [
        {
          "id": "group.plan",
          "transitionIds": [
            "transition.analyze_scope"
          ]
        }
      ],
      "waitBehavior": "blockUntilComplete"
    },
    "state.plan_route_gate_review": {
      "$kind": "state",
      "id": "state.plan_route_gate_review",
      "name": "Route Gate Review",
      "description": "Review route structure, branch logic, seams, and gate contracts before evidence mapping.",
      "workflowPhase": "05 Planning",
      "groups": [
        {
          "id": "group.plan_route_gate_review",
          "transitionIds": [
            "transition.analyze_route_gate_structure"
          ]
        }
      ],
      "waitBehavior": "blockUntilComplete"
    },
    "state.plan_evidence_review": {
      "$kind": "state",
      "id": "state.plan_evidence_review",
      "name": "Evidence Review",
      "description": "Review evidence mapping, output families, and node-to-artifact links before template drafting.",
      "workflowPhase": "05 Planning",
      "groups": [
        {
          "id": "group.plan_evidence_review",
          "transitionIds": [
            "transition.analyze_evidence_node_map"
          ]
        }
      ],
      "waitBehavior": "blockUntilComplete"
    },
    "state.template_draft": {
      "$kind": "state",
      "id": "state.template_draft",
      "name": "Template Draft",
      "description": "Draft or refresh the checked-in workflow template before compile review.",
      "workflowPhase": "06 Template Authoring",
      "groups": [
        {
          "id": "group.template_draft",
          "transitionIds": [
            "transition.draft_template"
          ]
        }
      ],
      "waitBehavior": "blockUntilComplete"
    },
    "state.compile_review": {
      "$kind": "state",
      "id": "state.compile_review",
      "name": "Compile Review",
      "description": "Compile the template and package the review artifacts before AskUser.",
      "workflowPhase": "06 Template Authoring",
      "groups": [
        {
          "id": "group.compile_review",
          "transitionIds": [
            "transition.compile_template"
          ]
        }
      ],
      "waitBehavior": "blockUntilComplete"
    },
    "state.weave_out_subagent_review": {
      "$kind": "state",
      "id": "state.weave_out_subagent_review",
      "name": "Weave-Out Subagent Review",
      "description": "Review every current weave-out and decide whether it should become a dedicated target-skill local subagent before user review.",
      "workflowPhase": "07 Weave-Out Review",
      "groups": [
        {
          "id": "group.weave_out_subagent_review",
          "transitionIds": [
            "transition.review_weave_out_subagent_fit"
          ]
        }
      ],
      "waitBehavior": "blockUntilComplete"
    },
    "state.review_request": {
      "$kind": "state",
      "id": "state.review_request",
      "name": "Review Request",
      "description": "Present the compiled audit artifacts through the AskUser seam before approval or revision feedback.",
      "workflowPhase": "08 User Review",
      "groups": [
        {
          "id": "group.review_request",
          "transitionIds": [
            "transition.request_review"
          ]
        }
      ],
      "waitBehavior": "blockUntilComplete"
    },
    "state.review_decision": {
      "$kind": "state",
      "id": "state.review_decision",
      "name": "Review Decision",
      "description": "Route based on the approved or revised review decision.",
      "workflowPhase": "08 User Review",
      "groups": [
        {
          "id": "group.review_decision",
          "transitionIds": [
            "transition.iterate_draft",
            "transition.accept_draft"
          ]
        }
      ],
      "waitBehavior": "waitForSignal"
    },
    "state.review_fix_loop": {
      "$kind": "state",
      "id": "state.review_fix_loop",
      "name": "Review Fix Loop",
      "description": "Run the explicit review-skill to fix-skill loop before commit/report handoff.",
      "workflowPhase": "09 Review Fix Loop",
      "groups": [
        {
          "id": "group.review_fix_loop",
          "transitionIds": [
            "transition.run_review_fix_loop"
          ]
        }
      ],
      "waitBehavior": "blockUntilComplete"
    },
    "state.wait_runtime": {
      "$kind": "state",
      "id": "state.wait_runtime",
      "name": "Wait Runtime",
      "description": "Publish blocked runtime artifacts before final lock.",
      "workflowPhase": "10 Runtime Handoff",
      "groups": [
        {
          "id": "group.wait_runtime",
          "transitionIds": [
            "transition.wait_runtime"
          ]
        }
      ],
      "waitBehavior": "waitForSignal"
    },
    "state.lock": {
      "$kind": "state",
      "id": "state.lock",
      "name": "Lock",
      "description": "Burn the runtime lock and governance notes.",
      "workflowPhase": "10 Runtime Handoff",
      "groups": [
        {
          "id": "group.lock",
          "transitionIds": [
            "transition.finalize_lock"
          ]
        }
      ],
      "waitBehavior": "blockUntilComplete"
    },
    "state.done": {
      "$kind": "state",
      "id": "state.done",
      "name": "Done",
      "description": "Self-bootstrap finished.",
      "workflowPhase": "11 Completion",
      "groups": [],
      "waitBehavior": "blockUntilComplete"
    },
    "transition.classify_governance": {
      "$kind": "command",
      "id": "transition.classify_governance",
      "name": "Classify governance state",
      "description": "Seed the current self-bootstrap target as already SO-enhanced before reusing the required bound runtime version.",
      "targetNodeId": "state.channel_decision",
      "outputPath": "governance_state",
      "stepKind": "stateUpdate",
      "command": {
        "kind": "nativeCode",
        "name": "workflow.classifyGovernanceState",
        "environmentKey": "",
        "parameters": {
          "updates": {
            "governance_state": "already_so_enhanced"
          }
        }
      }
    },
    "transition.enter_reenhancement_context": {
      "$kind": "expr",
      "id": "transition.enter_reenhancement_context",
      "name": "Already SO-enhanced",
      "description": "Route into the explicit re-enhancement context path when the target is already SO-enhanced.",
      "targetNodeId": "state.reenhancement_context",
      "stepKind": "conditionBranch",
      "guardExpression": "governance_state == 'already_so_enhanced'",
      "succeedExpression": "governance_state == 'already_so_enhanced'"
    },
    "transition.use_bound_runtime_path": {
      "$kind": "expr",
      "id": "transition.use_bound_runtime_path",
      "name": "Needs bound runtime path",
      "description": "Use the normal skill-bound runtime path when the target is not yet SO-enhanced.",
      "targetNodeId": "state.refresh_runtime",
      "stepKind": "conditionBranch",
      "guardExpression": "governance_state != 'already_so_enhanced'",
      "succeedExpression": "governance_state != 'already_so_enhanced'"
    },
    "transition.inspect_existing_skill_markdown": {
      "$kind": "command",
      "id": "transition.inspect_existing_skill_markdown",
      "name": "Inspect existing skill markdown",
      "description": "Inspect the existing checked-in SKILL.md governance wording from a real checked-in file snapshot under the declared target-skill root before bound-runtime reacquisition.",
      "targetNodeId": "state.inspect_package_lock",
      "outputPath": "existing_skill_markdown_review",
      "stepKind": "memoryRead",
      "command": {
        "kind": "nativeCode",
        "name": "workflow.inspectExistingSkillMarkdown",
        "environmentKey": "",
        "parameters": {
          "assetRootInput": "target_skill_path",
          "checkedInAssets": [
            "SKILL.md"
          ]
        }
      }
    },
    "transition.inspect_existing_package_lock": {
      "$kind": "command",
      "id": "transition.inspect_existing_package_lock",
      "name": "Inspect existing package lock",
      "description": "Inspect the existing checked-in package lock from a real checked-in file snapshot under the declared target-skill root before bound-version runtime reacquisition.",
      "targetNodeId": "state.inspect_workflow_assets",
      "outputPath": "existing_package_lock_review",
      "stepKind": "memoryRead",
      "command": {
        "kind": "nativeCode",
        "name": "workflow.inspectExistingPackageLock",
        "environmentKey": "",
        "parameters": {
          "assetRootInput": "target_skill_path",
          "checkedInAssets": [
            "assets/so-workflow/so-package-lock.json"
          ]
        }
      }
    },
    "transition.inspect_existing_workflow_assets": {
      "$kind": "command",
      "id": "transition.inspect_existing_workflow_assets",
      "name": "Inspect existing workflow assets",
      "description": "Inspect the existing checked-in workflow template and governance assets from real checked-in file snapshots under the declared target-skill root before bound-version runtime reacquisition.",
      "targetNodeId": "state.refresh_runtime",
      "outputPath": "existing_workflow_assets_review",
      "stepKind": "memoryRead",
      "command": {
        "kind": "nativeCode",
        "name": "workflow.inspectExistingWorkflowAssets",
        "environmentKey": "",
        "parameters": {
          "assetRootInput": "target_skill_path",
          "checkedInAssets": [
            "assets/so-workflow/so-template.json",
            "assets/so-workflow/node-to-file-map.md",
            "assets/so-workflow/governance-notes.md"
          ]
        }
      }
    },
    "transition.reacquire_runtime": {
      "$kind": "command",
      "id": "transition.reacquire_runtime",
      "name": "Reacquire SO runtime bundle",
      "description": "Pause for an external reacquisition of the exact SO runtime bundle bound to this skill build, then weave back runtime-ready evidence before any downstream analysis or authoring.",
      "targetNodeId": "state.capture_guide",
      "outputPath": "resolved_so_runtime",
      "stepKind": "waitResume",
      "satisfiesGateIds": [
        "gate.bootstrap_runtime_ready"
      ],
      "publishesOutputFamilies": [
        "published_package_workflow_evidence",
        "runtime_preflight_result",
        "resolved_runtime_version_ref",
        "runtime_bundle_packages_ref",
        "unified_runtime_directory_ref"
      ],
      "command": {
        "kind": "tool",
        "name": "workflow.reacquireRuntimeBundle",
        "environmentKey": "",
        "parameters": {
          "resumeOutputKey": "resolved_so_runtime",
          "requiredInputs": [
            "published_package_workflow_evidence",
            "runtime_preflight_result",
            "resolved_runtime_version_ref",
            "runtime_bundle_packages_ref",
            "unified_runtime_directory_ref",
            "resolved_so_runtime"
          ],
          "lockFilePath": "assets/so-workflow/so-package-lock.json"
        }
      }
    },
    "transition.capture_guide": {
      "$kind": "command",
      "id": "transition.capture_guide",
      "name": "Capture fresh guide surface",
      "description": "Pause for an external fresh dotnet so.dll --guide capture from the published runtime bound to this skill build and stop all downstream work until that guide result is woven back.",
      "targetNodeId": "state.post_guide_decision",
      "outputPath": "resolved_guide_surface",
      "stepKind": "waitResume",
      "satisfiesGateIds": [
        "gate.bootstrap_runtime_guide"
      ],
      "publishesOutputFamilies": [
        "resolved_guide_surface_ref"
      ],
      "command": {
        "kind": "tool",
        "name": "workflow.captureGuideSurface",
        "environmentKey": "",
        "parameters": {
          "resumeOutputKey": "resolved_guide_surface",
          "requiredInputs": [
            "resolved_guide_surface_ref",
            "resolved_guide_surface"
          ],
          "command": "dotnet so.dll --guide",
          "languageInput": "guide_language"
        }
      }
    },
    "transition.require_reenhancement_gap_review": {
      "$kind": "expr",
      "id": "transition.require_reenhancement_gap_review",
      "name": "Review reenhancement gaps",
      "description": "Route SO-enhanced targets into an explicit comparison against the newly captured guide before common planning.",
      "targetNodeId": "state.reenhancement_gap_review",
      "stepKind": "conditionBranch",
      "guardExpression": "governance_state == 'already_so_enhanced'",
      "succeedExpression": "governance_state == 'already_so_enhanced'"
    },
    "transition.skip_reenhancement_gap_review": {
      "$kind": "expr",
      "id": "transition.skip_reenhancement_gap_review",
      "name": "Skip reenhancement gaps",
      "description": "Continue directly into the common planning path when this is not an already-governed target.",
      "targetNodeId": "state.plan",
      "stepKind": "conditionBranch",
      "guardExpression": "governance_state != 'already_so_enhanced'",
      "succeedExpression": "governance_state != 'already_so_enhanced'"
    },
    "transition.compare_skill_markdown_against_latest_guide": {
      "$kind": "command",
      "id": "transition.compare_skill_markdown_against_latest_guide",
      "name": "Compare skill markdown against latest guide",
      "description": "Use the reusable subagent at `assets/agents/loom-skill-enhancement-skill-markdown-gap-review.agent.md` to compare the current checked-in SKILL.md governance wording against the freshly captured guide before continuing the re-enhancement review chain.",
      "targetNodeId": "state.reenhancement_lock_gap_review",
      "outputPath": "reenhancement_skill_markdown_gap_review",
      "stepKind": "subagentCall",
      "command": {
        "kind": "tool",
        "name": "workflow.invokeSubagentGapReview",
        "environmentKey": "",
        "parameters": {
          "subagentRelativePath": "assets/agents/loom-skill-enhancement-skill-markdown-gap-review.agent.md",
          "skillHint": "Run the subagent at assets/agents/loom-skill-enhancement-skill-markdown-gap-review.agent.md and compare the checked-in SKILL.md against the latest guide export. If this pattern is copied to a target skill, reference that target-skill local .agent.md by relative path from both the target SKILL.md and the workflow-template weave-out hint.",
          "requiredInputs": [
            "existing_skill_markdown_review",
            "resolved_guide_surface"
          ]
        }
      }
    },
    "transition.compare_package_lock_against_latest_guide": {
      "$kind": "command",
      "id": "transition.compare_package_lock_against_latest_guide",
      "name": "Compare package lock against latest guide",
      "description": "Use the reusable subagent at `assets/agents/loom-skill-enhancement-package-lock-gap-review.agent.md` to compare the current checked-in package lock against the freshly captured guide before continuing the re-enhancement review chain.",
      "targetNodeId": "state.reenhancement_workflow_gap_review",
      "outputPath": "reenhancement_package_lock_gap_review",
      "stepKind": "subagentCall",
      "command": {
        "kind": "tool",
        "name": "workflow.invokeSubagentGapReview",
        "environmentKey": "",
        "parameters": {
          "subagentRelativePath": "assets/agents/loom-skill-enhancement-package-lock-gap-review.agent.md",
          "skillHint": "Run the subagent at assets/agents/loom-skill-enhancement-package-lock-gap-review.agent.md and compare the checked-in so-package-lock.json against the latest guide and channel package rules. If this pattern is copied to a target skill, reference that target-skill local .agent.md by relative path from both the target SKILL.md and the workflow-template weave-out hint.",
          "requiredInputs": [
            "existing_package_lock_review",
            "resolved_guide_surface"
          ]
        }
      }
    },
    "transition.compare_workflow_governance_against_latest_guide": {
      "$kind": "command",
      "id": "transition.compare_workflow_governance_against_latest_guide",
      "name": "Compare workflow governance against latest guide",
      "description": "Use the reusable subagent at `assets/agents/loom-skill-enhancement-workflow-governance-gap-review.agent.md` to compare the current checked-in workflow governance assets against the freshly captured guide before entering common plan analysis.",
      "targetNodeId": "state.plan",
      "outputPath": "reenhancement_workflow_gap_review",
      "stepKind": "subagentCall",
      "command": {
        "kind": "tool",
        "name": "workflow.invokeSubagentGapReview",
        "environmentKey": "",
        "parameters": {
          "subagentRelativePath": "assets/agents/loom-skill-enhancement-workflow-governance-gap-review.agent.md",
          "skillHint": "Run the subagent at assets/agents/loom-skill-enhancement-workflow-governance-gap-review.agent.md and compare the checked-in workflow governance assets against the latest guide. If this pattern is copied to a target skill, reference that target-skill local .agent.md by relative path from both the target SKILL.md and the workflow-template weave-out hint.",
          "requiredInputs": [
            "existing_workflow_assets_review",
            "resolved_guide_surface"
          ]
        }
      }
    },
    "transition.analyze_scope": {
      "$kind": "command",
      "id": "transition.analyze_scope",
      "name": "Analyze skill scope",
      "description": "Use the reusable subagent at `assets/agents/loom-skill-enhancement-scope-input-output-analysis.agent.md` to analyze target-skill inputs, outputs, and required business deliverables.",
      "targetNodeId": "state.plan_route_gate_review",
      "outputPath": "assets/so-workflow/skill-plan.md",
      "stepKind": "subagentCall",
      "satisfiesGateIds": [
        "gate.bootstrap_plan"
      ],
      "publishesOutputFamilies": [
        "skill_plan_md",
        "review_plan_md",
        "resolved_guide_surface_ref",
        "package_index_links_ref"
      ],
      "command": {
        "kind": "tool",
        "name": "workflow.invokeSubagentGapReview",
        "environmentKey": "",
        "parameters": {
          "subagentRelativePath": "assets/agents/loom-skill-enhancement-scope-input-output-analysis.agent.md",
          "skillHint": "Run the subagent at assets/agents/loom-skill-enhancement-scope-input-output-analysis.agent.md and analyze target-skill inputs, outputs, and required business deliverables before the route/gate analysis stage.",
          "source_documents": [
            "SKILL.md",
            "reference/so-skill-reference.md"
          ],
          "requiredRuntimeInputs": [
            "resolved_so_runtime",
            "resolved_guide_surface"
          ]
        }
      }
    },
    "transition.analyze_route_gate_structure": {
      "$kind": "command",
      "id": "transition.analyze_route_gate_structure",
      "name": "Analyze route and gate structure",
      "description": "Use the reusable subagent at `assets/agents/loom-skill-enhancement-route-gate-analysis.agent.md` to analyze branches, loops, seams, routes, and gate contracts.",
      "targetNodeId": "state.plan_evidence_review",
      "outputPath": "plan.route_gate_review",
      "stepKind": "subagentCall",
      "command": {
        "kind": "tool",
        "name": "workflow.invokeSubagentGapReview",
        "environmentKey": "",
        "parameters": {
          "subagentRelativePath": "assets/agents/loom-skill-enhancement-route-gate-analysis.agent.md",
          "skillHint": "Run the subagent at assets/agents/loom-skill-enhancement-route-gate-analysis.agent.md and analyze workflow branches, loops, seams, route structure, and gate contracts before the evidence review stage.",
          "requiredInputs": [
            "resolved_guide_surface",
            "assets/so-workflow/skill-plan.md"
          ]
        }
      }
    },
    "transition.analyze_evidence_node_map": {
      "$kind": "command",
      "id": "transition.analyze_evidence_node_map",
      "name": "Analyze evidence and node map",
      "description": "Use the reusable subagent at `assets/agents/loom-skill-enhancement-evidence-node-map-analysis.agent.md` to analyze output evidence, node-to-file mapping, and reviewable artifact coverage before template drafting.",
      "targetNodeId": "state.template_draft",
      "outputPath": "plan.evidence_review",
      "stepKind": "subagentCall",
      "command": {
        "kind": "tool",
        "name": "workflow.invokeSubagentGapReview",
        "environmentKey": "",
        "parameters": {
          "subagentRelativePath": "assets/agents/loom-skill-enhancement-evidence-node-map-analysis.agent.md",
          "skillHint": "Run the subagent at assets/agents/loom-skill-enhancement-evidence-node-map-analysis.agent.md and analyze output evidence, node-to-file mapping, and reviewable artifact coverage before drafting the workflow template.",
          "requiredInputs": [
            "resolved_guide_surface",
            "plan.route_gate_review",
            "assets/so-workflow/skill-plan.md"
          ]
        }
      }
    },
    "transition.draft_template": {
      "$kind": "command",
      "id": "transition.draft_template",
      "name": "Draft workflow template",
      "description": "Run the required local workflow-designer subagent to draft or refresh the checked-in workflow template before compile review. The weave-back result must include both the checked-in template path and a workflow-designer dispatch record with relative-link context.",
      "targetNodeId": "state.compile_review",
      "outputPath": "assets/so-workflow/so-template.json",
      "stepKind": "subagentCall",
      "publishesOutputFamilies": [
        "workflow_template_json",
        "workflow_designer_dispatch_record"
      ],
      "command": {
        "kind": "tool",
        "name": "workflow.invokeWorkflowDesignerSubagent",
        "environmentKey": "",
        "parameters": {
          "subagentRelativePath": "assets/agents/loom-skill-enhancement-workflow-designer.agent.md",
          "skillHint": "Run the local workflow designer subagent at assets/agents/loom-skill-enhancement-workflow-designer.agent.md with relative links to the target SKILL.md, so-template.json, so-package-lock.json, node-to-file-map.md, governance-notes.md, current guide surface, package-index files, and compile audit artifact expectations, then weave back the refreshed workflow template path plus a workflow-designer dispatch record.",
          "resumeOutputKey": "workflow_template_json",
          "requiredInputs": [
            "workflow_template_json",
            "workflow_designer_dispatch_record"
          ]
        }
      }
    },
    "transition.compile_template": {
      "$kind": "command",
      "id": "transition.compile_template",
      "name": "Compile template artifacts",
      "description": "Pause for an external compile of the template and weave back Mermaid, HTML, JSON backup, and analysis artifacts before user review.",
      "targetNodeId": "state.weave_out_subagent_review",
      "outputPath": "workflow.mermaid.md",
      "stepKind": "waitResume",
      "satisfiesGateIds": [
        "gate.bootstrap_compile_review"
      ],
      "publishesOutputFamilies": [
        "workflow_mermaid_md",
        "workflow_html",
        "workflow_analysis_json",
        "workflow_json_backup"
      ],
      "command": {
        "kind": "tool",
        "name": "workflow.compileTemplate",
        "environmentKey": "",
        "parameters": {
          "resumeOutputKey": "workflow_mermaid_md",
          "requiredInputs": [
            "workflow_mermaid_md",
            "workflow_html",
            "workflow_analysis_json",
            "workflow_json_backup"
          ],
          "artifactFamilies": [
            "workflow_mermaid_md",
            "workflow_html",
            "workflow_analysis_json",
            "workflow_json_backup"
          ]
        }
      }
    },
    "transition.review_weave_out_subagent_fit": {
      "$kind": "command",
      "id": "transition.review_weave_out_subagent_fit",
      "name": "Review weave-out subagent fit",
      "description": "Review every current weave-out and determine whether it should become a dedicated target-skill local subagent under assets/, then record required relative-link updates for the target skill docs.",
      "targetNodeId": "state.review_request",
      "outputPath": "weave_out_subagent_review",
      "stepKind": "subagentCall",
      "publishesOutputFamilies": [
        "weave_out_subagent_review",
        "target_skill_subagent_assets",
        "target_skill_subagent_link_updates"
      ],
      "command": {
        "kind": "tool",
        "name": "workflow.invokeSubagentGapReview",
        "environmentKey": "",
        "parameters": {
          "subagentRelativePath": "assets/agents/loom-skill-enhancement-weave-out-subagent-fit-review.agent.md",
          "skillHint": "Run the dedicated weave-out subagent fit review at assets/agents/loom-skill-enhancement-weave-out-subagent-fit-review.agent.md and return an explicit machine-readable weave_out_subagent_review plus target_skill_subagent_assets and target_skill_subagent_link_updates lists.",
          "resumeOutputKey": "weave_out_subagent_review",
          "requiredInputs": [
            "weave_out_subagent_review",
            "target_skill_subagent_assets",
            "target_skill_subagent_link_updates",
            "SKILL.md",
            "assets/so-workflow/node-to-file-map.md",
            "resolved_guide_surface",
            "plan.evidence_review",
            "assets/so-workflow/so-template.json"
          ],
          "outputBindings": {
            "target_skill_subagent_assets": "$context:target_skill_subagent_assets",
            "target_skill_subagent_link_updates": "$context:target_skill_subagent_link_updates"
          }
        }
      }
    },
    "transition.request_review": {
      "$kind": "command",
      "id": "transition.request_review",
      "name": "Request review feedback",
      "description": "Ask for approval or revision feedback after compile-generated audit artifacts are available.",
      "targetNodeId": "state.review_decision",
      "stepKind": "askUser",
      "ownedInputMode": "user",
      "command": {
        "kind": "tool",
        "name": "workflow.requestBootstrapFeedback",
        "environmentKey": "",
        "parameters": {
          "requiredInputs": [
            "approval_decision",
            "feedback_notes"
          ]
        }
      }
    },
    "transition.iterate_draft": {
      "$kind": "expr",
      "id": "transition.iterate_draft",
      "name": "Revise draft",
      "description": "Loop back when the user requests changes.",
      "targetNodeId": "state.plan",
      "stepKind": "conditionBranch",
      "guardExpression": "approval_decision == 'revise'",
      "succeedExpression": "approval_decision == 'revise'"
    },
    "transition.accept_draft": {
      "$kind": "expr",
      "id": "transition.accept_draft",
      "name": "Accept draft",
      "description": "Proceed when the user approves the workflow.",
      "targetNodeId": "state.review_fix_loop",
      "stepKind": "conditionBranch",
      "guardExpression": "approval_decision == 'approve'",
      "succeedExpression": "approval_decision == 'approve'"
    },
    "transition.run_review_fix_loop": {
      "$kind": "command",
      "id": "transition.run_review_fix_loop",
      "name": "Run review-fix loop",
      "description": "Run an explicit review-skill to fix-skill loop on the target skill, then prepare commit-and-report-ready evidence before the final blocked runtime handoff.",
      "targetNodeId": "state.wait_runtime",
      "outputPath": "review_fix_loop_evidence",
      "stepKind": "subagentCall",
      "publishesOutputFamilies": [
        "review_fix_loop_evidence",
        "commit_report_ready"
      ],
      "command": {
        "kind": "tool",
        "name": "workflow.invokeSubagentGapReview",
        "environmentKey": "",
        "parameters": {
          "subagentRelativePath": "assets/agents/loom-skill-enhancement-review-fix-loop.agent.md",
          "skillHint": "Run the dedicated review-fix-loop subagent at assets/agents/loom-skill-enhancement-review-fix-loop.agent.md and return both review_fix_loop_evidence and an independent commit_report_ready record for the final handoff.",
          "resumeOutputKey": "review_fix_loop_evidence",
          "requiredInputs": [
            "review_fix_loop_evidence",
            "commit_report_ready",
            "assets/so-workflow/so-template.json",
            "target_skill_subagent_link_updates",
            "workflow.mermaid.md",
            "weave_out_subagent_review",
            "approval_decision"
          ],
          "outputBindings": {
            "commit_report_ready": "$context:commit_report_ready"
          }
        }
      }
    },
    "transition.wait_runtime": {
      "$kind": "command",
      "id": "transition.wait_runtime",
      "name": "Publish blocked runtime outputs",
      "description": "Publish the blocked runtime outputs before final lock.",
      "targetNodeId": "state.lock",
      "outputPath": "workflow.current.json",
      "stepKind": "waitResume",
      "blockedRoutes": [
        "bootstrap_route"
      ],
      "satisfiesGateIds": [
        "gate.bootstrap_blocked_governance"
      ],
      "publishesBlockedOutputFamilies": [
        "workflow_runtime_copy_json",
        "workflow_mermaid_md",
        "workflow_html",
        "workflow_analysis_json"
      ],
      "command": {
        "kind": "tool",
        "name": "workflow.publishBlockedArtifacts",
        "environmentKey": "",
        "parameters": {
          "resumeOutputKey": "workflow_runtime_copy_json",
          "runtimeCopyPath": "workflow.current.json",
          "auditArtifactFamilies": [
            "workflow_runtime_copy_json",
            "workflow_mermaid_md",
            "workflow_html",
            "workflow_analysis_json"
          ]
        }
      }
    },
    "transition.finalize_lock": {
      "$kind": "command",
      "id": "transition.finalize_lock",
      "name": "Finalize completion manifest",
      "description": "Publish an external completion manifest after the blocked runtime review path succeeds. This runtime-owned step references checked-in source deliverables but does not claim to recreate them.",
      "targetNodeId": "state.done",
      "outputPath": "completion_manifest_reference",
      "stepKind": "toolCall",
      "terminalRoutes": [
        "bootstrap_route"
      ],
      "satisfiesGateIds": [
        "gate.bootstrap_done"
      ],
      "publishesOutputFamilies": [
        "workflow_template_json",
        "workflow_designer_dispatch_record",
        "weave_out_subagent_review",
        "target_skill_subagent_assets",
        "target_skill_subagent_link_updates",
        "review_fix_loop_evidence",
        "commit_report_ready",
        "checked_in_skill_markdown_asset",
        "checked_in_package_lock_asset",
        "node_to_file_map",
        "completion_manifest_reference",
        "completion_manifest_md"
      ],
      "command": {
        "kind": "tool",
        "name": "write-file",
        "environmentKey": "",
        "parameters": {
          "uniqueName": true,
          "path": ".tmp/loom-skill-enhancement-completion-manifest.md",
          "outputBindings": {
            "workflow_template_json": "$context:workflow_template_json",
            "workflow_designer_dispatch_record": "$context:workflow_designer_dispatch_record",
            "weave_out_subagent_review": "$context:weave_out_subagent_review",
            "target_skill_subagent_assets": "$context:target_skill_subagent_assets",
            "target_skill_subagent_link_updates": "$context:target_skill_subagent_link_updates",
            "review_fix_loop_evidence": "$context:review_fix_loop_evidence",
            "commit_report_ready": "$context:commit_report_ready",
            "checked_in_skill_markdown_asset": "SKILL.md",
            "checked_in_package_lock_asset": "assets/so-workflow/so-package-lock.json",
            "node_to_file_map": "assets/so-workflow/node-to-file-map.md",
            "completion_manifest_md": "$result"
          },
          "content": "Self-bootstrap completed. Checked-in governed deliverables: SKILL.md, assets/so-workflow/so-package-lock.json, assets/so-workflow/node-to-file-map.md. Compile-time audit deliverables remain external: workflow.mermaid.md, workflow.html, workflow.json, workflow.analysis.json."
        }
      }
    }
  }
}

{
  "name": "loom-skill-enhancement",
  "inputs": {
    "target_skill_path": "Required target skill root path. It must point at the skill directory that directly contains SKILL.md and assets/so-workflow/.",
    "goal": "Required deterministic skill creation or upgrade goal.",
    "requested_target_skill_changes": "Required description of target-skill files/contracts/assets to create or modify. This is the primary business-outcome contract.",
    "channel": "Derived package channel for the enhancement pass. Infer released versus beta from the checked-in SO package lock and the bound skill package version when needed; do not ask the user to choose a channel during normal SO enhancement runs.",
    "guide_language": "Optional language surface for package and guide links: en or zh-cn. If omitted, the current public guide surface defaults to en, so callers should pass zh-cn explicitly when they need Chinese guide links and should pass --lang <language> when invoking the guide command.",
    "context_file": "Optional path to a JSON context file.",
    "audit_output": "Optional audit output root."
  },
  "default_assumptions": {
    "package_index_source": "The source of truth for acquiring the Loom Skill Orchestrator package is the absolute URL of the released or beta package index page that matches the chosen language surface. A local runtime install path is only an execution detail when the agent needs to run so.dll, and that runtime must follow the skill-bound package version and its derived channel unless the capability is explicitly marked Beta Only.",
    "target_product_rule": "Any Loom Skill Orchestrator skill or target product that adopts Loom-bin-based skills must preserve released and beta package index absolute URLs in its own skill or product-facing docs, using localized mirrors when the product exposes localized package index pages.",
    "runtime_install_root": "If execution needs a local runtime, resolve the exact package version from NuGet first and freshly download it unless the local cache already holds that exact version, then install or unpack the runtime from the selected package channel into an external temporary directory outside the target repository. Use GitHub-hosted package assets only as fallback when NuGet.org is unavailable. On Windows PowerShell 5.1, treat .nupkg as ZIP content and do not use Expand-Archive directly on the .nupkg.",
    "runtime_bundle_restore": "When Loom Skill Orchestrator execution or target-skill restoration needs local NuGet acquisition, restore the Loom Skill Orchestrator runtime bundle instead of only the Loom Skill Orchestrator package: Techne.Loom.SkillOrchestrator, Techne.Loom.Common, and Techne.Loom.Abstractions, all at the same resolved channel/version.",
    "published_package_workflow_rule": "For /loom-skill-enhancement itself and any SO-enhanced target skill, official workflow operations must use the published SO package artifacts for the skill-bound version and derived channel as the normal execution surface. Do not use repository-source builds, ad hoc local project outputs, or hand-assembled runtime folders as the standard workflow-operation path unless a blocked-state emergency exception was explicitly approved.",
    "runtime_bundle_layout": "When local package-channel runtime execution is needed, resolve one exact Loom Skill Orchestrator bundle version first, acquire all three bundle packages in one pass, and extract them into one external unified runtime directory before any so.dll command. Do not probe or execute from partial single-package extraction roots.",
    "fresh_runtime_copy_rule": "Every new official SO run must start from a freshly copied external runtime workflow file derived from checked-in source workflow assets. Resume in that same execution chain must continue against that same persisted runtime copy. Do not execute by mutating the checked-in template in place.",
    "runtime_bundle_fallback": "If exact-version NuGet acquisition fails, reacquire that same three-package Loom Skill Orchestrator runtime bundle from GitHub fallback assets for the same resolved version, rebuild the same unified runtime directory, and only then continue with so.dll.",
    "runtime_startup_contract": "When package-channel runtime execution is used, so.dll, so.deps.json, and so.runtimeconfig.json are mandatory startup-contract files. Missing any of them is runtime-invalid and execution must fail fast before SO command dispatch.",
    "runtime_preflight_gate": "When package-channel runtime execution is used, run mandatory preflight checks for startup-contract files plus dependency-closure readiness (including System.Text.Json and Microsoft.Extensions.*) from the same unified runtime before any SO command. If extraction, file checks, or closure checks fail, stop immediately and keep runtime_preflight_result in a failed state.",
    "package_channel_launch_mode": "In package-channel mode, prefer dotnet exec --depsfile <so.deps.json> --runtimeconfig <so.runtimeconfig.json> <so.dll> ... for SO command dispatch instead of implicit host resolution.",
    "powershell_5_1_http_probe_rule": "When Windows PowerShell 5.1 uses Invoke-WebRequest or Invoke-RestMethod for package-channel HTTP probes, add -UseBasicParsing so runtime acquisition does not stall on legacy browser-engine security prompts.",
    "runtime_closure_materialization": "Build package-channel unified runtime from deterministic NuGet restore/publish closure materialization. Do not treat hand-merged three-package lib trees as sufficient closure evidence.",
    "business_scope_rule": "Loom Skill Orchestrator enhancement business is always to create or modify target skill deliverables. Runtime validation is supporting work and cannot replace target-skill delivery outputs.",
    "guide_freshness_rule": "Every enhancement pass must first prove that the selected published Loom Skill Orchestrator runtime is runnable and can emit dotnet so.dll --guide [--lang <language>] from that runtime before authoring, editing, validating, compiling, running, resuming, or collecting downstream inputs for target-skill deliverables. Do not reuse stale guide output from an earlier session or older package version. Failed command stderr or missing-runtime errors do not count as guide output and must not be saved as official guide evidence.",
    "runtime_execution_authority_rule": "If an SO-governed target-skill workflow is intended to become runnable execution authority, its materialized runtime workflow copy must execute on the current public dotnet so.dll run and dotnet so.dll resume path. Do not leave the runnable copy in Drafting, and do not depend on private or unavailable built-in tool names that the selected public runtime does not expose.",
    "checked_in_asset_boundary_rule": "When MemoryRead inspects checked-in target-skill assets, require an explicit asset root via assetRootInput or assetRootPath, load real file snapshots from disk, and reject absolute paths or traversal that escapes that declared root.",
    "meta_run_prohibition": "Loom Skill Orchestrator enhancement has no standalone meta-run completion path. Do not report completion from runtime-only validation when requested target-skill changes are missing.",
    "minimal_target_dependency_policy": "When the target project does not already have its own dependencies installed, install only the minimum dependency set required to complete the requested target-skill changes and current guide-aligned validation work. Do not widen into unrelated package restore or optional toolchain installation.",
    "think_out_loud_contract": "Once the package runtime is prepared and again on every Loom Skill Orchestrator progress update, think-out-loud must explicitly report resolved_runtime_version, runtime_bundle_packages, and unified_runtime_directory. On every Loom Skill Orchestrator progress update it must also explicitly report mermaid_file, html_file, and analysis_file from audit_artifacts when present.",
    "executor": "The AI agent executes dotnet so.dll compile/run/resume/status/inspect-workflow/inspect-events directly in the terminal.",
    "dll_interface_mapping": "Use only the public Loom Skill Orchestrator CLI surface from the guide that matches the skill-bound version, verify dotnet so.dll --help first, then verify the specific public subcommands you will actually use: dotnet so.dll --guide [--lang <language>], compile, run, resume, status, inspect-workflow, and inspect-events.",
    "so_workflow_root": "<target-skill-root>/assets/so-workflow/",
    "workflow_description_file": "<target-skill-root>/assets/so-workflow/skill-plan.md",
    "workflow_designer_agent": "Use .github/skills/loom-skill-enhancement/assets/agents/loom-skill-enhancement-workflow-designer.agent.md as the required local subagent for workflow generation or workflow revision, and pass relative-link context for guide files, package-index files, target SKILL.md, package lock, workflow JSON, and audit artifacts.",
    "package_lock_file": "<target-skill-root>/assets/so-workflow/so-package-lock.json",
    "package_lock_template_example": ".github/skills/loom-skill-enhancement/examples/so-package-lock.example.json",
    "workflow_description_granularity": "Fine-grained, derived from the current SKILL.md decision tree when it exists, or from goal plus supporting references when creating a greenfield skill, and then reviewed by the maintainer.",
    "plan_mode_before_editing": "Before target-skill deliverables are modified, analyze target skill inputs, outputs, state nodes, transition groups, guards, branches, loops, user seams, runtime seams, validation gates, and output evidence, then generate a workflow template and user-readable review plan.",
    "workflow_template_is_authority": "User feedback during plan review must be reflected in the workflow template or its source planning inputs. Mermaid, HTML, and localized plan prose are presentation layers and cannot be the only changed artifacts.",
    "workflow_json_edit_policy": "For /loom-skill-enhancement and any SO-enhanced target skill, normal workflow governance stays on dotnet so.dll --guide, compile, run, and resume. Do not treat checked-in workflow JSON as a routine direct-edit surface.",
    "workflow_json_blocked_override_only": "Direct workflow JSON edits are allowed only when the current SO path is fully blocked, the user explicitly approves a minimal workaround, the edit is the smallest change that unblocks the next dotnet so.dll compile/run/resume step, and the operator immediately returns to the SO-governed path.",
    "running_workflow_copy_edit_rule": "Manual edits to the running external workflow .json copy are last-resort blocked-state emergency workarounds only. They must not be treated as a normal workflow-operation path for /loom-skill-enhancement or any SO-enhanced target skill.",
    "compiled_analysis_artifact": "Each SO compile/run/resume audit step writes workflow.analysis.json next to workflow.mermaid.md, workflow.html, and workflow.json. The analysis report summarizes inputs, output families, branches, loops, seams, gates, and Turing-complete control risk.",
    "node_type_visualization": "Mermaid visualization derives light node background colors from workflow step kind semantics plus owned-input metadata: AI/model/subagent green, code/tool blue, user-owned optional branch choice yellow, required user input red, generic conditional branches amber/yellow, and gate/governance states white or very light gray.",
    "node_to_file_map": "Enhanced target skills should include a node-to-file or node-to-artifact map that connects workflow nodes to the target files, generated artifacts, or evidence records they govern.",
    "weave_out_subagent_review_rule": "Before completion, review every current weave-out and decide whether it should be implemented as a dedicated target-skill local subagent under assets/{skillname}-{taskname}.agent.md. When the answer is yes, create or refresh that subagent file and add relative-link references in the target SKILL.md and target reference docs before the workflow can complete.",
    "review_fix_loop_rule": "Before completion, run an explicit review-skill to fix-skill loop on the target skill, then produce commit-and-report-ready evidence rather than stopping at first-pass authoring or template compile.",
    "confirmation_loop": "Before execution, present the analysis report, compiled Mermaid, localized review plan, route gates, branch/loop summary, and node-to-file map to the user. Repeat by updating the workflow template and recompiling until the user confirms the workflow reflects the intended design.",
    "context_merge": "When references Markdown sources exist, concatenate references/*.md into a temporary merged-context.md working note with clear section headers, then convert the needed content into a temporary JSON context file for SO run context input.",
    "template_and_audit_layout": "Store the workflow template JSON separately. Unless the user explicitly chooses an audit destination, keep event_log, Mermaid, HTML, and workflow backups under a user-level temporary audit root instead of the target skill directory.",
    "template_node_governance": "Workflow templates must model explicit governed steps, guards, seams, and reviewable outputs. Never author or keep any node whose purpose says or implies run a multistep plan. Review templates for any node whose instruction embeds a multistep plan or a broad prompt to an agent, then split that work into explicit deterministic steps instead of hiding it behind a generic planner node.",
    "workflow_designer_granularity_rule": "Workflow-designer subagents for AO and SO must generate node-level granularity where each node owns one visible responsibility, no node hides a visible subflow, and every weave-out branch has a detailed blocked-action hint that cites local relative-link context when available.",
    "target_skill_agent_link_rule": "If SO enhancement introduces a target-skill local `{target-skill-name}-{task-name}.agent.md`, the target SKILL.md must reference that file with a relative link and the workflow template JSON weave-out hints or equivalent skill_hint guidance must reference the same file by relative path.",
    "governed_template_validation_contract": "For SO-governed target-skill templates, write root templateKind as so-governed-target-skill and add a root validation contract with gates, routes, declaredUserOwnedFields, and reservedRuntimeOwnedFields.",
    "business_output_gate_rule": "Terminal governed routes must satisfy declared business-output gates before done. Blocked governed routes must satisfy declared strongest-earned blocked-output gates before a runtime-owned wait boundary.",
    "seam_ownership_rule": "AskUser seams may request only declared user-owned fields or decisions. Runtime-owned facts, provenance, workflow paths, event-log paths, and audit artifact paths belong to runtime-owned seams such as WaitResume.",
    "locked_runtime_version": "After enhancement, write a machine-readable package lock file with the exact resolved SO NuGet version, channel, package identity, and runtime bundle members. When the enhanced target skill runs later, restore that exact locked SO runtime bundle from NuGet first, freshly downloading it unless the local cache already holds that exact version bundle.",
    "target_skill_lock_reference": "The enhanced target SKILL.md must explicitly reference <target-skill-root>/assets/so-workflow/so-package-lock.json as the authoritative SO runtime version lock and must state that routine SO runtime restoration resolves the exact locked runtime bundle from NuGet first, freshly downloading it unless the local cache already holds that exact version bundle.",
    "target_skill_json_edit_policy": "The enhanced target SKILL.md must explicitly state that ordinary workflow changes stay on the dotnet so.dll --guide/compile/run/resume path and that direct workflow JSON edits are blocked-state-only, user-approved emergency workarounds with immediate return to SO.",
    "target_skill_runtime_restore_policy": "The enhanced target SKILL.md must explicitly state that Windows PowerShell 5.1 package-channel restores treat .nupkg as ZIP content rather than using Expand-Archive directly, that package-channel HTTP probes add -UseBasicParsing when Invoke-WebRequest or Invoke-RestMethod are used, and that extraction or startup-contract failures must not be recorded as runtime_preflight_result passed.",
    "target_skill_published_package_rule": "The enhanced target SKILL.md must explicitly state that official workflow operations use the published SO package artifacts for the bound version and derived channel as the normal execution surface, and that repository-source builds or hand-assembled runtimes are not the default path.",
    "target_skill_runtime_copy_policy": "The enhanced target SKILL.md must explicitly state that every new official SO run starts from a freshly copied external runtime workflow file rather than the checked-in template itself, while resume continues against the same persisted runtime copy from that execution chain.",
    "reenhancement_upgrade_policy": "When the target skill needs another enhancement pass, do not ask the user to choose released versus beta. Use the exact version already bound to the current skill build and checked-in SO package lock, derive the channel from that version shape, reacquire that exact published runtime bundle, run dotnet so.dll --guide [--lang <language>] from that runtime before editing, and rewrite the package lock file only when the bound build version has changed.",
    "reenhancement_subagent_review": "For targets already enhanced by Loom Skill Orchestrator, strongly recommend a subagent review that compares the existing skill and workflow assets against the guide result captured from the current skill-bound runtime before editing.",
    "template_validation_gate": "Before the generated workflow template can become the execution authority for the enhanced target skill, the skill-bound published Loom Skill Orchestrator runtime must already be proven runnable with a fresh dotnet so.dll --guide result from that runtime, and the template must then be reviewed against that bound-version guide for completeness, detail, and the no-multistep-plan governance rule, and it must also pass dotnet so.dll compile --workflow-file <path>. If the governed workflow is intended to become runnable execution authority, its materialized runtime workflow copy must also be executable on the current public dotnet so.dll run and dotnet so.dll resume path rather than remaining a draft-only or compile-only artifact.",
    "template_validation_scope": "For SO-governed target-skill templates, compile success also requires the root validation contract, route-aware business-output gates, strongest-earned blocked-output declarations, and seam ownership declarations to pass compile and workflow-load validation.",
    "template_authority": "The reviewed workflow template JSON becomes the Loom Skill Orchestrator execution authority for the enhanced target skill after dotnet so.dll compile succeeds. If the governed workflow is intended to be runnable execution authority, the corresponding materialized runtime workflow copy must also be executable on the current public dotnet so.dll run and dotnet so.dll resume path.",
    "skill_markdown_shape": "Compress the enhanced SKILL.md to about 80-100 lines while preserving high-level steps, guardrail headings, Loom Skill Orchestrator guidance, and the ## Workflow Contract title.",
    "released_channel_wording": "If released artifacts do not provide the same Loom Skill Orchestrator enhancement surface, label that capability Beta Only.",
    "weave_out_policy": "Use structured blocked payload fields such as current_step_kind to classify WaitResume handling, and consume skill_hint literally as the next external action instruction. Ask the user only when the structured payload indicates mandatory human-input seams. For waits on email, files, messages, or downstream script results, treat the state as a valid external wait that either returns the expected next input shape to the user or pauses until the external result arrives. Continue automatically only when the structured payload plus literal skill_hint point to a non-human continuation.",
    "skill_layer_scope": "These defaults are skill-layer adaptation defaults rather than generic SO runtime guarantees. If the guide captured from the bound runtime version does not expose an equivalent surface, mark that behavior as Beta Only."
  },
  "outputs": {
    "package_index_link": "Absolute URL to the package index page that matches the bound runtime version and chosen language surface.",
    "package_index_links": "Released/beta package index absolute URL set, including localized mirrors when they exist.",
    "guide_link": "Absolute URL to so-guide.md.",
    "dll_interface_mapping": "Confirmed mapping between the skill runtime flow and Loom Skill Orchestrator public CLI commands used by the guide captured from the bound runtime version, including a recorded dotnet so.dll --help verification step and the specific subcommands used in the pass.",
    "package_lock_template_example": "Path to the standard SO package lock template example that enhanced target skills should follow.",
    "package_lock_file": "Machine-readable SO package lock file path with package identity, chosen channel, exact resolved version used for the enhancement pass, and runtime bundle members.",
    "checked_in_package_lock_asset": "Checked-in SO package lock asset path that remains the authoritative source deliverable for the enhancement slice.",
    "reenhancement_channel_confirmation": "When re-enhancing a target already enhanced by Loom Skill Orchestrator, record the derived released-or-beta channel evidence from the bound runtime version and package lock without a user prompt.",
    "guide_refresh_evidence": "Evidence that the selected published Loom Skill Orchestrator runtime was runnable and that dotnet so.dll --guide [--lang <language>] was run successfully from that runtime before enhancement edits, validation work, compile, run, resume, or downstream input collection. Missing startup-contract files, extraction failures, or failed guide commands must keep this evidence in a failed state rather than being emitted as a pseudo-success record.",
    "resolved_runtime_version": "Exact resolved SO bundle version used when local package-channel runtime acquisition was needed.",
    "runtime_bundle_packages": "SO runtime bundle package list used for enhancement-time and target-skill restoration: Techne.Loom.SkillOrchestrator, Techne.Loom.Common, and Techne.Loom.Abstractions.",
    "unified_runtime_directory": "External unified runtime directory that contains the extracted SO runtime bundle and is the only package-channel location from which so.dll is executed.",
    "target_skill_lock_reference": "Explicit checked-in SKILL.md reference to <target-skill-root>/assets/so-workflow/so-package-lock.json as the authoritative SO runtime version lock.",
    "checked_in_skill_markdown_asset": "Checked-in target SKILL.md asset path that remains the authoritative source deliverable for the enhancement slice.",
    "target_skill_json_edit_policy": "Explicit checked-in SKILL.md rule that ordinary workflow changes stay on dotnet so.dll and that direct workflow JSON edits are blocked-state-only, user-approved emergency workarounds with immediate return to SO.",
    "target_skill_runtime_copy_policy": "Explicit checked-in SKILL.md rule that every new official SO run starts from a freshly copied external runtime workflow file rather than the checked-in template itself, while resume continues against the same persisted runtime copy from that execution chain.",
    "target_skill_runtime_hardening": "The enhanced target SKILL.md must require package-channel startup-contract preflight (so.dll, so.deps.json, so.runtimeconfig.json), dependency-closure checks, explicit package-channel launch mode via dotnet exec --depsfile/--runtimeconfig for so.dll when applicable, ZIP-based .nupkg extraction on Windows PowerShell 5.1, and a fail-fast rule that forbids pseudo-success runtime proof or guide exports after extraction or startup-contract failures.",
    "requested_target_skill_changes": "Requested target-skill files/contracts/assets that must be created or modified in this enhancement pass.",
    "workflow_validation_contract": "For SO-governed target-skill workflows, root templateKind plus validation.gates, validation.routes, validation.declaredUserOwnedFields, and validation.reservedRuntimeOwnedFields.",
    "route_output_gate_evidence": "Route-aware evidence that done paths satisfy declared business-output gates and blocked paths satisfy declared strongest-earned blocked-output gates.",
    "workflow_template": "Deterministic workflow JSON template path. This template only becomes the execution authority for the enhanced target skill after guide-alignment review, no-multistep-plan governance review, and dotnet so.dll compile succeed.",
    "workflow_analysis_report": "workflow.analysis.json path containing generated analysis of inputs, outputs, branches, loops, seams, gates, and Turing-complete control risk.",
    "workflow_designer_dispatch_record": "Record that the required local workflow-designer subagent was dispatched for template generation or revision, including the relative-link context set used for that dispatch.",
    "weave_out_subagent_review": "Review summary that decides whether each current weave-out should become a dedicated target-skill local subagent and records the required subagent-definition follow-up.",
    "target_skill_subagent_assets": "Target-skill local subagent definition files created or refreshed under assets/ as a result of the weave-out suitability review.",
    "target_skill_subagent_link_updates": "Relative-link updates applied to the target SKILL.md and target reference docs for any target-skill local weave-out subagent files introduced by this enhancement pass.",
    "localized_review_plan": "User-readable workflow and implementation review plan in the requested language when that language is not English.",
    "compiled_mermaid": "Compiled Mermaid Markdown path generated from the workflow template, including node-type coloring derived from step kind semantics.",
    "confirmation_loop_transcript": "Record of user feedback rounds and the workflow-template changes made in response before execution approval.",
    "review_fix_loop_evidence": "Evidence from the explicit review-skill to fix-skill loop run before completion, including the final reviewed delta and the resulting target-skill corrections.",
    "node_to_file_map": "Machine-readable or Markdown evidence map from workflow node ids to target files, generated artifacts, or audit records.",
    "event_log_file": "SO event log path.",
    "audit_artifacts": "Mermaid Markdown, HTML, workflow JSON backup, and workflow analysis links.",
    "completion_manifest_reference": "Runtime-owned completion-manifest path that references checked-in source deliverables without overwriting them.",
    "completion_manifest_md": "Runtime-owned completion-manifest file path used as the human-reviewable terminal artifact for the completion_manifest_md output family.",
    "commit_report_ready": "Completion-time report evidence that the target skill is ready for commit and reporting handoff after the required review-fix loop.",
    "published_package_workflow_evidence": "Evidence that workflow operations for /loom-skill-enhancement or the enhanced target skill used the published SO package artifacts for the bound runtime version and derived channel rather than repository-source builds or hand-assembled runtimes.",
    "runtime_preflight_result": "Mandatory package-channel preflight result that covers startup-contract file checks and dependency-closure readiness checks before SO command dispatch.",
    "package_channel_launch_mode": "Effective SO launch mode in package-channel execution, including explicit dotnet exec --depsfile/--runtimeconfig usage when applicable.",
    "completion_by_target_skill_changes": "Completion requires the requested target-skill deliverables to be created or modified. Runtime-only validation artifacts are insufficient completion evidence.",
    "think_out_loud_runtime_summary": "Think-out-loud must explicitly report resolved_runtime_version, runtime_bundle_packages, and unified_runtime_directory after runtime preparation and on every Loom Skill Orchestrator progress update.",
    "think_out_loud_audit_paths": "Think-out-loud must explicitly report mermaid_file, html_file, and analysis_file on every Loom Skill Orchestrator progress update instead of hiding them inside a generic audit summary.",
    "latest_guide_review": "When performed, a subagent review summary comparing the current target skill and workflow assets against the guide result captured from the current skill-bound runtime.",
    "template_governance_evidence": "Evidence that the workflow template uses explicit governed steps, guards, seams, reviewable outputs, route-aware business-output gates, and ownership-safe seams, with no node intent that says or implies run a multistep plan."
  }
}

{
  "package_id": "Techne.Loom.SkillOrchestrator",
  "channel": "released",
  "resolved_version": "1.2.3",
  "runtime_bundle": [
    {
      "package_id": "Techne.Loom.SkillOrchestrator",
      "resolved_version": "1.2.3"
    },
    {
      "package_id": "Techne.Loom.Common",
      "resolved_version": "1.2.3"
    },
    {
      "package_id": "Techne.Loom.Abstractions",
      "resolved_version": "1.2.3"
    }
  ],
  "runtime_restore": {
    "source": "nuget",
    "fresh_download": true,
    "allow_local_cache_when_exact_version_matches": true,
    "fallback_source": "github-release-asset"
  },
  "enhancement": {
    "resolved_at_utc": "2026-06-12T00:00:00Z",
    "selected_language": "en"
  },
  "notes": [
    "Resolve the exact version bundle from NuGet first.",
    "Freshly download the full runtime bundle unless the local cache already holds the exact same bundle version.",
    "Do not restore only Techne.Loom.SkillOrchestrator; always restore Techne.Loom.Common and Techne.Loom.Abstractions with it.",
    "Use GitHub release assets only when NuGet.org is unavailable."
  ]
}