MyJackfruit

Help
Browse topics · Starting

Starting

← Back to How do I start my first plan?

How do I write a Solution in my plan?

Short answer

Press Main menu, choose Plan, press + New, choose Solution, type a tag (its short name), and press Create.

Before you start

You need to be signed in to GilbApp on a computer, with a vault you can write to, such as your own vault. The Value the Solution changes needs a number under Status in its Levels first. The pictures show a made-up person on a test site; your screen shows your own name and address.

Words used here (8)
short name
A short name is the one word you give one AI on one computer, such as gilb-example; it keeps that AI's key and tools apart.
GilbApp
GilbApp is the app, opened in a web browser at https://gilb.com/app, where you open, fill and share your vaults.
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.
record
A record is one piece of data with its own address, such as a person, a place, a thing or a note.
virtual folder
A virtual folder is a view that groups records and files without moving them; each may sit in several folders.
field
A field is one named fact on a record, such as its title or a due date; its name comes from GilbVeda.
assumption
An assumption is a choice Kai-Zen made for you, or a fact your plan counts on, written down so you can check or change it.
Part of System
Part of System is the line on a Solution's card that names the one system the Solution belongs to, such as an app.
Steps
  1. Press Main menu at the top left and choose Plan.

    Press Main menu, next to your profile picture at the top left, and under YOUR SECTIONS choose Plan. The button shows the name of the section you are in, such as Vaults.

    GilbApp with the "GO TO" panel open, and "Plan" under "YOUR SECTIONS" outlined in orange.
    GilbApp with the "GO TO" panel open, and "Plan" under "YOUR SECTIONS" outlined in orange.
    Show as text

    In the GO TO panel that opens from "Main menu" at the top left, look under YOUR SECTIONS on the left. The outlined row is "Plan", with the line "Your Kai-Zen plan: Functions, Values, Development Resources and Solutions." Press it to open the Plan screen.

    More about this

    A panel headed GO TO opens; Plan reads Your Kai-Zen plan: Functions, Values, Development Resources and Solutions. You can also press the Plan button on the card of a vault (the place where a person or a group keeps their records) in Vaults. The Plan screen lists your plan records and has the views Grid, Graph, Both and Card.

  2. Press + New.

    Press + New at the top right of the Plan screen. With no record selected, the type dialog opens at once.

    The "Plan" screen with the list of plan records and no record selected, with the "+ New" button at the top right outlined in orange.
    The "Plan" screen with the list of plan records and no record selected, with the "+ New" button at the top right outlined in orange.
    Show as text

    Look at the top right of the Plan screen, just left of the Details pane. The outlined button is "+ New". Press it; with no record selected a dialog headed "New function" opens with its "TYPE" list.

    More about this

    If a record is selected, New first offers five choices: Create a record and link it to the selected record, Link the selected record to a record that already exists, Create a record on its own, Create a virtual folder and Upload a file. Choose Create a record on its own. A new Solution needs nothing else; the others make a record joined to the selected one, link two records that already exist, make a virtual folder or upload a file. In Plan, the GO TO panel also has New plan record, which does the same.

  3. Under TYPE, choose Solution.

    In the list under TYPE, choose Solution. A Solution is how a Function (what a system does) gets done.

    The new-record dialog headed "New function" with the list under "TYPE", with the "Solution" option outlined in orange.
    The new-record dialog headed "New function" with the list under "TYPE", with the "Solution" option outlined in orange.
    Show as text

    In the "New function" dialog, the list under "TYPE" is scrolled to show "Solution", between "Value" and "Solution Constraint". That row is outlined. Click it.

    More about this

    The dialog opens headed New function with Function chosen; after you choose Solution it is headed New solution. The chosen type then shows under TYPE with a DEFINITION read from GilbVeda, the shared list of terms; it can be long, and you need not read it. × beside the type brings the list back. A Solution Constraint is a Solution that must be used because a named person requires it; the answer on writing a Constraint in your plan covers it. A search box above the TYPE list narrows it as you type, and Close at the top of the dialog closes it like Cancel; you need neither. ↗ at the end of a row shows what GilbVeda says about that type; you do not need it. Cancel closes the dialog without making anything. Where it shows Back instead, Back returns you to the five choices.

  4. Type a tag in TAG and press Create.

    Type a tag in TAG, check CREATE IN, and press Create. A tag is the short name of a plan record: an area, a dot and a keyword, such as Save.LocalFirst.

    The dialog headed "New solution" with the type's "DEFINITION", a tag typed under "TAG" and the vault under "CREATE IN", with the "Create" button outlined in orange.
    The dialog headed "New solution" with the type's "DEFINITION", a tag typed under "TAG" and the vault under "CREATE IN", with the "Create" button outlined in orange.
    Show as text

    The dialog is now headed "New solution", with the type's "DEFINITION" under "TYPE". At the bottom right the outlined button is "Create"; "TAG" holds your tag and "CREATE IN" your vault. Press "Create".

    More about this

    The box shows Area.Keyword, e.g. Usability.Learn until you type. With the tag empty the screen says Give it a Tag first: a Plan card is named by its Tag. Under CREATE IN, choose the vault where it will live; vaults you can only read say read only, you cannot create there. If the tag is already used in that vault, the screen says is already used in this vault. Pick another. If the vault is not the one you are viewing, the dialog stays open and says the record was made there, not in the vault you are viewing. It is not drawn here., with an Open it button. Leave More solution details closed: the card's own Description is written in parts (step 5).

  5. Under Description, press + Part, type a Keyword and Text, and press Add.

    Under Description, press + Part, type a Keyword and the Text, and press Add. A Description says how the Solution works, one short part at a time.

    The new Solution's card in edit mode with "Done" at the top right and an empty "Description", with the "+ Part" button outlined in orange.
    The new Solution's card in edit mode with "Done" at the top right and an empty "Description", with the "+ Part" button outlined in orange.
    Show as text

    On the new Solution's card, the line under "SOLUTION" reads "Type: Solution / Solution Constraint · Level: Solution". In "Description", which says "No description yet", the outlined button is "+ Part". Press it, type a "Keyword" and "Text", and press "Add".

    More about this

    After Create, the new Solution opens in edit mode: Done is at the top right of the card and the card says Editing. Changes save as you leave a field. There is no Save button. If you come back later, click the Solution in the list and press Edit. The line under the header shows Type (two radio buttons, with Solution marked), Level and Version (a date); you need none of them. The Keyword is one word: letters only, starting with a capital, such as Queue; otherwise the screen says Keyword: letters only, starting with a capital, e.g. Sync. Each part gets its own tag: the Solution's tag, a dot, the Keyword. With nothing yet, the line reads No description yet. Discard throws away the part you typed (the screen then asks Discard what you typed? with Keep and Discard); you do not need it.

  6. If you need more, press + Assumption or Paste parts.

    If you need more, under Description, press + Assumption or Paste parts. + Assumption adds something the Solution counts on, and Paste parts adds many parts at once.

    The Solution's card with one part under "Description", with the "+ Assumption" button outlined in orange.
    The Solution's card with one part under "Description", with the "+ Assumption" button outlined in orange.
    Show as text

    The part you added shows under "Description", with arrows and "×" at its right. Below it, the outlined button is "+ Assumption", between "+ Part" and "Paste parts". Press it, or "Paste parts", only if you need more.

    More about this

    An assumption is a plain claim a test can prove wrong: no may, might, could or expected to. In the Paste parts box, write one part per line as Keyword: text, then press the button that starts with Create. A ? button next to + Part, + Assumption and Paste parts opens help about the Description; you do not need it. Once a part is added, its row has ↑ and ↓ to move it up or down, → and ← to move it under the part above (a sub-part) or out one level, × to remove it, and a grip to drag it; you need them only to rearrange. Under the Paste parts box, Discard throws away what you pasted; you do not need it. None is needed to save.

  7. Under Status, press + New status and choose the status.

    Under Status, press + New status, then choose the status in the list. The status says where the Solution stands: Planned, Building, Developed, Production or Retired.

    The Solution's card scrolled to the "Status" group reading "No status yet", with the "+ New status" button outlined in orange.
    The Solution's card scrolled to the "Status" group reading "No status yet", with the "+ New status" button outlined in orange.
    Show as text

    Scroll down past "Meter" to "Status", which reads "No status yet". The outlined button is "+ New status". Press it; the status shows as "Planned" with today's date, and you can choose another.

    More about this

    The first new line is dated today and starts as Planned; a later one starts as the next word, and you can choose another; the date box under the status line changes the date. With nothing yet, the line reads No status yet. When the status changes, press + New status again and choose the new word: the older line stays as Past, so the history is kept. The same word on the same date is refused: That status is already recorded for that date. A × beside an older Past line deletes that line; you need it only to remove history. A Source box under the status line can name who said it; it is optional. None is needed to save.

  8. Under Solution of Function, search and select the Function.

    Under Solution of Function, type in the box that shows Find a Function by tag and select the Function. This links the Solution to the Function it carries out.

    The Solution's card with the status "Planned" and the empty "Solution of Function" line, with its "Find a Function by tag" box outlined in orange.
    The Solution's card with the status "Planned" and the empty "Solution of Function" line, with its "Find a Function by tag" box outlined in orange.
    Show as text

    The "Status" part now shows "Planned". Below it, under "Solution of Function", the outlined box reads "Find a Function by tag". Type the Function's tag and select it. "Part of System" below can stay empty.

    More about this

    The Function then lists this Solution under Solutions. If no Function matches, press the button that starts with Create Function to make one with the text you typed. You can add more than one; a red round (−) at the left of each removes the link. Just below, under Part of System, you can search and select the one system the Solution belongs to, such as an app, in the box that shows Find a system, or press the button that starts with Create System. Each line has an optional Source box that can name who said it. In edit mode the boxes are open by themselves; outside edit mode press + Add first. Both lines are optional for saving.

  9. Under Impacts, search and select the Value or Resource.

    Under Impacts, type in the box that shows Find a Value or Resource by tag and select the one the Solution changes. An impact is the effect the Solution has on a Value, or on a Development Resource, which is what the work uses up, such as money or time.

    The Solution's card scrolled to the empty "Impacts" line, with its "Find a Value or Resource by tag" box outlined in orange.
    The Solution's card scrolled to the empty "Impacts" line, with its "Find a Value or Resource by tag" box outlined in orange.
    Show as text

    Near the foot of the card, under "Impacts", the outlined box reads "Find a Value or Resource by tag". Type the tag of the Value the Solution changes and select it from the list.

    More about this

    If none matches, press the button that starts with Create Value or Create Resource to make one with the text you typed. A Value is a perceived benefit, measured as a number. A row then shows the Value, an arrow, a box, an arrow and this Solution's tag. The Value needs one number under Status in its Levels (the numbers on its Scale) first; with none, with no number, or with a range, the row says the Status must be set to one number and has no box (step 10). In edit mode the box is open by itself; outside edit mode press + Add first. A Resource shows an amount box instead. The line is optional for saving.

  10. Beside the Value, type the change it brings.

    Beside the Value, type the change the Solution brings, such as -7 or +2, and press Enter (for a Resource, the amount it uses). If the row instead says the Value's Status must be set (it has none, no number, or a range) and shows no box, open the Value, type one number in its Status, and come back.

    The Solution's "Impacts" line with a row for the Value, with the empty number box between the two arrows outlined in orange.
    The Solution's "Impacts" line with a row for the Value, with the empty number box between the two arrows outlined in orange.
    Show as text

    In "Impacts", the new row reads the Value's tag, an arrow, an empty box, the unit, another arrow and the Solution's tag with "(estimate)". The empty box is outlined. Type the change it brings, for example -4, and press Enter.

    More about this

    You type the change, not the end number: -7 on a Status of 120 makes 113. A sentence under the box, with goes from and the two numbers, says what it makes. The unit comes from the Value's Scale; a Resource with no unit also shows a Unit box. If you leave the row with nothing typed, no impact is made; text that is not a number gets Enter a decimal number. Once saved, the line ends (estimate): press it to switch to (measured) when the number has been measured. A red round (−) at the left of the row removes the impact. The answer on updating a Value's Status shows how to set a Status. When you have finished, press Done; what you typed is already saved.

