Repository navigation
Decision ADR 0012 One Mathlib Style Source Root
- Status: accepted
- Date: 2026-08-14 (America/New_York)
- Decider: Chris Dare
-
Decision: use one
DerivedAlgGeoLake library and source root, organized by mathematical subject.
The monorepo was assembled from coherent-sheaf, dg-category, and Bridgeland
stability repositories. Their temporary roots (CohLean, DGLean, and
BridgelandStabLean) preserved migration provenance but no longer described
mathematical ownership. They also forced consumers to remember repository
history in imports.
Mathlib provides the appropriate model: one public umbrella and a hierarchy of subjects with same-named intermediate umbrellas.
The public package, source directory, and umbrella are all named
DerivedAlgGeo. Most code is owned by:
-
DerivedAlgGeo/AlgebraicGeometry; -
DerivedAlgGeo/CategoryTheory, includingDGCategory,Triangulated,TStructure, andStabilityCondition.
Generic lattice and matrix prerequisites live in LinearAlgebra; genuinely
generic helper results may live in small Algebra or Topology subjects.
Exploratory probes live in Development and remain outside the public root.
Declarations use established mathematical namespaces rather than a repository prefix. The three retired roots and namespaces must not be restored.
-
import DerivedAlgGeois the complete stable import. - Consumers can select narrow subject umbrellas without knowing migration history.
- Existing audit lanes remain separate for coverage tracking but inspect one library.
- Historical ADRs, reviews, and Git commits retain the old names as provenance; current instructions and roadmaps use the new hierarchy.
Exported from .claude/decisions/ADR-0012-one-mathlib-style-source-root.md at the commit that removed it from the tree.
Architecture
- Canonical roots and specialization trees
- Structural cutover ledger
- Generalization backlog
- Dependency direction
- Loop-engineering friction log
- Mathematical ownership and abstraction boundarie
- Declaration placement
- When a proposition-valued class is justified
- Enhanced spherical twists: conventions and remai
- Verification history
CI and runners
- Bounded audit batching probe, 2026-09-27
- CI1.10: audit and exception record contention, 2
- Proposed hosted-only CI cutover for CI1.07
- Mac VM runners
- Owner CI lane: self-hosted runners in a private
- CI performance baseline, 2026-09-27
- CI1.07 exact-tree Ubuntu routing sample, 2026-09
- Ubuntu workstation runners (historical topology)
Decision records
- ADR-0001 — The seam is cold: files, not runtime (superseded)
- ADR-0002 — Identity is minted in the topic repo, (superseded)
- ADR-0003 — Elaboration and axiom evidence is pro (superseded)
- ADR-0004 — The statement registry lives in the t (superseded)
- ADR-0005 — Seven axes, four values, no aggregate (superseded)
- ADR-0006 — All contract issues are filed on `bri (superseded)
- ADR-0007 — Where the contract package lives (superseded)
-
ADR-0008 —
@[cites]ships as a shared Lake dep (superseded) - ADR-0009 — The contract package lives with the e (superseded)
- ADR-0010 — How a dg category is encoded, and whe
- ADR-0011 — Hom-complexes are complexes of abelia
- ADR-0012 — One Mathlib-style source root
- ADR-0013 — Own reusable moduli infrastructure in
- ADR-0014 — Stacks, algebraic spaces and moduli:
Roadmaps