MyJackfruit

Help
Browse topics · Starting

Starting

← Starting

How do I describe my idea so the AI understands it?

Short answer

Write in your own words who it is for, what it must do, what matters most, and your limits; Kai-Zen asks for the rest.

Before you start

Words used here (1)
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.
Deeper

Also asked:

How do I tell Kai-Zen what I want to build? Choose Kai-Zen in GilbApp's chat and write it in your own words: who it is for, what it must do, what matters most, and your limits. Kai-Zen asks for the rest.

Do I just write whatever I want? Yes: write it as you would tell a friend, with no special words and no form. Kai-Zen keeps your words as you wrote them.

How much detail do I need to give? A few sentences are enough to start. Kai-Zen asks what only you know, chooses the rest itself and lists it for you when it shows you the whole plan, so you can add detail then.

Should I describe the screens, or what the app should achieve? Describe what your app should achieve and for whom, not its screens: the plan is made from that. If you already know something a screen must have, say it too.

Yes, you can write it as you would tell a friend. You need no special words and no form. Kai-Zen, the planning agent in GilbApp's chat, keeps your words as you wrote them and hands them whole to the agents that write your plan; it does not rename or rewrite them.

Four things help Kai-Zen most:
- Who it is for: the people who will use it or care about it.
- What it must do: the main things a person does with it.
- What matters most: what should be better for those people when it works, and how you would notice.
- Your limits: money, time, rules you must follow, and anything it must or must not use.
Say also what kind of thing it is: an app, a website or something else.

A made-up example you can copy and change:
I want a small app for neighbours to swap plants. It is for people in one street who grow plants and want to give cuttings away. A person should be able to list a plant with a photo and ask for someone else's. What matters most: finding a plant nearby should take a few minutes, and nobody has to show their phone number. Limits: it must work on a phone and cost at most 50 euros a month to run.

A few sentences like these are enough to start. Kai-Zen asks what only you know in one message, each question with a default, the answer it uses if you give none. Anything else it needs on the way, it chooses itself, writes down as an assumption and lists for you at the end, when it shows you the whole plan for one approval. So you can add or correct detail then. The answer on answering Kai-Zen's questions shows how to reply.

Describe first what your app should achieve and for whom, not its screens: that is what the plan is made from. How it looks comes later. For an app, Kai-Zen's questions include its look, and by default you choose it during planning. If you already know something a screen must have, say it too.

In GilbApp's plan you will meet your words again, in parts with their own names. The people who care whether it works are its Stakeholders; what it does are its Functions; how good it must be are its Values; your limits are its Constraints. You do not need to use these words: the planning agents put each thing you said in its place.

If you change your mind later, tell Kai-Zen; the answer on changing the product while a project runs shows how.

This answer is written for a computer screen.

Source: Kai-Zen standards: Kai-Zen.NoPlacing ("Give the level agents the requester's words whole … do not sort, rename or rewrite them"), Kai-Zen.AskRules.One (one message of questions, each with its default), Kai-Zen.New.Setup ("For an app, the round also asks for its style, with the default: the requester chooses it … during planning"), Kai-Zen.ProjectTemplate (Outcome: what changes, for whom; Stakeholders; Functions; Values; Assumptions). Live help pages, sentences shared: How do I answer Kai-Zen's questions? (assumptions listed at the end; one approval); How do I start work with Kai-Zen?; How do I start my first plan?; How do I write a Constraint in my plan?; How do I change the product while a project runs?. The example is made up.

Checked against GilbApp d529620.