Prompt Library

Every stage's prompt is a plain file in your workspace, and the Prompt Library is where you see them all in one place: what each prompt does, what inputs it takes, and whether it has problems — without leaving the app. It's a reference surface, not an editor: prompts stay plain files you edit in anything.

Opening the library

The library lives on the Workflows tab as a left tool window — click its icon in the rail (a closed book) or press ⌘8. It lists every .pml.md prompt in your workspace, grouped by the workflow that uses it: built-in workflows first in their sidebar order, then your own, then a trailing Not referenced by any workflow group for files no manifest points at — experiments, or leftovers from workflows you've removed. A prompt shared by several workflows appears once, listing everything that references it.

Reading a prompt

Select a prompt and the documentation view opens in the center pane:

• Header: the filename, which workflow and stages use it, whether it's built-in or yours, and its path.
• Inputs: each declared input with its description and default value. These are the {{inputs.<name>}} placeholders the prompt's body uses (see Prompt files).
• Outputs: the artifacts the prompt declares it produces, with descriptions.
• Source: the full file, exactly as it is on disk.

Copy content, Copy Path, and Reveal in Finder are in the toolbar, and the same actions (plus Open) are on each row's context menu.

When a prompt has problems

If a prompt fails to parse or declares invalid names, the library doesn't hide it — the entry stays in the list with a badge, and the documentation view lists each problem (for example, Output name "refined-spec" must match `[A-Za-z_][A-Za-z0-9_]*`.). A prompt with problems would fail at run time; the library shows you before you get there. See Troubleshooting for the common case and its fix.

Using a library prompt in a run

The execution form's Prompt File row has a Library… menu next to Browse…. It lists the same prompts, grouped by workflow with the current workflow's section first, and picking one overrides the stage's prompt for that run — same override semantics as picking a file with Browse…, including Revert. Prompts with problems are marked in the menu rather than hidden.

Refreshing

The Refresh button re-scans the prompts folder, so edits, new files, and deletions show up immediately. Refresh doesn't re-create deleted files: if you delete a built-in prompt to get a fresh copy, relaunch the app (or reopen the workspace) and the seeder restores it.

The library is read-only and available on every tier.