← Simple House PlannerCONTENT HISTORY

Update to Simple House Planner

Snapshot Nov 16, 2026 · 18:16 UTC · version 1.0.0

Collection source: downloaded plugin package.

WHAT CHANGED

First saved snapshot

No earlier snapshot is available to establish a change.

Save Simple House Planner and check future changes in Following.

Up to 3 plugins free · no card required.

Compare saved observations

Download comparison JSON
Full technical diff · 0 changed fields
Full snapshot data
{
  "description": "Design a house or apartment from a brief with Simple House Planner, floor by floor, and show it in the editor. Use when someone asks for a new floor plan or house.",
  "included_files": [],
  "name": "design-house",
  "skill_md_contents": "---\r\nname: design-house\r\ndescription: Design a house or apartment from a brief with Simple House Planner, floor by floor, and show it in the editor. Use when someone asks for a new floor plan or house.\r\n---\r\n\r\n# Design a house\r\n\r\nTools: `create_project`, `edit_project`, `describe_plan`, `query_project`, `search_furniture`, `open_editor`, `undo_change`.\r\n\r\n1. Read `plan.brief()` when you work on a plan someone started: it holds their answers and their wishes in `notes`, and the project already holds a first version built from them, which you improve rather than replace. Ask only for what the brief leaves open: the number of floors, bedrooms and bathrooms, the rough size or plot, the roof shape (gable, hip, shed or flat), and the town where the house stands.\r\n2. Plan the rooms on paper first: a rectangle for the outline and the inner walls that split it, with hallways at least 1000 mm wide.\r\n3. Call `create_project` with a short title, then `open_editor` with its `project_id`, so that the person watches the house grow. Build the ground floor with one `edit_project` call:\r\n   - `plan.info({latitude, longitude})` with the site's place from the town or address the person gave, so that the 3D view's sun and shadows fall as they do there; `describe_plan` names the place and its time zone,\r\n   - `plan.walls(0, outline, {closed: true, thickness: 240})` for the outline,\r\n   - `plan.wall(0, from, to, {thickness: 120})` for each inner wall; `{curve: 1500}` bends a wall into an arc that bulges 1500 mm to the left of from → to (negative bends it right), and `plan.circle(0, center, radius)` closes a round room or tower,\r\n   - `plan.marker(0, name, point)` inside each enclosed area,\r\n   - `plan.door(wall, offset, {width: 900})` and `plan.window(wall, offset, {width: 1200, elevation: 900})`, away from wall joints; `{head: \"round\"}`, `\"segment\"` or `\"pointed\"` gives an arched top, and on a curved wall they follow the curve,\r\n   - furniture with `plan.against(wall, offset, item, room)`; find items with `search_furniture`.\r\n4. Read the description and the warnings in the result. Fix every warning with another `edit_project` call. The warnings say what a person would notice walking through the plan: furniture in the way through a door, doors that swing into each other, a closet, appliance or toilet with less than 600 mm free in front, a bed with less than 600 mm free beside it (along both long sides for a bed for two), tall furniture in front of a window, furniture over a built-in, a kitchen whose sink, hob and fridge lie less than 900 or more than 2700 mm apart or with something between them, less than 2000 mm of headroom over a stair, and rooms whose doors no way 600 mm wide joins. You cannot see the plan, so these are how you find layouts that look wrong; leave one only when the person asked for that layout. When the person wants a barrier-free home or one built to US codes, also check it with `plan.check(\"din18040-2\")` (DIN 18040-2) or `plan.check(\"irc2021\")` (the 2021 IRC) in a `query_project` script; each warning names the part of the rules it comes from.\r\n5. Shape the site when the brief has one: `plan.slope(percent, downhill)` for a sloped plot, with `plan.site({grading: \"natural\"})` to set a hillside house into the slope with its lower floor opening downhill; `plan.site({winter: \"snow\"})` for snowy winters, or `plan.site({ground: \"desert-sand\"})` for a desert site with dry lawns and no snow; `plan.surface(0, \"water\", min, max, {level: -1500})` for a lake below the house, `{water: \"sea\"}` for the sea or `{water: \"river\", flow: [dx, dy]}` for a river that flows that way, a winding one with an outline and `curves`, with `plan.platform(0, \"pier\", min, max)` out over it and boats as shapes with `plan.shape(0, at, parts, {draft})`, which float that deep in the water; `plan.platform(floor, kind, outline)` takes the corners of any outline instead, for an L-shaped deck or one that wraps round the house. `plan.surface(floor, kind, outline, {curves})` does the same for a surface, and `curves` bends its edges: for each corner, how far the edge to the next corner bulges out at its middle, for curved paths, kidney pools and lakes or rivers with winding shores; `plan.surface(floor, \"bed\", min, max, {round: true})` makes a round bed or pond. Model a bank or a ditch with `plan.breakline([[x, y, level], …])`, raise or sink a patio, deck, driveway, terrace or pool with `plan.surface(…, {level})`, and put the driveway and lawns of a house that steps down a hill on its street floor, where the ground meets them. Steep ground turns to scree and rock by itself; `plan.site({banks: \"rock\", surroundings: \"dry-earth\"})` covers the slopes of cut and fill with rock and the ground beyond the plot with dry earth. Furnish the garden with `plan.surface` kinds such as `terrace`, `planter` (a raised bed) and `sunken` (sunken seating with a bench), a pool at the edge of a terrace with `plan.surfaceAt(0, \"pool\", from, to, width, {infinity: true})`, whose vanishing edge is its edge at `to`, so that it can run along the pool's long side toward the view, a mown lawn with `{grassLength: 40, grassDensity: 20}` or a meadow with `{grassLength: 400}`, and beds of your choice with `{plants: [\"shrub\", \"flowers\"], edging: \"brick\"}` (plants flowers, shrub, agave, bamboo and cactus; edging none, stone, brick, steel or timber), and with garden furniture, a pergola, a parasol, a fire pit, a hot tub and boulders from `plan.furniture` (search \"outdoor\" or \"boulder\"). Put a street in front with the `road` and `sidewalk` kinds, each running along its longer side, a `{kind: \"garage\"}` door on the garage, and cars, a carport, a mailbox and a street lamp from `plan.furniture` (search \"street\" or \"car\"); the cars are a sedan, hatchback, SUV, sports car, pickup truck and van, and `plan.set(id, {paint: \"#rrggbb\"})` repaints one. A road that bends or turns, or a side street that joins it, comes from `plan.road`; roads that meet join with rounded curbs. Plant palms, cypresses, olive trees, birches, bamboo, agaves and cacti as well as trees, shrubs and flowers (search \"tree\", \"palm\" or \"plant\").\r\n6. For each upper floor: `plan.addFloor(name)`, a stair on the floor below with `plan.stair`, or `plan.spiral` where space is tight, then the same steps. `plan.stair(floor, [a, b, c], {width, railing})` makes flights that meet at a landing at each point between them, in line or at a turn for an L or U stair; give a stair of more than about 18 steps a landing. A garden stair up to a terrace or deck ends at its top with `{height}`, and steps down to a jetty below the floor start at a negative `{elevation}`; where a stair arrives at a platform, its railing leaves a gap. `{curve}` bends a flight into an arc with winder treads, for a curved stair or, between two straight flights, a turn on winders, and `plan.spiral` stairs take the style `column`, `solid` or `stringers`. A stair's parts take materials and sizes, such as `{treads: {material: \"Stone\"}, balustrade: {material: \"Glass\"}}` for an outdoor stair or glass treads on steel stringers for a loft. Put the roof on the top floor with `plan.roof(top, {shape})`: a modern flat roof is `{shape: \"Flat\", overhang: 0, parapet: 400}` and follows curved and angled walls, open over courtyards, and a cottage roof can show its rafters with `{rafters: true}`. Roof a wing, a porch or a dormer by its ridge with `plan.roof(floor, {from, to, width, eaveHeight})` or over a rectangle with `{min, max}`; a dormer is a roof over its own small walls, its eaves above the main roof's, and opens the main roof behind it. A gable takes a finish of its own with `{gableFinish}`, or glass with `{glazedGables: true}`, and an end wall made taller than the eaves rises into the gable with its windows. A great room or hall open to the floor above is `plan.marker(floor, name, at, {storeys: 2})`, with a railing or walls round the void on the floor above.\r\n7. For an office, shop, workshop or warehouse, raise the floor with `plan.setFloor(0, {height: 4500})`, keep the plan open with glass meeting rooms (`plan.wall(0, from, to, {material: \"Glass\", thickness: 100})`), and furnish it from `plan.furniture`: bench desks, task chairs, meeting tables and phone booths (search \"office\"), AC units and rooftop units (search \"building services\"), and pallet racking, workbenches, a forklift and a shipping container (search \"industrial\"). Ducts and cable trays follow a path with `plan.run(0, \"round\", [[x, y], …], {drop})`, with elbows, tees, reducers and drops where they turn, branch, change size and go down. Ceiling items hang under the ceiling by themselves, and a rooftop unit stands on the roof of its floor under it when the roof is there before it.\r\n8. Give rooms and facades detail with finishes: `plan.finishFace(wall, room, \"paint\", \"#3f5a4c\")` finishes the whole face of a wall that looks into a room, as for an accent wall, `plan.cover(wall, room, {finish: \"subway-tiles\", top: 1200})` tiles that face up to 1200, and `plan.cover(wall, \"left\" or \"right\", {finish, from, to, bottom, top})` covers any part of either face, such as a splashback or a stone plinth outside. `plan.set(window, {frameColor: \"#232527\"})` gives black steel frames, `plan.set(counter, {color: \"#2f3236\", worktop: \"marble\"})` a dark island with a marble top, and `plan.set(sofa, {finishes: {fabric: {finish: \"leather\", color: \"#5b3a29\"}}})` dresses the stuffs of a furnishing's model. A floor area of its own finish is a shape of one prism part 3 mm high.\r\n9. Light the house for evening and night views: recessed downlights, spotlights, track lights, LED panels, cove and under-cabinet strips, chandeliers, pendants and sconces inside (search \"lighting\"), and outside light the facade with wall lanterns or up and down lights (`plan.against` puts them on a wall), the paths and the driveway with step lights, path lights and bollards, trees and walls with garden spotlights and in-ground uplights, the pool with pool lights inside it, a terrace with string lights and the gate with lantern posts (search \"outdoor lighting\"). `plan.set(id, {lumens, kelvin, on})` sets a lamp's output, its color temperature and whether it is on; the 3D view's Sun panel shows the house at sunset, in the blue hour and at night. Dress the rooms with potted plants, books, a teddy bear, a coat stand and a waste bin (search \"decor\"), a coffee machine, toaster, blender and microwave on the counter, wall ovens and built-in microwaves in tall cabinets (search \"kitchen\"), and a TV, speakers and a radio (search \"living room\").\r\n10. Make anything the other calls do not, such as a pagoda, a pyramid, a kiosk, a water tower or a sculpture, with `plan.shape(floor, at, parts, {name, rotation, elevation})`: named parts that are boxes, cylinders, spheres, pyramids, prisms, lathes, lofts or meshes, each with its own `finish` or `color`. Write loops for repeated parts, and read a shape back with `plan.get(id)` to change it when the person asks. Make anything that appears more than once, such as a garden chair, a bicycle or a shelf unit, an item of the project's own with `plan.defineItem(key, {name, category, parts})`, place it with `plan.furniture` or `plan.against`, and list the project's items with `plan.items()`; changing an item changes every copy.\r\n11. For a section through the house, draw its line across the house with `plan.section(floor, from, to)`: the section looks to the left of from → to, cuts every floor along the line and spans its length, and the Elevations and sections dialog and the PDF and DXF sheets draw it beside the four elevations.\r\n12. Tell the person that they can change the plan by hand in the editor, and that you see their changes when you call `describe_plan` again. `undo_change` takes back your own last change.\r\n\r\nLengths are millimeters, y points up, walls are drawn on their centerlines.\r\n"
}

SHA-256 of public snapshot: 0e0141f871e2e445eb459b7dbd9341f0cd09d8506e0f422535b405cfaf3e6676