MyJackfruit

Help
Browse topics · Starting

Starting

← Back to Why does my plan need Values and goals?

How do I write a Value in my plan?

Short answer

Press Main menu, choose Plan, press + New, choose Value, 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 pictures show a made-up person on a test site; your screen shows your own name and address.

Words used here (10)
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.
Value Decision Table
A Value Decision Table (VDT) is a table that ranks options by how much they move the level's Values for their cost.
Value Kick-out Table
A Value Kick-out Table (VKT) is a table that picks one of several options by how much Value each gives for its cost.
Value Tracking Table
A Value Tracking Table (VTT) follows a project's Values and Development Resources across its steps: the Estimate of each step, then its Actual.
field
A field is one named fact on a record, such as its title or a due date; its name comes from GilbVeda.
project
A project is work to bring about a change you want, such as a new app or a better way of doing something.
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 Value 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 Value.

    In the list under TYPE, choose Value.

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

    In the dialog headed "New function", look at the list under "TYPE". The outlined row is "Value", third after "Function" and "Function Constraint". Click it; the heading changes to "New value".

    More about this

    The dialog opens headed New function, with Function chosen. The list also holds Function Constraint, Solution, Solution Constraint, Development Resource and the three tables Value Decision Table, Value Kick-out Table and Value Tracking Table. After you choose Value the dialog is headed New value. 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. For a Value it begins Value is perceived benefit. × beside the type brings the list back. ↗ at the end of a row shows what GilbVeda says about that type; you do not need 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. 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 Usability.Learn.

    The dialog headed "New value" with the Value's "DEFINITION" and a made-up tag typed under "TAG", and the "Create" button at the bottom right outlined in orange.
    The dialog headed "New value" with the Value's "DEFINITION" and a made-up tag typed under "TAG", and the "Create" button at the bottom right outlined in orange.
    Show as text

    At the bottom right of the "New value" dialog, the outlined button is "Create". The "TAG" box above holds the tag you typed, and "CREATE IN" names 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.

  5. Under Level, choose the level.

    On the line under the card's header, open the list next to Level and choose the level. A Level says which part of the plan the Value belongs to.

    The new Value card in edit mode, with "Done" at the top right, and the "Level" list on the line under the card's header outlined in orange.
    The new Value card in edit mode, with "Done" at the top right, and the "Level" list on the line under the card's header outlined in orange.
    Show as text

    On the new Value's card, look at the line under "VALUE" near the top: "Type: Value · Level: … · Version:". The outlined list after "Level:" shows "Product". Open it to choose another level, or leave it. "Done" at the top right shows the card is in edit mode.

    More about this

    After Create, the new Value 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 Value in the list and press Edit. The Level shows Product until you choose. The list holds Business, Stakeholder, Product and Solution by default, and + Add level… for one of your own. The same line shows Type (here Value) and Version (a date the screen shows); you need neither. The level is not needed to save. Beside Done, a + does what + Add Information at the foot of the card does; you do not need it.

  6. Under Scale, type the Unit.

    Under Scale, type the Unit. The Scale is the ruler the Value is measured on, and the Unit is what you count in.

    The Value card with the empty "Scale" boxes, and the "Unit" box showing "e.g. minutes" outlined in orange.
    The Value card with the empty "Scale" boxes, and the "Unit" box showing "e.g. minutes" outlined in orange.
    Show as text

    In the "Scale" part of the card, the first box sits under the word "Unit" and shows "e.g. minutes". That box is outlined. Click it and type your unit, for example minutes.

    More about this

    The Unit box shows e.g. minutes. Then type the Rate, which is per what (the box shows e.g. per [Task]), and the Context, which is where counting starts and stops (from: …; until: …). Under Better, choose Lower is better, Higher is better or Target range. Write the Scale first, because the levels are numbers on it. None is needed to save. The Scale also has a Source box that can name who said it; it is optional. Also optional: Endpoint says between which two things the Scale measures (Subject and Reference); Qualifiers narrow when or where a number holds, such as for one device (+ Qualifier). Illustration draws the levels as an Arrow or a Timeline; you type nothing there. A ⤢ button beside it opens it full screen; you do not need it.

  7. Under Levels, type a number in Status, Tolerable and Goal.

    Under Levels, type a number in the box on each of the Status, Tolerable and Goal rows. Status is where you are now, and Goal is the number you plan to reach.

    The Value card scrolled to "Levels", with rows "Status", "Tolerable" and "Goal", and the number box on the "Status" row outlined in orange.
    The Value card scrolled to "Levels", with rows "Status", "Tolerable" and "Goal", and the number box on the "Status" row outlined in orange.
    Show as text

    Scroll down to "Levels". Three rows start with "Status", "Tolerable" and "Goal"; each has a date box, a "Condition, Enter" box and a number box. The outlined number box is on the "Status" row. Type a number there, then on the "Tolerable" and "Goal" rows.

    More about this

    Tolerable is the survival limit: worse than it, the whole project is expected to fail. The first box of a row holds its word. Each row also has a date box (when the number holds), a Condition, Enter box (a condition for it; press Enter to add it), a Source box (who said it), Note, e.g. estimate, ⧉ (copies the row's qualifiers to a new level) and × (removes the row). A One side list shows only when Better is Target range. All of these are optional. A row with nothing in it is not saved. Outside edit mode a blank line shows Add value; press it first. Give Status one number: Impacts need it later. + Level and the buttons beside it add more levels; Deeper, below the steps, says how.

  8. Under Meter, press + Meter and type how it is measured.

    Under Meter, press + Meter and type how the current level is found. Use HumanAgent for a person, AiAgent for an AI and Instrument for a test, counter or log.

    The Value card scrolled to "Meter", with the "+ Meter" button outlined in orange.
    The Value card scrolled to "Meter", with the "+ Meter" button outlined in orange.
    Show as text

    Below "Levels" and "Add pasted lines", find the "Meter" part. Its only line is the outlined "+ Meter" button. Press it, then type in the boxes that appear how the level is measured.

    More about this

    The Meter says how someone reads the current level off the Scale, for example what the person looks at and where they place the level. The box above the three lines takes a qualifier, which says when or where the meter applies, such as During Development. Each line has an optional Source box, and a × beside the meter removes it. You do not need all three lines.

  9. Under Stakeholder, search and select the stakeholder.

    Under Stakeholder, type in the box that shows Search stakeholders and select a match. A stakeholder is a person, group or system that cares whether a Value goes up or down.

    The Value card with the search box "Search stakeholders" under "Stakeholder" outlined in orange.
    The Value card with the search box "Search stakeholders" under "Stakeholder" outlined in orange.
    Show as text

    Under "Meter" (now with its HumanAgent, AiAgent and Instrument boxes), find the "Stakeholder" part. Its outlined box reads "Search stakeholders". Type part of a name and pick the person from the list. The other "Search stakeholders" box, lower down, belongs to "Authority".

    More about this

    When the card is not in edit mode, press + Add first. If none matches, the screen says No stakeholder record matches. Press + New stakeholder to make one without leaving the card. The line is always shown on a Value, but nothing forces you to fill it.

  10. Under Value of Function, search and select the Function.

    Under Value of Function, type in the box that shows Find a Function by tag and select the Function. A Function is what the system does, written as an action, and this line names the one this Value measures.

    The Value card with a stakeholder chosen, and the search box "Find a Function by tag" under "Value of Function" outlined in orange.
    The Value card with a stakeholder chosen, and the search box "Find a Function by tag" under "Value of Function" outlined in orange.
    Show as text

    The stakeholder's name now shows under "Stakeholder" with a red remove button. Below it, under "Value of Function", the outlined box reads "Find a Function by tag". Type the Function's tag and select it from the list.

    More about this

    The box finds a Function by its tag. If no Function matches, press the button that starts with Create Function to make one with the tag you typed. When the card is not in edit mode, press + Add first. The Function then shows this Value under Function of Value. A Source box under it can name who said it; it is optional. The line is optional for saving. When you have finished, press Done; what you typed is already saved.

Deeper

Also asked:

How do I write how good something must be? Write it as a Value: in Plan, press + New, choose Value, type a tag and press Create. Under Levels, type its Goal, the number you plan to reach, and its Tolerable, the survival limit.

Can I change my plan by hand, or only through Kai-Zen? Both. Anyone who may write in the vault can change the plan by hand here. Kai-Zen's agents keep a number a person set and change it only with a yes; after you add or change a spec, Kai-Zen sharpens the plan again.

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

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

A new Value shows the level Product 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 Value's status is a level on its Scale (Status under Levels), not a separate line. The answer on updating a Value's Status shows how to record a new reading.

To add another level, such as Past (an earlier number kept as history) or Wish (a number someone says they would like), press the button with that word beside + Level under Levels. The buttons are Past, Status, Tolerable, Goal and Wish, then Other word…. + Level opens a menu of the same kinds, but in GilbApp today choosing from it can end edit mode, so press the button. Other word… opens a box that shows Other word, Enter for a word of your own. Below is a box that shows Paste lines, e.g. Goal [2027-06-30, Release 3.0] 5 <- Kai-Zen estimate and the button Add pasted lines, which works only after you paste. None is needed to save.

Under Authority, you can search and select the named person who has the power to decide, influence or enforce something about the Value. If no one matches, the screen says No stakeholder record matches.; press + New stakeholder to make the person on the card. The method names a person, not a role or a group, and requires one only on a constraint, so on a Value the line is optional. After you choose one, an acts for line with a Search records box can name whom the person acts for; optional. A Source box under Authority can name who said it; optional.

More lines are hidden until you add them: press + Add Information at the foot of the card, or the + beside Done, and choose one. Type is the kind of thing the Value is about, chosen from the types in GilbVeda, the shared list of terms; it shows No GilbVeda type until you search and select one, and has an optional Source box. Impacts are the estimated effects of Solutions on this Value. They need a single number in Status under Levels (step 7), not a range; without it the screen says the Value's Status must be set first. They also need a Solution to pick (the box shows Find a Solution by tag); in edit mode the picker is open by itself (outside edit mode, press + Add first). Ambition Level is an optional list of short parts, written like a Function's Description. None is needed to save.

This answer is written for a computer screen.

Source: GilbApp af0f04ee838a4d55887d2ff1f72edd49a4ff7ca0 (https://gilb.com/app/version.json, built 2026-11-09, read 2026-11-09); since 19d95463 only planValue.ts (the Scale sentence is gone; no box for it was drawn) and one comment line of PlanValueLines.tsx changed. Lines as round 3, 5b-5m and 9c: gilbAppMenuRows.ts:160-166; NewRecordButton.tsx:75, :89; planKinds.ts:5-14, :101-107, :162; recordTypes.ts:379-409; TypeChooser.tsx:247-262, :376-398, :520; ConnectedCreateDialog.tsx:319, :1417-1429, :1832-1846, :2065-2091; planLinks.ts:208-213; cardMode.tsx:233-301; PlanTypeLevelVersion.tsx:110-145; PlanValueLines.tsx:791-997 (Scale), :1798-1818 (Meter), :1937-2193 (+ Level menu, kind buttons, Other word…, paste box), :2043-2045 (blank Status/Tolerable/Goal rows), :2285-2291 (Add value), :2478-2590 (row boxes); cardMode.tsx:89, :215-225 (the portalled + Level menu can end edit mode: round 9c); planValue.ts:67-69, :1645-1692; PlanFunctionForm.tsx:521-528, :1591-1636, :2128; PlanStakeholders.tsx:440-465, :553-572, :892, :911; PlanTagLinks.tsx:362, :844-845; PlanCell.tsx:543-569; PlanCellValueSide.tsx:455-488, :726; PlanValueGraph.tsx:1538-1548; AddInformation.tsx:33. GilbVeda t:Value a:does (read 2026-11-09, matches the quoted DEFINITION), t:Scale, t:Meter, t:Status, t:Tolerable, t:Goal, t:Qualifier, t:Past, t:Authority. Kai-Zen.ValueRules, Kai-Zen.ValueTemplate, Kai-Zen.UpdateStatus (rounds 3, 9). Shared sentences with the Status answer step 4 (buttons, menu, paste box). Live cap 10 pictures (brief). Live answers: What if the AI estimates a level I set?; How do I challenge a Solution?; How do I release a Constraint?

Checked against GilbApp d529620.