Persist completed plan (/plans)
When to run
- The user says
/plans, save the completed plan, archive the plan with results, or similar after plan execution. - All plan todos are done and the workspace should get a durable record under
.cursor/plans/(not only~/.cursor/plans/).
Before writing
- Read
.cursor/plans/README.mdfor naming, suggested sections, safety, and lifecycle. - Prefer the completion date (or authoritative session date) for
YYYY-MM-DDin the filename. - If the plan text lives outside the repo, read or reconstruct it, then write the in-repo copy here.
Filename
- Pattern:
YYYY-MM-DD-short-slug.md(ASCII, lowercase slug, hyphen-separated). - Optional: branch or PR id in the slug.
- On collision, use
-2or a more specific slug; do not overwrite unrelated plans.
Body template
Match the README’s suggested structure and add a Results block for what actually happened:
- Goal — One short paragraph: what success meant.
- In scope / out of scope — If the original plan had boundaries, preserve them (trim stale Cursor-only todo blocks).
- Primary files and canonical docs — Paths and doc links the next reader needs.
- Execution results — Concrete outcomes: what was run (high level), what succeeded or failed, important command/output snippets, fixes or workarounds (e.g. Docker network stale containers, CLI flag ordering), and swap_ids / tx hashes / addresses only if they are dev/local and non-secret; never paste private keys or credentialed URLs.
- Verification — Commands or checks that proved the work (pointer to Makefile / mln-qa skill where appropriate).
- Layer-boundary check (MLN) — One sentence: which of MWEB, LitVM, Nostr, Tor were touched and that boundaries were respected (see
AGENTS.md).
Optional short Follow-ups if something was explicitly deferred.
Safety
- No secrets: no private keys,
.envcontents, or RPC URLs with credentials. Reference.exampletemplates only (same as README).
Lifecycle
- If this plan record accompanies merged work, commit the new
.cursor/plans/*.mdwith that work per README lifecycle guidance. - Align with
.cursor/rules/mln-plan-persistence.mdc(in-repo path, naming, stripping redundant Cursor frontmatter).
Do not
- Edit unrelated existing plan files unless the user asked to supersede them (then a short Superseded by note at top is OK).
- Replace the README or the plan file the user said not to touch.
Source: IndigoNakamoto/mwixnet-litvm — distributed by TomeVault.