Skip to content

m4bwav/everlast-protocol

v0.6.3MIT

Nothing an AI session learned is lost when you change model, session, tool or vendor. Two tiers of plain-markdown knowledge: a per-project doc set (solutions with dead ends, decisions with reasons, plans, a 50-line HANDOFF, an index) committed with the repo or kept in an excluded folder when the repo cannot hold it, and a user tier in a private vault repository (profile, environments, cross-project lessons). A privacy split keeps people, politics and credentials out of any shared repo. Hooks orient each session, nudge capture once, and at session end sync the vault and push the project's docs (a pull request whenever the push is not certain). The vault asks once for a private remote or creates one. Every entry carries a recheck date: the index, the session-start line and a BM25 search over titles, aliases and bodies flag what is due, and recheck and verify check a stored fix against the current code before an agent acts on it. Typed links, a deterministic maintain command, and a reproducible benchmark. Installs in Claude Code, Cowork, Copilot and anything that reads Agent Skills. Follows the Evergreen Protocol in pointer mode.

everlast-capture

Write down what a work session learned so no later agent, model or tool relearns it: dead ends with the fix and its verified command, design decisions with reasons and rejected options, living plans, a short HANDOFF for the next session, and lessons about the user or their machines, routed to the project's doc set, its private sidecar (people, politics, credentials, internal names) or the vault's user tier. Use whenever the user says 'document what we learned', 'write that down', 'handoff', 'wrap up', 'before you finish', 'record this decision', 'note the dead end', 'update the plan', 'remember that for next time', or a hook line starting [everlast] appears; also unprompted at the end of a task that hit a dead end, verified a non-obvious command, made a design choice or taught you something about the user. Also for 'refresh everlast-capture' and 'is everlast-capture stale'. A full session wrap-up that also improves skills, scripts and other stores is evergreen-wrapup when the evergreen plugin is installed; it calls this skill for the project docs. Setup is everlast-setup; reading is everlast-resume; the vault is everlast-vault; skill lessons go to that skill's LEARNINGS.md.

Read SKILL.md at the source

Pinned to revision 5d084ae454cb, so it is the text this page describes rather than whatever the author pushed since.

Files

Every link opens the file at its source, pinned to the revision this page describes.