ledger-flow

Standardizes progress ledger and handoff document lifecycle rules for Markdown checklists.

Updated Jun 24, 2026
One-click install
npx skills add https://github.com/Hakkadaikon/hymme --skill ledger-flow-hakkadaikon
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: ledger-flow
Source: https://github.com/Hakkadaikon/hymme/tree/main/skills/ledger-flow
Command: npx skills add https://github.com/Hakkadaikon/hymme --skill ledger-flow-hakkadaikon

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Progress ledgers, todo lists, and STATUS documents drift into inconsistency: ad-hoc checkbox notations multiply, the same progress is tracked in multiple files that disagree, completion claims lack evidence, and finished documents fossilize while still marked open. This Skill defines operating rules so ledgers never report unverified work as done and history is never lost. ## Core Features & Use Cases - Notation Standardization: Fixes a single three-state checkbox legend ([ ] / [~] / [x]) defined once per ledger, forbidding custom markers that break machine checks. - Single Source of Truth: Designates one file as the ledger to reconcile; other documents become references, preventing contradictory progress reports. - Evidence Pointers & Lifecycle Closure: Requires every completion claim to carry a proof pointer (log path, test name, commit hash, CI URL) and mandates closing finished documents with a closed marker and successor reference. - Use Case: When finishing a task, you update the ledger row with a commit hash in the same commit, close the stale STATUS document, and keep the plan document write-once with a pointer to the live ledger. ## Quick Start Ask the AI to update the progress ledger and close out the completed handoff document following the ledger-flow rules.

Frequently Asked Questions about ledger-flow

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I keep a progress ledger consistent across multiple documents?

Designate exactly one file as the ledger you reconcile, and convert all other documents that mirror the same work into references pointing to it. Never update plan documents, test lists, and STATUS files in parallel, since one will always lag and contradict the others.

What checkbox notation should a Markdown task ledger use?

Use a three-state legend defined once at the top of the ledger: `[ ]` for not started or unverified, `[~]` for partial completion with the remainder noted inline, and `[x]` only when both implementation and verification evidence exist. Do not invent custom markers like `[対象外]`, which break machine checks.

How should completion claims be recorded in a progress ledger?

Every `[x]` or PASS record must carry an evidence pointer on the same line or immediately after: a log file path, test name, commit hash, or CI run URL. Verify the log actually exists before recording, and never mark items complete before the corresponding commit.

When should a STATUS or handoff document be closed?

Close any completed or obsolete document by adding a `closed (YYYY-MM-DD), successor: <doc or none>` line at the top. Leaving documents open lets stale checkboxes and 'in progress' statements fossilize, forcing later readers to guess whether the document is still alive.

Does ledger-flow manage superpowers SDD progress ledgers?

No. The superpowers SDD ledger at `.superpowers/sdd/<plan>/progress.md` is owned by superpowers and keeps its own line format. This Skill governs hymme-side ledgers such as T-ID ledgers, todo files, and STATUS documents, and forbids rewriting SDD ledger notation.

What are the limitations of manual ledger maintenance?

Manual counting of unchecked items and ID gaps is error-prone, so the Skill recommends deterministic machine checks such as PreToolUse hooks that block on remaining `- [ ]` items or numbering gaps. It also forbids inventing new ledger formats when plain Markdown checkboxes suffice.