How do I ask for a one-off spec?
Short answer
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 on a computer, with your own AI, Claude Code or Grok, connected in the 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.
Words used here (6)
- agent
- An agent is your AI following one written procedure, its standing instructions, for one kind of work.
- Kai-Zen
- Kai-Zen is the planning agent: it finds out what you want, chooses the way, hands the work to other agents and reports back.
- project
- A project is work to bring about a change you want, such as a new app or a better way of doing something.
- GilbApp
- GilbApp is the app, opened in a web browser at https://gilb.com/app, where you open, fill and share your vaults.
- Jackfruit
- Jackfruit is the vault agent: it finds, reads, writes and links records in your vaults, and makes new vaults for you.
- GilbPlatform
- GilbPlatform is the service that keeps people's and organisations' data in vaults, each at its own web address.
Steps
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.


Show as text
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.
More about this
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.
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.


Show as text
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.
More about this
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.
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).


Show as text
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.
More about this
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.
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 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 explains them. If that is not clear, it asks you in one round of questions; the answer on answering Kai-Zen's 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 and writing a Value in your plan show what each holds. So do those on writing a Solution and writing a Resource.
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? 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 and on continuing 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, and press Return:
/mcp__gilb-<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 <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?
Checked against GilbApp d529620.