Techne Loom

中文

---

<<<<<<< development

🚀 Release Notes · v0.2.171-beta · June 2026

=======

🚀 Release Notes · v0.2.170 · June 2026

main

Note

Stable release — synced by publish actions. Install the latest stable: dotnet add package Techne.Loom.SkillOrchestrator Full package list → packages.released.md

✨ Channel Highlights

Area	Change
🔄 Version sync	This block is refreshed by the publish workflow so the version shown here matches the latest published stable package set
📦 Fallback assets	GitHub release aliases keep stable *.latest.nupkg URLs available when direct NuGet feed access is unavailable
🔎 Package discovery	NuGet.org and packages.released.md remain the source of truth for install commands and exact stable version guidance; when an exact package id/version is already known, probe the direct .nupkg URL instead of waiting for indexing

📦 Packages In This Release

<<<<<<< development
Techne.Loom.Abstractions          0.2.171-beta
Techne.Loom.Common                0.2.171-beta
Techne.Loom.AgentOrchestrator     0.2.171-beta
Techne.Loom.SkillOrchestrator     0.2.171-beta

This section is updated automatically after each development publish. Check NuGet.org, packages.beta.md, or the beta fallback release for latest-version guidance. When the exact package id/version is already known, probe the direct package URL such as https://www.nuget.org/api/v2/package/Techne.Loom.SkillOrchestrator/0.2.171-beta instead of waiting for indexing. ======= Techne.Loom.Abstractions 0.2.170 Techne.Loom.Common 0.2.170 Techne.Loom.AgentOrchestrator 0.2.170 Techne.Loom.SkillOrchestrator 0.2.170

