Stomra Guides

Stomra · Guide

Modelling with your AI assistant

How to get good, light models from the assistant you connect to Stomra, and how to teach it your way of building once.

The same insulated wall build-up drafted heavy, as hundreds of single lines, and light, as a region, an insulation item and a repeating detail Heavy: drawn as single lines Light: one item for each thing hundreds of lines, each an object to draw, save and fix by hand when the wall moves a region with a pattern one insulation item a repeating detail three objects
Both drawings look the same on the sheet. The one on the right is three objects that follow the model and change in one step; the one on the left is hundreds of lines. Ask your assistant for the right-hand kind.

How the assistant works in Stomra

Stomra has no AI of its own. You connect the assistant you already use, such as Claude or ChatGPT, through the Stomra connector, and it works in your projects with your rights and no more. Stomra with your AI assistant says how to connect it.

Most of what follows is already in that guide, so a good assistant does it unasked. Knowing it helps you steer: you can ask for the right thing, and you can tell when the work is going the wrong way.

Start a session well

  1. Open the project in a tab. With the project open, the assistant can change it, draw pictures and make files. With several tabs open, tell it which project you mean.
  2. Let it read the project first. It reads a summary of the project (levels, grids, types, views, sheets and counts), its files and what the Handbook holds for it. If a previous session left a handoff note, it tells you where the work stands before it changes anything.
  3. Give it the brief. On a new job, paste the brief and attach the drawings. The assistant files the brief in the project (Files ▸ Brief), so the next session and your colleagues read the same thing. It asks what the drawings leave out, such as a storey height or the scale, instead of guessing.
  4. Say who decides. The assistant follows a fixed order: the building code, then your word and the client's for this task, then the project's own decisions, then your organisation's lessons, worked examples and general instructions, then Stomra's defaults. When you want something done differently from the Handbook, just say so.

Small steps you can follow

The assistant models in your live project, in small coherent steps you can watch: a wall run with its openings, a beam with its supports, a detail with its notes. Each step is one batch and one Undo step. It explains the next step, applies it, looks at the result and corrects it before it goes on.

The working loop: say the next step, apply it as one batch, look at the result, correct it, then the next step Say the stepwhat and why Apply itone batch, one Undo Looka picture, a read Correctbefore going on the next step
The rhythm the assistant keeps. You can step in at any point: it reads what you changed and builds on it.

Ask for the light form

A model gets heavy in a few predictable ways: a fill drawn as many single lines, insulation drawn as a zigzag of lines, a repeated object stored again and again, an outline traced by hand over a cut. None of them is forbidden; each makes the model slower to open, draw and change, and none follows the design when it moves. In Stomra each has a light form that draws the same thing as one object.

Instead ofAsk forWhy it is better
A hatch drawn as many linesA region with a patternOne object; its outline can follow the model
Batt insulation drawn as linesAn insulation itemOne object along a path, scaled to its thickness
Battens, tiles or screws drawn one by oneA repeating detailOne row with a spacing
A fixing or profile drawn again in every detailA 2D family from the Handbook, or a new oneDrawn once, placed many times, kept for the next project
The model's cut traced in 2D linesNothing: the model draws its cutThe cut follows the next edit; traced lines do not
The same house or room modelled againA group placed several timesChange one instance and every instance follows
A dimension with typed textA dimension that measuresMove the geometry and the value follows
Delete and rebuild to change somethingAn update of what is thereKeeps the element's history, hosts and tags

Stomra's guide already tells the assistant to draft with the item that draws most at once, and never to trace the cut in lines. A sentence from you settles it for good: "Hatches are regions, insulation is an insulation item, never single lines." Said as a lasting rule, the assistant keeps it as a lesson (see Teach it once).

Model what is counted, draft the rest. What is counted, checked or seen in other views belongs in the model: walls, layers, beams, pipes. Fixings, sealant, membrane laps, flashings, notes and most hatches belong in 2D on the model's cut. A detail at 1:5 is mostly 2D; a plan at 1:100 is mostly model.

When the model is right but a cut draws wrong, the assistant does not bend the model to make one drawing look right. It overrides the look in that view, drafts over it, and offers to report the problem to Stomra.

Read little, ask precisely

Your assistant has a limited budget for each answer, and a large project does not fit in one read. Stomra is built so that it never has to load everything.

The map first

A project is stored as a tree of folders by discipline, level and category. The assistant reads the map, then the folder the task is about.

Summary, index, full

A few kilobytes for the project, a short row per element, and the whole record only for the elements it is about to change.

Ask, do not load

To count, add up or find, it asks a query ("how many windows on level 2, by type") instead of reading every element.

Only what changed

After one read, it asks for the changes since then. Between sessions, a named version is the base to compare with.

You help by asking about a place and a thing: "the beams on level 2 in grid C–D" gets a precise answer faster than "check the structure".

Point instead of describing

Saying where something is in words is slow and easy to get wrong. Stomra gives you three ways to point.

Work orders written while you walk the model, and prompts sent from the AI sketch, are in Work orders.

The AI sketch

Draw over any view with the AI sketch pen: ring what you mean, draw a line or an arrow to where it should go, add a short note. The assistant reads the sketch as a picture of the view with your strokes, which elements each stroke rings or crosses, and their positions in the model. From the sketch's menu, Send prompt to assistant freezes the sketch together with your words and sends them as a prompt; the assistant carries out waiting prompts in turn.

Work orders in walk mode

While you walk the model, aim at something and press O to write a work order: "Move this 1 m to the right". The order keeps what you aimed at, where you stood and two pictures, so "right" means your right. You follow orders in Project ▸ Work orders.

What you aim at

While you walk, the assistant can see where you stand and what you aim at. "Move this door" in the chat means the door in front of you, with no order written.

Teach it once: lessons and the Handbook

How the Handbook itself works, with shelves, ratings and which source wins, is in The Handbook.

When you correct the assistant or tell it how you always do something, it does what you asked and then keeps it, so nobody has to say it again. A correction for this time only ("just here", "in this room") is done and never kept.

Lessons are also learned from your edits of the assistant's work: see Lessons learned.

Lessons

A lesson is a short rule in your own words, kept at once with the scope your words give it:

ScopeExample
The organisation"We always put switches at 1100 mm above the floor."
A kind of building"In our halls the slab on ground is 3 × 100 mm EPS."
This project"The client wants oak thresholds throughout."
You alone"Answer me in Swedish."

The Handbook

The Handbook is the formal side: how your organisation builds, written by its editors. It holds worked examples (when a method applies, what to ask first, the measures that govern it, the recipe, what has gone wrong before and when it is done), drawing examples and general instructions with their named values. Before the assistant models something a worked example covers, it reads the example, asks its questions, follows its recipe and says which example it followed.

When what you ask differs from a value in a general instruction, the assistant asks once: update the Handbook, keep a deviation for this project only, or keep the Handbook's value. An editor's change is in force at once; a member's is a draft for an editor.

The fastest way to good results across a team is a Handbook with a few worked examples for the parts you build most, and lessons for the rest. The assistant then follows your firm's way of building from the first session.

Check and hand over

Prompts that work

Read the project and tell me where it stands before you change anything.
Model the ground floor walls from the PDF in Brief, one wall run at a time,
and check each level against the drawing before you go on.
Draft detail 3 on the section's cut: regions for materials, an insulation
item for the mineral wool, a repeating detail for the battens. No single lines.
Save a version called "Before facade change", change all exterior walls
to our new exterior wall type, then tell me what changed.
Take my work orders as I write them.
From now on: in our villas, switches go at 1100 mm. Keep that.