Skip to content

Vision: turn trusted plugin workflows into reusable recipes #19

Description

@Q00

Context

Issue #2 defines the first product boundary for running installed Ouroboros UserLevel plugins directly inside ourocode: resolve plugin intent, dispatch through the Ouroboros trust/firewall layer, capture generated artifacts, and optionally continue into ooo run.

Once that bridge exists, the next product step should not be only one-off plugin execution. Successful plugin workflows should become repeatable, inspectable recipes that users can run again without reconstructing the same natural-language prompt, command flags, artifact handling, and continuation policy each time.

Vision

ourocode should let trusted plugin workflows graduate into reusable recipes: named, reviewable workflow templates that preserve the user's intent, plugin command, trust assumptions, input shape, generated artifact expectations, and continuation behavior.

A user should be able to run a workflow once, see that it produced the right handoff, and then save that path as something like:

recipe: superpowers-tdd-handoff
plugin: superpowers
command: test-driven-development
inputs: goal, target_files?, test_command?
continuation: suggest-or-run generated seed.md

Later, they should be able to invoke it naturally:

Use the saved TDD handoff recipe for retry behavior in the HTTP transport.

Product principles

  • Recipes are not a bypass around plugin trust. They must still resolve the installed plugin, declared command, and current trust state at execution time.
  • Recipes should be transparent before execution: show the plugin, command, inputs, expected artifacts, and continuation policy.
  • Recipes should remain portable enough to share in a repository or team workflow, while keeping local secrets and trust grants out of the recipe itself.
  • Recipes should make repeated workflows faster without hiding meaningful execution decisions from the user.

Initial scope

  • Capture a successful plugin invocation as a recipe draft.
  • Store the recipe in a predictable project-local or user-local location.
  • Support required and optional inputs instead of saving one frozen command string.
  • Re-resolve plugin capability and trust before each run.
  • Display a review step before executing a saved recipe.
  • Preserve artifact capture and continuation behavior from the original plugin dispatch flow.

Acceptance criteria

  • After a successful trusted plugin workflow, ourocode can present a recipe draft with plugin, command, inputs, expected artifacts, and continuation policy.
  • A saved recipe can be invoked by name from inside ourocode.
  • Running a recipe goes through the same safe plugin dispatch path as issue Support natural-language dispatch for installed Ouroboros UserLevel plugins #2, including trust checks and artifact capture.
  • Recipe execution does not store or replay raw shell strings assembled from natural language.
  • If the plugin command changes, disappears, or loses trust, the recipe fails with actionable guidance instead of silently degrading.
  • Tests cover recipe capture, storage shape, invocation routing, trust revalidation, and continuation behavior.

Non-goals

Related: #2

Metadata

Metadata

Assignees

No one assigned

    Labels

    enhancementNew feature or request

    Type

    No type

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions