skills.rest
xaionaro
xaionaroCOMMUNITY
Explore all skills by this author →
GitHub

maintaining-context-ledger

Maintain a current-state ledger and append-only log for project changes.

Updated May 4, 2026
Search Tags:#log#project-management#append-only#ledger#status-report#context-ledger
One-click install
npx skills add https://github.com/xaionaro/.config-codex --skill maintaining-context-ledger
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: maintaining-context-ledger
Source: https://github.com/xaionaro/.config-codex/tree/main/skills/maintaining-context-ledger
Command: npx skills add https://github.com/xaionaro/.config-codex --skill maintaining-context-ledger

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Maintains a current-state ledger and an append-only log to capture every material change in a project, enabling reliable handoffs and auditable history.

Core Features & Use Cases

  • Ledger trio: project-understanding.md (current-state snapshot), high_level_log.md (append-only history of changes), and latest-status-report.md (latest status per writing-status-reports).
  • Clear separation of concerns: the ledger captures the current truth, the log captures what happened and why, and the report surfaces the latest status for quick relay.
  • Governance and storage: these files live under per-session cache paths and are not stored in the project repository; updates follow a strict, non-destructive workflow with a three-pass ledger edit process and a synchronized log.

Quick Start

Create and update the three files (project-understanding.md, high_level_log.md, latest-status-report.md) in the per-session cache and begin recording the current state and material changes.

Frequently Asked Questions about maintaining-context-ledger

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

FAQPage Schema
How do I maintain a verifiable append-only log for project management handoffs?▼

An append-only log captures every material project change in high_level_log.md, ensuring reliable handoffs and auditable history. The log is synchronized with a current-state ledger and never deletes past entries.

What is the best way to keep a current-state ledger updated during a project?▼

A current-state ledger in project-understanding.md stores the latest project snapshot using a strict, non-destructive three-pass edit process. This separates the current truth from the historical log and status report.

How does an append-only ledger improve status reporting for agents?▼

An append-only ledger improves status reporting by maintaining latest-status-report.md alongside the log, ensuring consistent knowledge transfer between agents. It surfaces the latest status for quick relay without altering past history.

Do I need to store the project context ledger in my repository?▼

The project context ledger is not stored in the repository; it lives under per-session cache paths. This governance keeps transient session data separate from your version-controlled project files.

Can I delete past entries from the project log when recording new changes?▼

No, the project log uses an append-only workflow that never deletes past entries. This non-destructive approach preserves an auditable history of every material change alongside the current-state ledger.

When do I need a context ledger for project management?▼

A context ledger is needed when you require reliable agent handoffs, verifiable history, and consistent status reporting. It separates the current truth from what happened and why, ensuring accurate knowledge transfer.

Related Skills

Explore More Product & Management Skills→
mistakeknotmistakeknot
3

intercache

Cache file content across Claude Code sessions using SHA256 hashes and per-project manifests.

Community
Intermediate
ianshankianshank
1

planning-handoff

Capture planning artifacts and generate structured handoff documents for DEV-SQE phases.

Community
Advanced
ProfSynapseProfSynapse
71

pact-task-tracking

Coordinate PACT specialist agents through structured text-based task tracking protocols.

Community
Basic
whatagraphwhatagraph

whatagraph-snapshots

Create, list, and restore Whatagraph report snapshots of tabs and widgets.

Official
Intermediate