Deeper

Also asked:

How do I write a way to build something? Write it as a Solution, how something is done: in Plan, press + New, choose Solution, type a tag (its short name) and press Create. Under Solution of Function, choose what it is for.

What does ± after a number in my plan mean? It is the range: how far off the number may be, such as ± 2, or -1 / +3 when it may be off more one way than the other.

What is Evidence? The facts and reasoning that say why you believe an impact's number. Under each impact, type them in Evidence: the facts and reasoning, and a link to them in Link to the evidence.

What is Solution of Function? The line that names the Functions a Solution makes work; one Solution can serve more than one, and each of them lists it under Solutions. The next line, Part of System, names the one system the Solution belongs to.

What is a Description of a Solution? It says what the Solution is, one part at a time. Each part is a Keyword and a sentence, with its own tag: the Solution's tag, a dot, the Keyword, such as Save.LocalFirst.Sync.

Only the tag is needed to create a Solution. Every other line on the card is optional.

The tag is the Solution's name. It cannot be left empty, and a tag already used in the same vault is refused.

A Level says which part of the plan a Solution belongs to. A new Solution shows the level Solution until you choose another on the Level in the line under the card's header. The levels you can choose are the project's own, Business, Stakeholder, Product and Solution by default.

A Solution's Status is one of Planned, Building, Developed, Production or Retired, with a date. A Value (a perceived benefit, measured as a number) has a different status: it is a number on its Scale, the ruler the Value is measured on.

