/silver:new-workflow — Workflow Authoring

Overview

/silver:new-workflow is the SB queue builder for workflow and atomic-flow authoring. Catalog id: WF-SILVER-NEW-WORKFLOW. In Create and Convert modes the parent orchestrator spawns workers per atomic flow — do not implement catalog changes inline in parent mode.

Audit mode is different: it runs inline, read-only, with no orchestrator queue, plan, review-fix ladder, or implementation steps.

Canonical contracts: docs/apo-catalog.json, docs/composable-flows-contracts.md, docs/APO-AUTHORING-COMPLIANCE.md. Full runbook: docs/NEW-WORKFLOW.md.

Modes

Mode	When	Outcome
Create	User describes a new workflow intent	New composer skill + `WF-*` catalog entry + hooks/tests
Convert	User names an existing skill path (no audit intent)	Gap review → compliant SB workflow + catalog registration
Audit	User names workflow id, slug, or `SKILL.md` with audit intent	Read-only compliance report under `.planning/`; no catalog edits

Mode detection from $ARGUMENTS:

Audit when --audit, --validate, audit/validate prefix, a WF-SILVER-* id, composer slug with audit intent, or SKILL.md path with audit intent.
Convert when the argument is a filesystem path or skills/…/SKILL.md without audit intent.
Create otherwise.

Create mode

Start with a natural-language workflow intent. SB orients against the APO catalog, plans composition and enforcement surfaces, runs review-fix ladder on the plan, implements skill + catalog + hooks, then validates.

/silver:new-workflow Add a workflow for onboarding new contributors

Default target repo is the current workspace unless the user names another path (recorded in .planning/new-workflow-session.json).

Convert mode

Pass a path to an existing skill or workflow definition. SB produces a gap matrix, maps steps to catalog atomic flows, then follows the same plan → RFL → implement → validate path as Create.

/silver:new-workflow skills/my-legacy-skill/SKILL.md

Audit mode (read-only)

Audit mode resolves the target workflow, runs scripts/audit-workflow-compliance.sh, and writes .planning/workflow-audit-<slug>-<date>.md. It does not edit skills, hooks, or catalog entries.

Target resolution

Input form	Example	Resolved
Workflow id	`WF-SILVER-FEATURE`	`silver-feature`
Composer slug	`silver-feature` or `feature`	`WF-SILVER-FEATURE`
SKILL path	`skills/silver-new-workflow/SKILL.md`	`WF-SILVER-NEW-WORKFLOW`

Compliance categories

Each category reports PASS/FAIL with remediation links:

structural — skill, catalog generator, workflow entry, orchestrator registration
migration_map — skill_to_entity mapping
catalog — composition_tree, enforcement_queue
triple_alignment — SKILL pre-exec ↔ workflow-chain-guard.sh ↔ orchestrator pre-execute
orchestrator — composer in hooks/lib/orchestrator-state.sh
flow_steps — mapped entity V-loop / flow-step contract

Read-only: Audit mode never runs plan, review-fix ladder, or implement steps. Use Create or Convert to fix FAIL findings.

Invocation examples

/silver:new-workflow --audit WF-SILVER-FEATURE
/silver:new-workflow --audit silver-feature
/silver:new-workflow --audit feature
/silver:new-workflow --validate skills/silver-new-workflow/SKILL.md
/silver:new-workflow audit WF-SILVER-NEW-WORKFLOW

/silver:new-workflow Add catalog workflow for API contract checks
/silver:new-workflow skills/my-legacy-skill/SKILL.md

The router also recognizes audit intent: /silver routes phrases like “audit workflow” or “validate workflow compliance” to silver:new-workflow --audit <target>.

Compliance scripts

Shell entry points (repo root):

bash scripts/audit-workflow-compliance.sh --target WF-SILVER-FEATURE
bash scripts/audit-workflow-compliance.sh --slug new-workflow
bash scripts/validate-workflow-authoring.sh --audit --target silver-feature
bash tests/scripts/test-silver-new-workflow-audit.sh

Broader authoring suite: bash scripts/run-apo-authoring-compliance.sh. See docs/NEW-WORKFLOW.md for the full regenerate and validate checklist.

← Previous/silver:validate Next →/silver:feature