Skip to content

Latest commit

 

History

114 Commits

Folders and files

Repository files navigation

The piabrota logo, as piabrota.art shows it: an open green eye on red む, mu, brushed in its three strokes, in pure Nix

mu

the piabrota company chart · dogma · repos · decision models · charter · licence

mu is a hard fork of ouroboric-dev/ouroboric, taken at a2573b3 on 2026-10-27. The two repos share history up to that commit. mu does not follow upstream.

Warning

mu is not an Ouroboric project, and Ouroboric does not endorse it. Ouroboric is a partner of piabrota. Report a problem with mu here, not upstream. NOTICE.md keeps the credit, the licences and the list of changes.

In one minute

  • mu is the company chart of piabrota, an open software fabric made in Rio de Janeiro. It holds the dogma, the charter, the standards, the journal and the tools that every piabrota project inherits, and its eight products as submodules.
  • DOGMA.md holds the ten invariants. Agents fix every error a user or an owner reports, in short pull requests. Judgement is decision-oriented: evidence, a decision model, calibrated probabilities, rules that humans define, a verdict.
  • PIABROTA.md indexes every public repo of the org.
  • dojo is the common layer of every repository. It is the umbrella: it pins each repo, this one included, and mu gives it the rules.
  • pirsig will manage this repo: smart notes, PARA and a track record of high-level decisions. brain/ is its fork state.
  • mu began as a copy of Ouroboric's company repo. NOTICE.md keeps that credit.

The map

piabrota map: owners approve direction in mu, the company chart; mu gives its rules to dojo, the umbrella and the common layer, which pins every repository: gramatico and pirsig (think and write), alerts, rax, agents and nix-os (warn and host), and ihero

How to read this figure. Top to bottom. The second lane is the common layer, and the lanes below it are kinds of work. A red border marks the people who steer and dojo. 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
forks/ the forks this repo pins: archify, graphify
brain/ pirsig's fork state: PARA, smart notes, the track record

The eight products are submodules under products/: clone with --recurse-submodules.

Contributing

Run uvx pre-commit install once after cloning, so gitleaks checks each commit for secrets.

Licence

  • Documentation that came from Ouroboric: CC BY 4.0.
  • Scripts (scripts/): AGPL-3.0.
  • What piabrota wrote new, such as the dogma and the Rust templates: MPL-2.0. REUSE.toml says which file is which.
  • Names and logos are not licensed: see TRADEMARKS.md.