lets-work
Installation
SKILL.md
lets-work
Entry ritual for a work session. Reads the user's personal state for this project, briefs them on what drifted since their last visit, and sets up how the session ends.
The ritual's weight must be proportional to the drift. This skill earns its place on re-entry after absence; it must never become a gate the user waits behind every session. When little or nothing changed since the last visit, the whole entry is one line ("nothing drifted since yesterday — what are we on?") and work starts immediately. The full briefing below is for real absence.
Personal state (zero-trace contract)
All state lives OUTSIDE the target project, in a directory the user owns. Never write any of it — or any reference to this skill pack — into the target project's files, commits, PRs, or issues.
- Root:
${XDG_DATA_HOME:-$HOME/.local/share}/identity16-skills/projects/<repo-id>/ repo-id: the normalizedoriginremote URL as a slug — strip protocol, credentials, and.git; replace/and:with__(e.g.github.com__rust-lang__rust). If the repo has no remote, slug the absolute repo path the same way.- Files (create on first use):
state.json—{ "last_visit": { "commit": "<sha>", "date": "<ISO date>", "branch": "<name>" } }dossier.md— the user's mental model of this project: architecture notes, load-bearing invariants, gotchas, the project's tool stack (where discussion happens, where work is tracked, how things ship), and pointers to where context lives in the repo. Holds only what has no home in the repo itself — it is a fallback, never a mirror of the repo's own docs.journal.md— append-only session log: date, what was learned, open questions, WIP state.