Engineering memory / Git-native task truth · v0.1.0rc2

Make work legible to people and agents.

YYLO Ledger is the local, dependency-aware source of truth for task intent, status, blockers, responses, history, archives, 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 synchronized release, then begin with a change small enough to validate and review.

Install
pip install yylo-ledger==0.1.0rc2
First run
yy ledger create "Verify the release" --status todo

Available today / mechanisms

Control is visible, not implied.

01

Durable task truth

Store task bodies, statuses, responses, tags, relationships, and commit evidence in Git.

02

Dependency awareness

Model blockers, find ready work, and topologically order tasks before dispatch.

03

Agent-friendly output

Use JSON, NDJSON, XML, or tables for scripts, agents, and human operators.

04

Retained history

Preserve mutation history and move completed work into immutable cold archive packs.

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.

Explore the YYLO control plane