feat(registry): workflow registry system — named registries, versioning, caching

.claude/skills/conductor/SKILL.md

@@ -30,8 +30,9 @@ conductor run workflow.yaml --log-file auto               # Log full debug outpu
 conductor run workflow.yaml --web --input q="Hello"       # Real-time web dashboard
 conductor run workflow.yaml --web-bg --input q="Hello"    # Background mode (prints URL, exits)
 conductor validate workflow.yaml                         # Validate only
-conductor init my-workflow --template simple              # Create from template
-conductor templates                                      # List templates
+conductor registry add official myorg/workflows --default # Add a registry
+conductor registry list official                          # List registry workflows
+conductor run qa-bot@official@1.0.0 --input q="Hello"    # Run from registry
 conductor stop                                           # Stop background workflow
 conductor update                                         # Check for and install latest version
 conductor resume workflow.yaml                           # Resume from last checkpoint
@@ -102,5 +103,6 @@ For runtime config, context modes, limits, and cost tracking, see [references/au
 | `runtime` | Provider, model, temperature, max_tokens, MCP servers |
 | `--web` | Real-time web dashboard with DAG graph, live streaming, in-browser human gates |
 | `checkpoint` | Auto-saved on failure; resume with `conductor resume` |
+| `registry` | Named workflow sources (GitHub repo or local dir) for sharing workflows |
 
 For pattern examples (linear, loop, conditional, parallel, for-each, human gate) and template syntax, see [references/authoring.md](references/authoring.md).

.claude/skills/conductor/references/execution.md

@@ -195,40 +195,45 @@ Checks:
 - Parallel group agent references
 - For-each source format and reserved names
 
-### conductor init
+### conductor registry
 
-Create workflow from template:
+Manage workflow registries — named sources of shared workflows (GitHub repos or local directories).
 
 ```bash
-conductor init <name> [OPTIONS]
+conductor registry <subcommand> [OPTIONS]
 ```
 
-| Option | Description |
-|--------|-------------|
-| `--template`, `-t TEMPLATE` | Template to use (default: simple) |
-| `--output`, `-o PATH` | Output file path |
+| Subcommand | Description |
+|------------|-------------|
+| `list [name]` | List registries, or workflows in a specific registry |
+| `add <name> <source>` | Add a registry (`--type github\|path`, `--default`) |
+| `remove <name>` | Remove a registry |
+| `set-default <name>` | Set the default registry |
+| `update [name]` | Refresh index and re-resolve latest versions |
+| `show <ref>` | Show metadata for a workflow reference |
 
 **Examples:**
 
 ```bash
-conductor init my-workflow
-conductor init my-workflow --template loop
-conductor init review -t human-gate -o ./workflows/review.yaml
+conductor registry add official myorg/conductor-workflows --default
+conductor registry add local /path/to/workflows --type path
+conductor registry list                        # show configured registries
+conductor registry list official               # show workflows in a registry
+conductor registry set-default official
+conductor registry update                      # refresh all indexes
+conductor registry show qa-bot@official@1.0.0  # show workflow metadata
 ```
 
-### conductor templates
-
-List available templates:
+**Running from a registry:**
 
 ```bash
-conductor templates
+conductor run qa-bot                     # latest from default registry
+conductor run qa-bot@official            # latest from named registry
+conductor run qa-bot@official@1.2.3      # explicit version
+conductor run qa-bot@@1.2.3              # explicit version from default registry
 ```
 
-| Template | Description |
-|----------|-------------|
-| `simple` | Single agent with basic I/O |
-| `loop` | Iterative refinement pattern |
-| `human-gate` | Workflow with approval gate |
+Registry workflows are cached locally at `~/.conductor/cache/registries/` and reused on subsequent runs. Explicit versions are immutable; `latest` is re-resolved on `conductor registry update`.
 
 ## Execution Flow
 

README.md

@@ -207,23 +207,29 @@ Validate a workflow file without executing.
 conductor validate <workflow.yaml>
 ```
 
-### `conductor init`
-
-Create a new workflow from a template.
+**Full CLI documentation:** [docs/cli-reference.md](docs/cli-reference.md)
 
-```bash
-conductor init <name> --template <template> --output <path>
-```
+## Workflow Registries
 
-### `conductor templates`
+Conductor supports named workflow registries — GitHub repos or local directories
+containing shared workflows. Configure a registry once, then run workflows by
+short name.
 
-List available workflow templates.
+### Quick start
 
 ```bash
-conductor templates
+# Add a registry
+conductor registry add official myorg/conductor-workflows --default
+
+# List available workflows
+conductor registry list official
+
+# Run a workflow from the registry
+conductor run qa-bot                    # latest from default registry
+conductor run qa-bot@official@1.2.3    # specific version
 ```
 
-**Full CLI documentation:** [docs/cli-reference.md](docs/cli-reference.md)
+See [docs/design/registry.md](docs/design/registry.md) for the full design.
 
 ## Examples
 

docs/cli-reference.md

@@ -7,8 +7,7 @@ Complete command-line reference for Conductor.
 - [`conductor run`](#conductor-run)
 - [`conductor stop`](#conductor-stop)
 - [`conductor validate`](#conductor-validate)
-- [`conductor init`](#conductor-init)
-- [`conductor templates`](#conductor-templates)
+- [`conductor registry`](#conductor-registry)
 
 ## `conductor run`
 
@@ -190,68 +189,75 @@ for f in examples/*.yaml; do conductor validate "$f"; done
 - Circular dependency detection
 - Input/output schema validation
 
-## `conductor init`
+## `conductor registry`
 
-Create a new workflow file from a template.
+Manage workflow registries — named sources (GitHub repos or local directories) for shared workflows.
 
 ```bash
-conductor init <name> [OPTIONS]
+conductor registry <subcommand> [OPTIONS]
 ```
 
+### Subcommands
+
+| Subcommand | Description |
+|------------|-------------|
+| `list [NAME]` | List registries, or list workflows in a specific registry |
+| `add <NAME> <SOURCE>` | Add a new registry (GitHub `owner/repo` or local path) |
+| `remove <NAME>` | Remove a registry |
+| `set-default <NAME>` | Set the default registry |
+| `update [NAME]` | Update cached registry index (all or specific) |
+| `show <NAME>` | Show registry details and status |
+
 ### Options
 
-| Option | Short | Description |
-|--------|-------|-------------|
-| `--template TEMPLATE` | `-t` | Template to use (default: simple) |
-| `--output PATH` | `-o` | Output file path |
+| Option | Description |
+|--------|-------------|
+| `--default` | Mark as the default registry (with `add`) |
 
 ### Examples
 
 ```bash
-# Create a simple workflow (default template)
-conductor init my-workflow
+# Add a GitHub-hosted registry and set it as default
+conductor registry add official myorg/conductor-workflows --default
 
-# Create from a specific template
-conductor init my-workflow --template loop
+# Add a local directory registry
+conductor registry add local ./my-workflows
 
-# Specify output path
-conductor init my-workflow -t human-gate -o ./workflows/review.yaml
+# List all configured registries
+conductor registry list
 
-# Create a parallel workflow
-conductor init research --template parallel -o research.yaml
-```
+# List workflows in a specific registry
+conductor registry list official
+
+# Show registry details
+conductor registry show official
 
-### Available Templates
+# Set a different default
+conductor registry set-default local
 
-Use `conductor templates` to see the full list. Common templates:
+# Update cached registry index
+conductor registry update
 
-- `simple` - Single agent, basic Q&A (default)
-- `loop` - Agent with loop-back pattern
-- `parallel` - Static parallel execution
-- `human-gate` - Workflow with human approval gate
-- `for-each` - Dynamic parallel processing
+# Remove a registry
+conductor registry remove local
+```
 
-## `conductor templates`
+### Running Workflows from a Registry
 
-List available workflow templates with descriptions.
+Once a registry is configured, `conductor run` accepts short workflow names:
 
 ```bash
-conductor templates
-```
+# Run from default registry (latest version)
+conductor run qa-bot
 
-### Example Output
+# Run from a specific registry
+conductor run qa-bot@official
 
+# Run a specific version
+conductor run qa-bot@official@1.2.3
 ```
-Available templates:
-
-  simple      Single agent workflow for basic Q&A
-  loop        Agent with conditional loop-back
-  parallel    Static parallel agent execution
-  human-gate  Workflow with human approval gate
-  for-each    Dynamic parallel (for-each) processing
 
-Use: conductor init <name> --template <template>
-```
+See [design/registry.md](./design/registry.md) for the full design.
 
 ## Environment Variables