Stomra Guides

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.

1 You say it or edit what the assistant made 2 Kept at once a card shows it, with Undo 3 Followed filled in, checked, named: “per L-3” 4 Counted used, nudged again, unused 90 days 5 Reviewed merged, struck, retired 6 The Handbook a lesson that holds becomes an entry A lesson that was wrong is struck and fades out; a changed rule becomes its next version. THE LESSON LOOP
Nobody approves a lesson before it holds. It is kept at once, shows what it did, and is reviewed after the fact. The ones that keep holding grow into the Handbook.

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.

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 assistantWhat is kept
Set the same height on at least two, and at least half, of one type's elementsThat height, as a value Stomra fills in next time
Swap its elements to another typeThe type to use
Change the layers of a type the assistant madeThe 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.

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

When a lesson is wrong

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.

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.