project-ledgerlisted
Install: claude install-skill aeoxyz-jpg/project-ledger
# project-ledger
Keep factual state in `ledger/` — one **current-state page** per topic.
Your role in this project is to record and cross-check, not to synthesize from
conversation memory.
Page structure: `## Facts` / `## Open questions & hypotheses` (containing
`### Ruled out`) / `## Current decision & next step`. The sections are the formal
marker — which section something goes in is what makes it fact or guess.
## Session start
1. **The moment this skill triggers, the first thing to do is confirm whether this
project has a ledger.** Nothing injects it for you; answering without checking
means answering from conversation memory. Read `ledger/_index.md`; if you can't
find it, `ls` the project root before concluding. If it exists: read the index
before answering anything that touches a ledger topic. If not: ask the user
whether to initialize one. Initializing = create `ledger/topics/`; tell the user
the ledger is written to disk (including opinions about third parties and contact
details) and ask whether any category should stay out; handle git per rule 2.
2. **Check whether git is available** (`git rev-parse --git-dir`):
- Available: run `git status -- ledger/` and `git diff -- ledger/`. If there are
uncommitted changes, show them first and say that last session's ledger edits
haven't been reviewed yet. Those pages are still usable this session, but flag
them as unreviewed when citing them.
- Not available (no git, or this folder