← Blog

Grouping forge assets under a brand

Humans nest brand → product family → repository. Forges flatten that into org → repo and spend “Projects” on boards instead. The missing middle layer is a schema failure with UX teeth.

People group work as brand → product family → repository. Forges usually give you only org → repo — and spend the word “Projects” on boards. The missing middle layer is why assets scatter under the wrong roofs.

Platforms keep forcing a flat story onto a nested world.

A person or company thinks in layers: ecosystem brand → product family → repository → working set. GitHub gives you user/org → repository, then bolted on a feature named Projects that means boards and tables — not “a project” in the ordinary sense of a coordinated body of work with many assets. The reserved word was spent on the wrong level of the ontology.

What minds already model

LayerJobExample
Super-org / holding brandGovernance, legal, portfolioMicrosoft, Red Hat, a systems lab
Focused org / product familyShared charter, issue gravity, docs hubVS Code’s orbit, a filesystem substrate org
RepositoryVersioned artifact boundaryconnectome-fs, one adapter, one demo
Working setWhat you have open todayWorktree, edition, agent sandbox

People invent nesting with org-owned orgs, meta-repos, README maps, and Discord folklore because the forge refuses to admit the middle layers. Microsoft owning multiple GitHub orgs is not elegant; it is a workaround for a missing type.

Why this is HCI, not pedantry

Naming is product representation. When the UI says Project and means kanban, newcomers mis-file intent. When there is no first-class family above a repo, maintainers either:

That is cognitive tax paid forever: wrong inbox, wrong footer, wrong mental model for contributors.

The hierarchy that wants modeling

At minimum:

  1. Portfolio (super-org) — who stands behind the work
  2. Charter org — what class of problems this cluster owns
  3. Product / substrate — durable public name
  4. Repositories — shippable boundaries
  5. Surfaces — docs, news, demos, adapters (may be repos or site modules)

GitHub’s Projects (v2) sit beside issues; they do not parent repositories. Topics and lists are tags, not containment. Organization nesting is informal and awkward.

A forge that took human ontology seriously would let a portfolio own charter orgs the way a filesystem owns directories — with inheritance of permissions, default templates, and a browsable tree that matches how people already talk.

What we did instead

We put the graph filesystem substrate under its own org, connectome-fs, rather than personal or Dev-Centr product space. Partner orgs (Dev-Centr, OpenShellOrg, HCI-Nerdz) stay lanes of audience, not owners of the VFS. That is governance by workaround until platforms grow a super-org type.

Dev-Centr’s practitioner note on the same lapse: When code platforms flatten portfolios.