> This section is updated automatically after each main-branch publish.
> Check [NuGet.org](https://www.nuget.org/packages/Techne.Loom.SkillOrchestrator), [`packages.released.md`](packages.released.md), or the [stable fallback release](https://github.com/waynebaby/Techne-Loom/releases/tag/nuget-stable-latest) for latest-version guidance. When the exact package id/version is already known, probe the direct package URL such as `https://www.nuget.org/api/v2/package/Techne.Loom.SkillOrchestrator/0.2.170` instead of waiting for indexing.
>>>>>>> main

### 🔭 Coming Next

- Stable `so.dll --guide` and `ao.dll --guide` offline guide surfaces with version metadata
- Explicit public contracts for workflow, control-state, and hint payloads
- Node.js and Python package scaffolding alongside the .NET family
- Cleaner AO / SO CLI resume flows with `transition_id` and `correlation_key` examples

---
<!-- release-notes:end -->



## Govern Skills That Must Survive Production

![Release](https://img.shields.io/badge/release-focus%3A%20SO%20skills-0F766E)
![AO](https://img.shields.io/badge/AO-beta-F59E0B)
![Runtime](https://img.shields.io/badge/runtime-.NET%20first-512BD4)
![Docs](https://img.shields.io/badge/docs-bilingual-0EA5E9)
![NuGet](https://img.shields.io/badge/distribution-NuGet-004880)

> [!IMPORTANT]
> Techne Loom's primary released product is the **Loom-governanced skill**.
> It ships with a checked-in workflow contract, a locked runtime bundle, resumable execution, and audit-ready artifacts.

Most teams need skills that can survive interruption, handoff, review, and production scrutiny.

Techne Loom is built to give teams operational control.

## Why Teams Switch

Teams change their skill operating model when trust collapses.

This is what collapse looks like:

- the skill keeps producing output after it has already drifted off the intended path
- human handoff destroys the real execution state
- resume depends on chat memory instead of durable workflow state
- nobody can prove which step was skipped, repeated, or mutated
- audit begins only after evidence has already been blurred

At that point, the team no longer trusts the run.

## The Product To Adopt First

Start with `/loom-skill-enhancement`.

It turns a prompt-shaped skill into a governed production asset.

It gives a team a skill that can:

- carry a checked-in workflow contract
- lock the exact runtime bundle it depends on
- run from a tracked workflow copy outside the skill folder
- stop with a strict boundary payload instead of vague prose
- resume with structured inputs instead of conversational guesswork
- emit Mermaid, HTML, and workflow JSON artifacts for review and audit

Adoption gives teams control.

## Unenhanced Skill Vs Loom-Governanced Skill

| Dimension | Unenhanced skill | Loom-governanced skill |
| --- | --- | --- |
| workflow control | implied in prompt behavior | checked-in workflow contract |
| runtime dependency | assumed or loosely documented | exact bundle lock in `so-package-lock.json` |
| mutable execution state | scattered across chat and operator memory | tracked runtime workflow copy |
| interruption handling | ad hoc retry or re-prompt | explicit boundary and structured resume |
| auditability | reconstructed after the fact | emitted step artifacts during execution |
| operator trust | personality-driven | contract-driven |

## What Failure Looks Like Without SO Enhancement

Without SO enhancement, the worst outcome is a skill that keeps moving after the team has lost the ability to defend what it is doing.

Real production-grade examples:

- An approval skill forgets which review branch it was on, asks the wrong approver again, and creates duplicated human sign-off loops with no durable seam showing where confusion started.
- A release skill resumes from chat memory, skips artifact verification, and publishes the wrong package because the operator assumed the previous checkpoint had already passed.
- A migration skill keeps mutating files after an interrupted run, but there is no external runtime copy, no event trail, and no point-in-time workflow backup to prove which edits belonged to which attempt.
- A compliance skill pauses mid-evidence collection and leaves only vague prose, so the next operator resumes with the wrong assumption and quietly contaminates the audit trail.
- A support or incident skill drifts through multiple handoffs until no one can produce an exact boundary payload, stable memory handoff, or defensible replay story.

That creates production liability.

## What Changes After Adoption

After adopting `/loom-skill-enhancement`, the same scenarios become governable.

- approval loops become visible workflow errors with explicit blocked seams
- skipped release checks become reviewable workflow violations instead of silent production surprises
- interrupted migrations produce durable runtime copies, workflow backups, and event trails
- compliance pauses state exactly what input is missing and what evidence state existed before the stop
- support handoffs resume from workflow state and boundary memory, not from folklore

These incidents become diagnosable, resumable, reviewable, and defensible.

## In One Line

**`/loom-skill-enhancement` is the fastest path from prompt-shaped skill behavior to released, auditable, tracked production execution.**

## Why The Skill Matters More Than The Raw Runtime

The runtime is infrastructure. The skill is what the operator has to trust.

A production-facing skill must do more than run. It must:

- follow a reviewed workflow
- expose the next step clearly
- stop at the correct external seam
- preserve context for the next turn
- leave artifacts that survive review

The skill enhancer leads the story. Loom Skill Orchestrator governance makes the skill governable.

## The Release Story

Today, the major released path is:

1. **SO as the deterministic runtime**
2. **Loom-governanced skills as the operator-facing product**
3. **Tracked, audit-first execution as the default model**

Loom Agent Execution Orchestrator and `/loom-plan-execution` still matter. They currently belong in the beta exploratory layer.

## What A Loom-Governanced Skill Ships With

A Loom-governanced skill ships with:

- a checked-in `SKILL.md`
- a checked-in workflow template under `assets/so-workflow/`
- an authoritative runtime lock file at `assets/so-workflow/so-package-lock.json`
- deterministic `dotnet so.dll run` and `dotnet so.dll resume` execution
- Mermaid, HTML, and workflow JSON audit artifacts for each step
- strict boundary payloads with `skill_hint`, `memory_for_next_step`, and required continuation inputs

## Start Fast

### Run A Released Loom-Governanced Skill

1. Start from [packages.released.md](packages.released.md).
2. Restore the released SO runtime bundle: `Techne.Loom.SkillOrchestrator`, `Techne.Loom.Common`, and `Techne.Loom.Abstractions`.
3. Open the target skill's `SKILL.md`.
4. Read `assets/so-workflow/so-package-lock.json`.
5. Restore the exact locked SO runtime bundle from NuGet.
6. Clone the checked-in workflow template to a runtime workflow copy outside the skill folder.
7. Run `dotnet so.dll run --workflow-file <runtime-copy-path>`.
8. If blocked, follow `skill_hint` and continue with `dotnet so.dll resume --workflow-file <runtime-copy-path> --result-file <path>`.

```text
Read SKILL.md -> read so-package-lock.json -> restore exact SO runtime bundle -> clone workflow template -> dotnet so.dll run -> inspect audit artifacts -> dotnet so.dll resume

Create Or Upgrade A Released Loom-Governanced Skill

1. Start from packages.released.md for stable work.
2. Use /loom-skill-enhancement.
3. Read Using Techne Loom Skills.
4. Read SkillOrchestrator Guide.
5. Let the enhancement flow produce the checked-in workflow assets and runtime lock.

/loom-skill-enhancement -> review skill-plan -> review workflow template -> review runtime lock -> run the enhanced skill with dotnet so.dll

How Governed Execution Stays On Track

Legend: 👤 operator action, 🧩 skill surface, 📦 runtime lock, ⚙️ runtime execution, 🧾 audit evidence.

sequenceDiagram
    autonumber
    actor Operator as 👤 Operator
    participant Skill as 🧩 Loom-Governanced Skill
    participant Lock as 📦 so-package-lock.json
    participant Runtime as ⚙️ dotnet so.dll
    participant Audit as 🧾 Audit Artifacts

    Operator->>Skill: 👤 Read SKILL.md and operating contract
    Operator->>Lock: 👤 Read exact runtime version lock
    Operator->>Runtime: 👤 Restore locked SO runtime bundle
    Operator->>Runtime: 👤 Run workflow copy outside the skill folder
    Runtime->>Audit: ⚙️ Write Mermaid, HTML, and workflow JSON backups
    Runtime-->>Operator: ⚙️ Progress payload with workflow and artifact paths
    alt External seam reached
        Runtime-->>Operator: ⚙️ Boundary payload with skill_hint and memory_for_next_step
        Operator->>Runtime: 👤 Resume with a structured result envelope
        Runtime->>Audit: ⚙️ Append next-step audit artifacts
    else Workflow completed
        Runtime-->>Operator: ⚙️ Completed result payload
    end

Loading

Execution stays on track because the next step is explicit, the mutable workflow copy is persisted, and the resume boundary is structured instead of improvised.

How The Skill Holds Up Under Audit

A Loom-governanced skill is not only executable. It is inspectable under pressure.

Every serious step can leave:

• a Mermaid rendering of the point-in-time workflow
• an HTML rendering for human inspection
• a workflow JSON backup for exact replay context
• boundary payloads that show why the skill stopped and what it needed next

Legend: 📜 checked-in contract, ⚙️ runtime execution, ✅ progress or completion output, 🚧 boundary state, 🔁 continuation action, 🧾 audit evidence.

flowchart TD
    A[📜 Checked-in skill contract] --> B[📜 Checked-in workflow template]
    B --> C[⚙️ Runtime workflow copy outside skill folder]
    C --> D[⚙️ dotnet so.dll run]
    D --> E[✅ Progress payload]
    D --> F[🚧 Boundary payload]
    D --> G[✅ Completed payload]
    E --> H[🧾 Mermaid audit artifact]
    E --> I[🧾 HTML audit artifact]
    E --> J[🧾 Workflow JSON backup]
    F --> K[🚧 skill_hint]
    F --> L[🚧 memory_for_next_step]
    F --> M[🚧 required_inputs]
    K --> N[🔁 Structured external action]
    N --> O[⚙️ dotnet so.dll resume]
    O --> H
    O --> I
    O --> J

    classDef contract fill:#E0F2FE,stroke:#0284C7,color:#0C4A6E;
    classDef runtime fill:#FEF3C7,stroke:#B45309,color:#78350F;
    classDef output fill:#DCFCE7,stroke:#15803D,color:#14532D;
    classDef boundary fill:#FFEDD5,stroke:#EA580C,color:#9A3412;
    classDef audit fill:#EDE9FE,stroke:#6D28D9,color:#4C1D95;

    class A,B contract;
    class C,D,O runtime;
    class E,G output;
    class F,K,L,M boundary;
    class H,I,J audit;

    class N boundary;

Loading

That means operator questions are answered with artifacts instead of memory:

• What exact step did the skill stop at?
• Why did it stop?
• What input resumed it?
• What workflow shape existed at that point?

Pick The Path That Matches Your Situation

If you want to...	Start from...	What it means	Example
run a skill that has already been enhanced and released	a released Loom-governanced skill	the skill already has its checked-in workflow assets and runtime lock	Example: "Run this released skill. If it blocks and needs my input, ask me first. If you can resolve it, continue the resume flow."
turn your own skill into something releasable and governed	your target skill with /loom-skill-enhancement	this is the path that generates the future Loom-governanced version of your skill	Example: "Enhance this skill with /loom-skill-enhancement, create the workflow template, and let me review it with friendly output."
explore a route before the workflow is stable	/loom-plan-execution	this is still the beta Loom Agent Execution Orchestrator exploratory layer	Example: "Use /loom-plan-execution to translate the full plan we already made into a workflow, then use that workflow to track the run until the final successful outcome is generated."

Read first:

• released skill run: Using Techne Loom Skills
• skill enhancement path: Using Techne Loom Skills, then SO Guide
• beta exploration path: Loom Agent Execution Orchestrator Guide

Stable Operating Rules

1. Direct CLI or manual package acquisition chooses package channel first; governed AO/SO skill execution should instead follow the runtime version already bound by the current CI/CD-managed skill package version block or checked-in runtime lock.
2. Direct stable/manual skill runs default to packages.released.md; direct prerelease/manual runs default to packages.beta.md.
3. Restore the full runtime bundle, never only the main runtime package.
4. Keep runtime workflow copies, session state, event sidecars, and audit artifacts outside checked-in skill folders.
5. Treat the checked-in skill workflow template as immutable source.
6. Treat checked-in SKILL.md, contract.json, and assets/so-workflow/ surfaces as the normative governance contract. Treat demo timelines and recorded-slice narratives as historical records: they explain what happened in a slice, but they do not redefine the current governed completion contract unless the normative target-skill assets say so.

Official Guides

Use these guide surfaces as the operator contract:

• dotnet so.dll --guide
• Using Techne Loom Skills
• SkillOrchestrator Guide
• Loom-Governanced Skill Run Example
• Skills Input/Output Reference

Loom Agent Execution Orchestrator Remains Beta

Loom Agent Execution Orchestrator and /loom-plan-execution remain important, but they belong to the beta exploratory layer.

Use Loom Agent Execution Orchestrator when:

• the route is still unclear
• the top-level agent needs to compare frontiers
• the workflow is not yet stable enough to become a deterministic skill

Read Loom Agent Execution Orchestrator through these beta surfaces:

• Loom Agent Execution Orchestrator Guide
• CLI Reference
• Agent Integration

Package-First, Multi-Ecosystem Direction

Role	NuGet	npm	PyPI
Abstractions	Techne.Loom.Abstractions	@techne-loom/abstractions	techne-loom-abstractions
Common	Techne.Loom.Common	@techne-loom/common	techne-loom-common
Loom Agent Execution Orchestrator runtime	Techne.Loom.AgentOrchestrator	@techne-loom/agent-orchestrator	techne-loom-agent-orchestrator
SO runtime	Techne.Loom.SkillOrchestrator	@techne-loom/skill-orchestrator	techne-loom-skill-orchestrator

Node.js and Python package names are still planned, not yet fully implemented runtime surfaces.

Read Next

• Using Techne Loom Skills
• SO Guide
• Loom-Governanced Skill Run Example
• Demo Index
• loom-enhanced-research Demo Timeline
• Skills Input/Output Reference
• Loom Agent Execution Orchestrator Guide
• AGENTS.md

Techne Loom is not trying to make agent systems sound magical. It is trying to make Loom-governanced skills hard to dismiss.