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-resume

Start a task from what earlier sessions, models and tools already learned instead of re-exploring: read ai-docs/INDEX.md and its private index, open only the matching solutions, decisions and plans (or search them), check a stale fix before acting on it, continue or resume work from HANDOFF.md, read the user tier on a new machine or environment, run maintain on stale docs. Use whenever a non-trivial task starts in a repo with ai-docs/ or a vault registration, above all before fixing an error the user says is back after an earlier fix, and on 'pick up where we left off', 'what do we already know about X', 'did we try this before', 'search the notes first', 'what was decided about', 'is that fix still good', 'we fixed this before, it fails again', 'same problem as last time', 'what do you know about me / this machine', 'prune / consolidate the docs'. Also for 'refresh everlast-resume' and 'is everlast-resume stale'. Writing entries is everlast-capture; setup is everlast-setup; the vault is everlast-vault.

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.