The Great Library of SISO · Start here
One front door.
A registry that can outlive every folder.
This page is the cold-start map for humans and agents. It explains where truth lives, how public source becomes a release, and how the Library can evolve without pretending its first taxonomy is permanent.
Identity rule
A Work is stable. Repositories, local checkouts, sections, owners, websites, and contextual roles may change. Releases preserve exact evidence; Snapshots say which versions form a named view.
A Work is stable. Repositories, local checkouts, sections, owners, websites, and contextual roles may change. Releases preserve exact evidence; Snapshots say which versions form a named view.
Five-minute boot
- Read README for the model.
- Read Current State for verified facts and resume points.
- Open the highest numeric whole-Library Snapshot—not merely the last lexical filename.
- Read Ecosystem Intelligence JSON for active initiatives, reservations, recent events, ADRs, and registry changes.
- Browse the repository estate and relevant Work pages.
- Before changing anything, run
npm ci && npm run verify.
What lives where
WorksPermanent identities and current descriptive metadata.
ReleasesImmutable, evidenced versions and distribution claims.
SnapshotsNamed selections of Releases plus a versioned browse projection.
AssembliesHow independently addressable Works operate together in one context.
Source inventoriesMixed material mapped before promotion, extraction, or retirement.
Events + ADRsOperational intent, changes, active ownership, reasoning, evidence, and architectural decisions.
Site + catalogGenerated human and machine projections over the same registry.
Publish one change
| Step | Action | Receipt |
|---|---|---|
| 1 · Classify | Read the source and establish ownership, privacy, license, and purpose. | Evidence or an explicit stop condition. |
| 2 · Improve | Change and verify the owning repository. | An exact public commit. |
| 3 · Release | Add a new immutable Release Manifest. | Artifact locator, revision, integrity, and evidenced states. |
| 4 · Select | Add a new immutable Snapshot, preserving unaffected selections. | A metadata-complete named view. |
| 5 · Publish | Verify, push, and deploy the generated site. | Passing gate plus live stable URL. |
Safety and evolution
Never publish credentials, client source, personal notes, machine-specific paths, raw operational databases, or private topology. Never turn a local directory tree into global ontology by accident. If evidence changes the taxonomy, publish a new relationship projection or Assembly version; stable Work IDs and old receipts remain intact.
Preferred machine-neutral checkout: $SISO_WORKSPACE/Great_Library_of_SISO. The precise machine path belongs only in the ignored local location record.