Stomra · Guide
Lessons learned
Tell your assistant once. Stomra keeps what you teach it, from your words and your edits, so your whole organisation stops repeating the same corrections.
What a lesson is
A lesson is a short rule from someone in your organisation, kept so that nobody has to say it again: “switches at 1100 mm above the floor”, “pipes follow walls and roof, never across a room”, “our villas' slab on ground is 3 × 100 mm EPS, not 1 × 300”. It keeps the words it came from, who taught it and when.
Lessons are the quick inbox; the Handbook is the book. The Handbook holds your organisation's worked examples, drawing examples and general instructions, written by its editors. Lessons catch everything else, as you work, with no form to fill in. Modelling with your AI assistant gives the short version; this guide goes through the whole loop.
Lessons are kept for projects on stomra.com, and they work with whichever AI assistant you connect.
Lessons from your words
When you correct your assistant, or tell it how you always do something, it does what you asked and then keeps it as a lesson. It does not ask first, and nobody has to approve it.
- A correction meant for this time only, such as “just here”, “this time” or “in this room”, is done and never kept. Neither is one whose scope is unclear.
- A card, Learned while you worked, shows what was kept at a break in your work, with Undo and a switch for who the lesson is for.
- If you tell the assistant to forget a lesson it just kept, it takes it back within the hour.
Before a lesson is kept, Stomra checks it. One that gives a value another lesson gives otherwise is refused, unless it replaces that lesson or says how the two differ (another room, another kind of part). The same lesson twice is not kept twice.
Lessons from your edits
You do not have to say everything. When you change what your assistant just made, and change it the same way on most of it, Stomra keeps that as a lesson for the project by itself.
| What you do after the assistant | What is kept |
|---|---|
| Set the same height on at least two, and at least half, of one type's elements | That height, as a value Stomra fills in next time |
| Swap its elements to another type | The type to use |
| Change the layers of a type the assistant made | The layers |
Only edits within ten minutes of the assistant's change count. Where something runs in plan, such as the route of a pipe or a wall, is not learned from edits; say that in words. The card shows the lesson with what you did, and lets you keep it for you alone, for every project of its kind, or for the organisation.
Who a lesson is for
Your words give a lesson its scope. “We always…” is the organisation's; “in this building…” is the project's.
| Scope | Example |
|---|---|
| The project | “The client wants oak thresholds throughout.” |
| A kind of building | “In our halls the pipes hang from the trusses.” |
| The organisation | “We put switches at 1100 mm above the floor.” |
| You alone | “Show me a 3D picture after each change.” |
The assistant works by the narrowest first: the project's lessons, then its kind of building's, then the organisation's, then your own. It names the lesson it followed (“per L-3”). Lessons for you alone shape how the assistant works for you, never what is built.
Your organisation keeps its own list of kinds of building, starting from Villa, Radhus, Flerbostadshus, Hall, Garage and Tillbyggnad. Anyone in the organisation can change the list, and the Lessons learned page says what kind the open project is. A lesson moves to another scope with one click, on the card or on the page.
From words to work
A lesson starts as words the assistant reads. Some can do more, so that nobody has to remember them, the assistant included.
Words
The assistant reads the lesson and follows it. Every lesson can be this.
A value Stomra fills in
“Switches at 1100 mm” puts every new switch at 1100 mm where its type would have put it elsewhere, for the assistant and for you. A height you choose otherwise is kept.
Types for a kind
“Our villas' slab is 3 × 100 mm EPS” adds that slab type to a project when it becomes a Villa. A type the project already has is left alone.
A check
“Pipes follow walls and roof” makes Stomra warn wherever the model breaks it, whoever drew it. Checks only warn; they change nothing. They are listed in Systems ▸ Check systems.
Values Stomra fills in are the numbers it already gives a default for: the height a device, fire equipment or furniture is placed at, and a type's height and width. A check is either a value an element should have, or runs that keep to walls or to what is overhead. The assistant makes a lesson a check only when your words say exactly what to check.
Handbook ▸ Lessons learned
Everything your organisation has taught its assistant is on one page in the Handbook. Anyone in the organisation can change a lesson, move it to another scope, retire it or bring it back; every version stays in its history.
- Each lesson with the words it came from, who taught it and when, and what Stomra fills in, adds or checks for it. A check shows how many things in the open model break it.
- What it did: how often it was used, and how often the same nudge came back after it. A nudge came back when someone had to set by hand what the lesson already says, or say it again.
- Unused 90 days lists lessons nothing has used for 90 days, ready to retire or change.
- A line for this month and the last: how many lessons were learned, how often they were used and how many nudges came back.
- Retired and struck out keeps the lessons that left, so any can come back.
When a lesson is wrong
- The rule changed. Say so (“switches at 1000 now”): the new rule becomes the lesson's next version.
- The lesson was wrong, or does not apply where it was followed. The assistant does what you ask and counts a strike. Each person can strike a lesson once a day; three strikes take it out, and the assistant tells you.
- It no longer holds. Retire it, on the page or by telling the assistant.
The review
After ten lessons new or changed, or when a building part nears its limit, your assistant is told a review is due. When your task allows, it reads the lessons part by part, merges two that say the same, and asks you the rest: which of two holds when they disagree, whether to retire one unused for 90 days, how to word one you had to repeat. The page says when the lessons were last reviewed, by whom and what changed.
Lessons and the Handbook
When you tell your assistant how you build something, it follows one rule for where that goes.
- If it changes what your Handbook holds, such as a value in a general instruction or the method of a worked example, it becomes a Handbook change: in force at once when an editor says it, a draft for an editor when a member does. The assistant asks once whether it is meant only for this building.
- Anything else is kept as a lesson.
- Where a lesson says otherwise than a general instruction, the lesson is followed in its scope until an editor settles it, and the assistant asks the editor to update the instruction.
A lesson that keeps holding grows up. Once it has been used at least five times, in at least two projects, without being struck or nudged again, the review proposes it for the Handbook. Your assistant drafts the entry: a general instruction with its values, or a worked example with its method and a 2D detail. An editor publishes it, and the lesson is retired with a note that names the entry.
Limits
An assistant could write thousands of lessons, so Stomra keeps room for a set that people can still read: 250 at the organisation's level (its own and its kinds of building's), 25 on one building part, 50 for a project and 30 for a person. When one is full, a new lesson is refused until two that say the same are merged or one that no longer holds is retired.
A lesson holds only what someone in your organisation said or did. It is never taken from a file, a drawing, a client's markup, a supplier's document or a web page, and it never copies a standard's text: only your own value, and the standard's reference if you want it.
Prompts that work
From now on: in our villas, switches go at 1100 mm. Keep that, and make it a check.
That lesson about pipes under the slab was wrong here. Strike it.
Review the electrical lessons and tell me which ones you would merge or retire.