# How do I ask for a one-off spec?

Checked 2026-11-15 against GilbApp d5296208bbffa2ab70076e6194f5537c4be1ddf7.

Press "Main menu", choose "Choose an agent", choose "Kai-Zen - Master Agent of Planning", type specs you need, outside any project, and press "Send".

## Before you start

You need to be [signed in to GilbApp](http://support.gilb.com/help/how-do-i-sign-in-to-gilbapp) on a computer, with your own AI, Claude Code or Grok, [connected in the chat](http://support.gilb.com/help/how-do-i-connect-my-ai-to-gilbapp-chat), each by its own answer. The pictures show a made-up person on a test site; your screen shows your own name and address.

## Steps

1. Press "Main menu" at the top left and choose "Choose an agent".

   Press "Main menu", next to your profile picture at the top left, and under "FOR YOU" choose "Choose an agent" \("Pick or connect an AI agent."\). The button shows the name of the section you are in, such as "Vaults". GilbApp opens the left pane, where you chat, and puts the cursor on the agent list at the top of it.

   The square button at the far left of the top bar also shows or hides the left pane. You can also search for "Choose an agent" in "Search or run a command".

   ![GilbApp with the "GO TO" panel open; "Choose an agent" under "FOR YOU" is outlined in orange.](http://support.gilb.com/help/media/f8ec51a0539f1763.png)
   What you see: The panel headed "GO TO" is open. In the right-hand column under "FOR YOU", the outlined row reads "Choose an agent" and "Pick or connect an AI agent." Click it; the chat opens in a pane on the left.
2. Choose "Kai-Zen - Master Agent of Planning" in the agent list.

   Press the agent list at the top of the left pane and choose "Kai-Zen - Master Agent of Planning". Each agent has its own chat, and the list shows which one you are in.

   A new chat starts on the first agent in the list, "Jackfruit - Master Agent of Vaults and Information". The list comes from GilbPlatform each time the chat opens. GilbApp keeps your choice for this browser tab. While an agent is answering, the list is greyed out.

   ![GilbApp with the chat open in the left pane; the agent list at its top, showing "Jackfruit - Master Agent of Vaults and Information", is outlined in orange.](http://support.gilb.com/help/media/dbe12fad98b0e286.png)
   What you see: The chat is open in a pane at the left. At the top of that pane the outlined agent list reads "Jackfruit - Master Agent of Vaults and Information", the first pick; the "Connect" button sits to its right. Click the list to choose another agent.
3. Type the specs you need in "Write a message…" and press "Send".

   In "Write a message…", say that you want specs outside any project, what they are for, and where the result should go, the chat or a vault you name; then press "Send". Specs are written requirements: Functions \(what a system does\), Values \(perceived benefits, measured as numbers\), Development Resources \(what the work uses up, such as money or time\) and Solutions \(how a Function gets done\).

   Return also sends; Shift and Return starts a new line. Kai-Zen shows the result in the chat, and writes it into a vault only if you ask for that. GilbApp's chat does not reach the files on your computer unless you choose a code folder while Claude Code is connected; otherwise specs for a folder there need Claude Code in Terminal. While it works, the pane says "The agent is writing…", then "Ran" and the name of each tool it uses, and "Send" reads "Queue". For example:
   Specs outside any project, shown here: the Values a booking page for a small tennis club should have.

   ![GilbApp with Kai-Zen chosen in the chat and a request for specs outside any project typed in the box at the bottom; "Send" to the right of it is outlined in orange.](http://support.gilb.com/help/media/b7ef4643d0c38fad.png)
   What you see: The agent list at the top of the chat reads "Kai-Zen - Master Agent of Planning". In the box at the bottom, "Specs outside any project, shown here:" starts the typed request. The outlined "Send" is to its right. Press it.

## Deeper

Also asked:

Can I ask Kai-Zen for just one small thing? Yes. Ask for the specs you need outside any project: Kai-Zen writes only those, shows them, and sets up no project. For one small change to a project you have, name that change; [the answer on changing the product while a project runs](http://support.gilb.com/help/how-do-i-change-the-product-while-a-project-runs) shows how.

A one-off spec is one Kai-Zen writes outside any project. Kai-Zen first works out what you want: a new project, a project you already have, written requirements outside any project, or an idea to keep for later. For specs outside any project, it works out which specs the request needs, at which level of a plan, and the rules of that level: "Business", "Stakeholder" or "Product"; [the answer on the levels of a plan](http://support.gilb.com/help/what-are-the-levels-of-a-plan) explains them. If that is not clear, it asks you in one round of questions; [the answer on answering Kai-Zen's questions](http://support.gilb.com/help/how-do-i-answer-kai-zens-questions) shows how to reply.

Then it writes each kind of spec the request needs, in this order: the Functions, the Values, the Development Resources, then the Solutions. Kai-Zen writes each kind by its own standard for that kind; the answers on [writing a Function](http://support.gilb.com/help/how-do-i-write-a-function-in-my-plan) and [writing a Value](http://support.gilb.com/help/how-do-i-write-a-value-in-my-plan) in your plan show what each holds. So do those on [writing a Solution](http://support.gilb.com/help/how-do-i-write-a-solution-in-my-plan) and [writing a Resource](http://support.gilb.com/help/how-do-i-write-a-resource-and-set-the-projects-currency).

Then it shows you the result. It writes it to a folder or a vault only if your request asks for that. From GilbApp's chat Kai-Zen works only with the vault, unless you choose a code folder while Claude Code is connected; otherwise a folder on your computer needs Claude Code in Terminal. The answer [How do I let my AI build in a folder on my computer from GilbApp's chat?](http://support.gilb.com/help/how-do-i-let-my-ai-build-in-a-folder-on-my-computer-from-gilbapps-chat) shows how. Once the specs are shown or written, the request is done: Kai-Zen sets up no project for them.

To have the specs in a project's plan, ask for a new project, or name the project in your request; the answers on [starting work with Kai-Zen](http://support.gilb.com/help/how-do-i-start-work-with-kai-zen) and on [continuing a project with Kai-Zen](http://support.gilb.com/help/how-do-i-continue-a-project-with-kai-zen) show how.

GilbApp has no control that writes specs for you: you ask Kai-Zen in the chat, or you write each one yourself on the "Plan" screen, as the answers on writing a Value and the other kinds show.

In Claude Code in Terminal you can ask the same way. Start Claude Code, type this line with your own short name, the one you gave your AI when you [connected your computer](http://support.gilb.com/help/how-do-i-connect-my-computer-to-my-vault), and press Return:
/mcp\_\_gilb-&lt;short name\>\_\_agent
Then say which specs you need and where the result should go, and press Return.

This answer is written for a computer screen.

Source: GilbApp af0f04ee838a4d55887d2ff1f72edd49a4ff7ca0 \(https://gilb.com/app/version.json read 2026-11-10, buildTime 2026-11-09.522Z, dirty false\); code read \(no checkout\). Steps 1 and 2: identical to, \(sectionMenuList.ts:330, LeftRegion.tsx:16-20, AgentSelector.tsx:15-16, :57-79, chatAgents.ts:67-75, as cited there\). Step 3: AgentChat.tsx:1046 \("Write a message…"\), :1063 \("Send"/"Queue"\), :711 \(Return sends unless Shift\), :545, :553, :888 \("The agent is writing…", then "Ran &lt;tool\>"\). No GilbApp control writes one-off specs: the code at af0f04ee shows only tests \(the bridge's one-off command and Kai-Zen.OneOff unit tags in process-viewer fixtures\). Standards read 2026-11-10, all 200: Kai-Zen.Route \(K 06gd6bhvp1t8n3y7r1jsbzcjrc\) Evaluate, OneOff \("IF specs outside any project -\> hand off"\); Kai-Zen.OneOff \(K 06gdf4965sxyb7kejadr53jqkw\) Entry.Request, Entry.Output \("Knows where the result goes: the chat, a named folder, or a named vault"\), Need \("which specs the request needs, at which level, and the level rules: Kai-Zen.BusinessLevelRules, Kai-Zen.StakeholderLevelRules or Kai-Zen.ProductLevelRules. If it is not clear, ask the requester in one round"\), Functions \(Kai-Zen.WriteFunction\), Values \(Kai-Zen.WriteValue\), Resources \(Kai-Zen.WriteResource\), Solutions \(Kai-Zen.WriteSolution\), Show \("Show the result to the requester. Write to a folder or vault only if the request asks for it"\), Exit.Done \("Specs shown or written"\); Kai-Zen.AskRules.One. Code-folder exception: GilbApp 49b1ae53 \(https://gilb.com/app/version.json, read 13 November 2026\), src/components/agent/AgentChat.tsx:677-692 and :1084-1090 \("Choose a code folder", "Code in", Claude Code only\); live answer How do I let my AI build in a folder on my computer from GilbApp's chat?
