h0ffmann d876269679 Merge pull request #4 from piabrota/hard-fork-notice
Add the hard fork notice to the README
2026-11-01 06:18:36 -03:00
2026-11-01 05:32:45 -03:00
2026-11-01 05:32:45 -03:00
2026-11-01 05:32:45 -03:00
2026-10-11 16:56:32 +02:00

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.
  • 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 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
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.
Languages
Shell 92.7%
Python 4.7%
Nix 2.3%
Jinja 0.3%