ZyanDocs

Prompt Library and Activity

Keep reusable Builder prompts in folders, draft them from a project brief inside a workspace, and read the activity feed across every project.

The Prompt Library is where the instructions you keep retyping live. A prompt is a title, a body, a folder and optional tags, ready to insert into a workspace terminal, draft against a project brief, or attach to a scheduled automation.

It has two homes. The Prompt Library page in Builder is where prompts are created and edited. The Prompt Library panel inside a project workspace is where they are used.

The Activity feed is the other half of the same habit: one place to see what Builder actually did across every project.

Before you start

Both areas need Builder access. Keeping, copying and inserting a prompt spends nothing. Drafting a prompt from a brief, and planning a queue in My Prompts, use AI credits.

Keeping prompts

Open the Prompt Library

BuilderPrompt Library in the Builder navigation.

Add a prompt

New prompt opens the editor. Give it a Title and write the Prompt content, then choose Save.

File it

Pick a Folder, or type a new name to create one. New folder in the rail does the same thing from the other direction. A folder exists once a prompt is saved in it.

Reuse it

Open a row's menu for Copy, Edit and Delete. Selecting the row opens the same editor.

SettingWhat it changesDefault
TitleThe prompt's name in the library and in a workspace.—
FolderThe folder the prompt is grouped under. Type a new name to create one. An empty field saves to General.—
NicheA free-text tag for the kind of business the prompt suits.—
TagsComma-separated search tags. Duplicates are removed when you save.—
Prompt contentThe reusable prompt text itself.—
Use in My PromptsWhen off, My Prompts never plans with the prompt and no draft pulls it in as a related prompt. It stays in the Library tab.—
Share with teamWhen on, every teammate with Builder access can use the prompt. When off, only owners and admins can.—

A prompt that is switched off for My Prompts wears a Hidden from My Prompts chip, on this page and in the workspace panel. For owners and admins, a shared prompt wears Shared.

Who can edit

Owners and admins create, edit and delete prompts. A teammate sees the prompts shared with the team, can open one to read it, and can copy it.

Closing the editor with unsaved edits asks before it discards them. Reloading the page or leaving it does not ask, so save first.

Write prompts that name the outcome, not the steps

A stored prompt is read months later by someone who was not in the conversation. Audit this page against the active strategy's intent cluster and list what to change, without committing anything survives that. Do the thing we discussed does not.

Using prompts in a workspace

Open a project workspace and choose Prompt Library in its rail. The panel has two tabs.

Library

Select a prompt to read it. The Template, Draft and Diff control switches between the stored prompt, the version drafted for this project, and the lines that changed between them.

SettingWhat it changesDefault
Draft + InsertDrafts the prompt from the linked project's brief, then inserts the draft into the terminal. Shown until the prompt has a draft.—
Insert templateInserts the stored prompt as written.—
Insert draftInserts the drafted version. Shown once a draft exists and the Draft view is selected.—
Draft from briefDrafts the prompt from the brief without inserting it.—
Refine draftOpens the Refine section, where an optional extra tweak is sent with the next draft.—
CopyCopies what the current view shows.—
Edit templateIn the prompt's menu, for owners and admins. Opens the stored prompt in the Prompt Library page's editor.—
Discard draftIn the prompt's menu, once a draft exists. Removes the draft and keeps the stored prompt.—

Drafting needs the Builder project to be linked to an admin project, because the brief lives there. Inserting needs a connected terminal.

A draft never changes the stored prompt. It stays in this browser, for you and this project, for up to seven days.

When the library holds no prompts, owners and admins see Manage prompts, which opens the Prompt Library page.

My Prompts

My Prompts plans a run-ordered queue of prompts for the pages in the linked project brief. Describe what you want in the request field and send it. Select a queue item to Generate its prompt, Insert it into the terminal, or Copy it.

Each item shows where it stands.

StatusWhat it means
QueuedPlanned, not drafted yet
DraftingA draft is being written
DraftedThe draft is ready to insert
StaleThe brief changed after the draft was written
InsertedThe prompt was sent to the terminal
FailedThe last draft did not arrive

Planning needs at least one page in the brief's page tree.

The Activity feed

BuilderActivity is a live feed of Builder work across projects, with a team workload view beside it.

SettingWhat it changesDefault
All kindsFilters the feed to Commits, Deploys, Files, Prompts, System or Terminal.—
Search activityFree-text search across the feed.—
KindWhat it shows
CommitsCommits made through Builder
DeploysDeployments and their outcome
FilesFile changes in a project
PromptsPrompts that were run
SystemPlatform-level events
TerminalTerminal sessions and what they did

No activity matches this view is a filter result, not an error. Clear the kind filter and the search box before concluding that nothing happened.

Troubleshooting

SymptomCauseFix
Draft not createdThe AI service did not answer, or declinedChoose Try again when it is offered. When it is not, the message says what to change
Queue not updatedThe planning request did not go throughChoose Try again. Your request is sent once
A queue warning mentions the prompt matcherThe AI plan was not available, so the queue was matched by prompt titleSend the request again to plan with AI
Draft + Insert and Insert are unavailableThe terminal is offlineConnect the project terminal, then insert
Draft from brief is unavailableThe Builder project is not linked to an admin projectLink it in the project's settings
Only owners and admins can edit promptsYou are signed in as a teammateAsk an owner or admin to make the change
Prompts not loadedThe library could not be readChoose Try again
Nothing was saved, because the prompt was deleted or your edit access changedA teammate deleted the prompt while you had it open, or your role changedCopy your text, close the editor and create a new prompt. If your role changed, ask an owner
That prompt is not in the libraryThe link names a prompt that was deleted, or one that is not shared with youPick the prompt from the list
A prompt is missing from My PromptsUse in My Prompts is off for itTurn it on in the Prompt Library page
A prompt is missing from the workspace panelIt is not shared with the team, or it is in another folderAsk for it to be shared, or search for it by title
No activity matches this viewA kind filter or a search term is activeReset the filter to All kinds and clear the search
Terminal activity is emptyThe terminal service is not configured for this deploymentAsk your platform operator — see Builder overview
A copied prompt does not runCopying only places the text; you still send itPaste it into a terminal tab and run it yourself