Engineering memory / Git-native task truth · stable v0.4.0

Make work legible to people and agents.

YYLO Ledger is a Git-native task and Record store for dependencies, wiki knowledge, workflow definitions, artifacts, history and commit evidence.

Supplementary visual overview

YYLO Ledger at a glance.

Product behavior and commands are defined by the verified HTML documentation; this artwork provides a high-level visual summary.

Open full-size image Visual overview of YYLO Ledger Git-native task storage, dependencies, archives, and commands

Install / first run

Start with one bounded outcome.

Install the registry-verified stable release, then begin with a change small enough to validate and review. Compare installation paths or review changes by version.

Install
pip install yylo-ledger==0.4.0
First run
yylo-ledger create --title "Verify the release" --body "Check the documented quick start" --status todo

Version-verified capabilities

Know what your installed version supports.

Stable 0.4.0

Tasks and dependencies

Keep task intent, status, blockers and responses in Git-native records.

Stable 0.4.0

Native Records: wiki, workflow and artifacts

Use immutable IDs and revision-safe updates for durable engineering memory.

Stable 0.4.0

Read-only Record host

Serve bounded local views without exposing a mutation API.

Stable 0.4.0

Preservation-first migration

Copy legacy knowledge into Records without deleting original files.

Stable 0.4.0

History and cold archives

Keep current state and append-only history separate.

Stable 0.4.0

Install independently distributed skills

Acquire reviewed skill procedures separately from the Ledger runtime.

Stable 0.4.0

Cross-project routing and machine output

Make destination and output projection explicit.

Stable 0.4.0

Retrieve any Record by ID

Read tasks, documents and artifacts without guessing their kind.

Product direction / clearly separated

How this layer strengthens the System of Work.

Ledger is the task-memory foundation of YYLO's broader engineering-memory direction. Decisions, attempts, deployment, and production outcomes are not all fields in today's task record; they will be connected through the Engineering Change aggregate.

Next step

Use this layer inside YYLO.

Read the YYLO Ledger documentation