An impact can be added only to a Value that already has one number under Status in its Levels (the numbers on its Scale). With none, the Impacts line asks you to set it first and no box appears.

The card has more lines, all optional. Under Stakeholder, search and select who has a stake in the Solution, or press + New stakeholder to make one. Under Meter, press Add humanagent, Add aiagent or Add instrument and type how a person, an AI or a test checks the Solution; the Meter says how to find its current Status. Under Authority, search and select a named person who has the power to decide about the Solution; it is needed only on a Solution Constraint. Each line has an optional Source box that can name who said it.

Under each impact you can also say how sure you are. Choose an Experience Level, from 0 — We can't point to any experience. to "10 — We did exactly this before, in a very similar situation. We will get this result."; it shows 1 — An idea or a theory only. until you choose one. A ± box showing range takes how far off the number may be, such as 2 or -1 / +3, and then adds a line starting Best and one starting Worst. Evidence: the facts and reasoning and Link to the evidence say why you believe the number. None is needed to save.

A Solution that must be used because a named person requires it is a Solution Constraint, not a Solution. Choose Solution Constraint under TYPE in step 3; it needs that person under Authority.

Beside Done, a + does what + Add Information at the foot of the card does; you do not need it. It can bring back a second Type line: the kind of thing the Solution is about, from the types in GilbVeda.

This answer is written for a computer screen.

Checked against GilbApp d529620.