Files
mu/docs
Matheus HoffmannandClaude Opus 5.5 1a0f30f9af Make mu the company chart: the eight products, the site's logo, む, adr-verbatim
- mu is piabrota's company chart, not an umbrella, and the README header is centred.
- products/ holds pirsig, alerts, ihero, gramatico, nix-os, dojo, rax and agents. The yggdrasil and
  asgard submodules go; our forks of them stay in the index.
- PIABROTA.md follows the org as it is now: 24 public repos.
- The logo is the eye that piabrota.art shows. む is drawn in pure Nix, with nix-os' pen, and checked by
  the flake.
- .claude/skills/adr-verbatim is copied unchanged from davidondrej/cloudroom, under Apache-2.0, with
  credit in NOTICE.md.
- The map shows the eight products, and the portfolio figure goes.

Co-Authored-By: Claude Opus 5.5 <[email protected]>
2026-11-01 05:23:40 -03:00
..

piabrota

piabrota is an open software fabric made in Rio de Janeiro. This repository, mu, is the company chart. Read the dogma first, then the charter.

The map

piabrota map: owners write the rules and approve direction in mu, the company chart, which pirsig manages; the products are gramatico and pirsig (think and write), alerts, rax, agents and nix-os (warn and host), ihero and dojo

How to read this figure. Top to bottom, one lane per kind of work. A red border marks the people who steer. The source is piabrota-map.json.

Contents

Folder What's there
1-company/ charter, roadmap, budget, legal, readiness, repositories
4-ways-of-working/ the standards every piabrota product follows: spec-driven development, docs, writing styles, diagrams
5-research/ company-level research
6-journal/ the journey: challenges, solutions, results
7-branding/ the piabrota identity and voice, and the naming record
DECISION_MODELS.md the decision models we track, and where routines run

PIABROTA.md indexes every public repo of the org. The eight products are submodules under products/: clone with --recurse-submodules.

Dated records in 5-research/, 6-journal/ and 1-company/readiness/ keep the name Ouroboric, as they were written; see NOTICE.md.