# How do I write a Value in my plan?

Checked 2026-11-15 against GilbApp d5296208bbffa2ab70076e6194f5537c4be1ddf7.

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](http://support.gilb.com/help/how-do-i-sign-in-to-gilbapp) on a computer, with a vault you can write to, such as [your own vault](http://support.gilb.com/help/how-do-i-create-my-first-vault). 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 "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".

   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".

   ![GilbApp with the "GO TO" panel open, and "Plan" under "YOUR SECTIONS" outlined in orange.](http://support.gilb.com/help/media/19263b830249232b.png)
   What you see: 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.
2. Press "＋ New".

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

   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.

   ![The "Plan" screen with the list of plan records and no record selected, with the "＋ New" button at the top right outlined in orange.](http://support.gilb.com/help/media/8c575e37f43e6c33.png)
   What you see: 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.
3. Under "TYPE", choose "Value".

   In the list under "TYPE", choose "Value".

   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.

   ![The new-record dialog headed "New function" with the list under "TYPE", with the "Value" option outlined in orange.](http://support.gilb.com/help/media/92794652dd7aefc5.png)
   What you see: 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".
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 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.

   ![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.](http://support.gilb.com/help/media/e38103e85b5f92df.png)
   What you see: 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".
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.

   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.

   ![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.](http://support.gilb.com/help/media/c89ddc5f5bdb8dfa.png)
   What you see: 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.
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 "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.

   ![The Value card with the empty "Scale" boxes, and the "Unit" box showing "e.g. minutes" outlined in orange.](http://support.gilb.com/help/media/cb182d503831e0b1.png)
   What you see: 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.
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.

   "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.

   ![The Value card scrolled to "Levels", with rows "Status", "Tolerable" and "Goal", and the number box on the "Status" row outlined in orange.](http://support.gilb.com/help/media/77e2097e9ec28e92.png)
   What you see: 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.
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 "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.

   ![The Value card scrolled to "Meter", with the "+ Meter" button outlined in orange.](http://support.gilb.com/help/media/da0360b5a35204f2.png)
   What you see: 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.
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.

   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.

   ![The Value card with the search box "Search stakeholders" under "Stakeholder" outlined in orange.](http://support.gilb.com/help/media/b070865498dddf33.png)
   What you see: 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".
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 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.

    ![The Value card with a stakeholder chosen, and the search box "Find a Function by tag" under "Value of Function" outlined in orange.](http://support.gilb.com/help/media/1018f97729a1cebc.png)
    What you see: 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.

## 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](http://support.gilb.com/help/how-do-i-update-a-values-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 &lt;- 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?
