2026-07-18 · Updated 2026-07-19 · 2 min read
Use YYLO Ledger as the source of truth for agent work
Model readiness, evidence, and relationships explicitly so humans and agents share one executable task state.
By Juno AI INC · yylo-ledger · task-truth
A task system becomes useful to agents when its state is structured enough to query and strict enough not to depend on Markdown formatting conventions.
Separate three relationships
blocked_bycontrols readiness and execution order.related_taskslinks useful context without blocking work.commit_hashties a completed response to repository evidence.
Move through explicit states
One task in progress per agent keeps ownership legible. Mark done only after the task’s gate passes; otherwise record a blocker and leave the task open.
Query deterministically
list, search, and ready share ascending/descending last_modified sorting with task ID as a tie-breaker. When status filters are supplied, their explicit group order is preserved.
Keep the response useful
A strong completion response states what changed, the exact commands and browser checks that passed, and any remaining risk. It does not paste uncurated logs or claim success from an exit code that was never observed. See the YYLO Ledger documentation for file-safe response forms.