orch-build-workflow ยท diff
git:20260912.6f12494 to git:20260912.83dcd5f
4 added, 4 removed. Audit A to A.
---
name: orch-build-workflow
description: Create or improve a native workflow skill, then try it on a real request and refine it from observed behavior.
---
- Identify the recurring request and what a useful result would look like. Reserve the `orch-` prefix for built-ins; give custom workflows their own names. Follow [architecture](../../docs/architecture.md); resolve the home and library with the [home CLI](../../docs/home.md) when needed. Default new workflows to `HOME/libraries/personal/skills/WORKFLOW/`, or the caller's selected library; honor an explicit destination such as a repository example path. Preserve existing library content. Home authoring and native host discovery are separate; use the actual host registration and refresh procedure before claiming the skill is available by name.
+ Name the recurring request and useful result. Use the caller's location, otherwise the selected [home](../../docs/home.md)'s `libraries/personal/skills/<workflow>/`. Create missing root and native library manifests. Compose existing skills; keep needed scripts and references with their owner and declare runtime dependencies in the library.
- Use [orch-work](../orch-work/SKILL.md) to author the workflow under [Writing](../../standards/writing.md) and any relevant domain standards, then [orch-review](../orch-review/SKILL.md) to inspect it. Address substantive findings with the maker and check the revised result. Compose existing skills where useful; keep supporting scripts or references local to the workflow and add them only when they help. Resolve core dependencies at the library boundary through the installed CLI and pass concrete paths onward; internal links stay inside the authored package. Declare its runtime dependencies alongside the library rather than relying on the current project or authoring checkout.
+ Author through [orch-work](../orch-work/SKILL.md) under `writing` and relevant domain [guidance](../../docs/architecture.md#guidance-selection), then inspect through [orch-review](../orch-review/SKILL.md). Return substantive findings to the maker and check the revision. Resolve package dependencies at the outer boundary and pass concrete paths onward; internal links stay inside the authored package.
- Run a stable candidate on a real, bounded request in a disposable workspace using the available native capabilities. For a portable library, invoke its entrypoint from an unrelated project with an ordinary user brief and its declared dependencies. Let the skill supply its own orchestration; record author preparation and intervention as limits of the trial. Keep side effects within the user's existing authorization. Inspect the actual result against the requested outcome and scope, including missed steps, unnecessary instructions and capability limits. Plausible prose and valid frontmatter do not establish useful behavior.
+ Run a stable candidate on a real, bounded request in a disposable workspace using available native capabilities. For a portable library, invoke its entrypoint from an unrelated project with an ordinary user brief and its declared dependencies. Let the skill supply its orchestration; record author preparation and intervention as trial limits. Keep side effects within the user's existing authorization. Inspect the actual result against the request, including missed steps, unnecessary instructions and capability limits. Valid frontmatter does not establish useful behavior.
- Use that evidence to simplify or repair the skill, rerunning the affected part when needed. Deliver the skill with what the trial demonstrated and what remains untested.
+ Use that evidence to simplify or repair, rerunning the affected behavior when needed. Preserve necessary failure handling that the trial did not exercise. Deliver with what the trial demonstrated and what remains untested. Invocation by name requires host registration and refresh ([hosts.md](../../docs/hosts.md)).