endroit

Workplace-first in practice

A Home is small enough to start and broad enough to grow.

It is not a giant instruction file or a persistent agent. It is an owned workplace whose Rooms, methods and external relationships remain understandable when the occupant changes.

01 · The bootstrap

A Member, a Desk and one Room are enough to begin.

my-home/
├── endroit.json
├── HOME.md
├── members/me/MEMBER.md
├── rooms/home/ROOM.md
└── .desk/
    ├── desk.json
    └── DESK.md

endroit create keeps the initial Desk in the Home Git by default. endroit inituses a separate nested Desk repository by default. --desk tracked|separate|later makes that boundary explicit. Provider front doors are generated from the owned sources. Bootstrap Equipment provide onboarding, orientation, Artifacts, Rooms, Sites and Home Hygiene. Additional Rooms, Sites and optional Equipment appear only when real work needs them.

02 · The workplace

Each noun owns one durable responsibility.

HomeThe durable workplace and shared trust boundary.
MemberOne human collaborator and their durable responsibilities.
DeskA Member’s local continuity, staging and access; its ID names the place, not the person.
RoomOne durable domain and the Material that belongs there.
OccupantA temporary participant; an agent is not a Member.
MeetingA bounded event whose hot context is ephemeral by default.
EquipmentA reusable method, its instructions, limits and optional runtime.
SiteA sovereign repository, service or publication system.
RouteA Desk-owned declaration of local Git access to a Site.

03 · Composition

Methods equip a place. They do not own it.

Room

Start from the durable domain

Give one coherent subject a mission, Material and continuity before choosing a runtime or methodology.

Equipment

Install a way of working

Research, planning or publishing can be added, adapted and removed without absorbing the Room.

Meeting

Compose for the work at hand

Humans, agents, Roles and Equipment meet temporarily. Nothing becomes durable by accident.

Site + Route

Deliver without absorbing truth

A repository keeps its authority while a Desk declares local Git access. A remote-only Site has no Route in 0.8.

04 · Maintenance

Keep the whole Home healthy without hidden automation.

maintain-the-home composes the existing Home, Member, Desk, Room, Site, Equipment, Route, projection and Material checks. It separates confirmed inconsistencies, ownership ambiguities, legacy residue and optional improvements. Inspection is read-only. A repair needs approval for one finding, uses an existing operation and then re-runs the checks.

05 · Different Homes

The responsibilities stay explicit. The contents stay yours.

Example composition

Product Studio

  • Rooms for product, design and engineering domains
  • Shared review and delivery Equipment
  • Repositories and documentation as sovereign Sites

Example composition

Research Home

  • Rooms organized by durable research domain
  • Evidence and synthesis Equipment
  • Publications and knowledge bases declared as Sites; non-Git Routes remain future work

Example composition

Personal Studio

  • One Desk carrying personal continuity
  • Rooms for writing, learning and making
  • Git repositories and publishing systems kept independent

Start with the place

What should still make sense when the agent changes?

That is the first question a Home answers.

Create a HomeInspect Endroit ↗