Record

Run this skill only after the user explicitly invokes $record. Activate a write-through continuity cache for the current conversation. Keep the latest truth, not a transcript.

Start Recording

1. Resolve one dedicated record file.

   • Honor a dedicated path named by the user. Otherwise prefer RECORD.md at the repository root, or the current working directory outside a repository.
   • Reuse an existing file only when it is clearly managed by $record. If the preferred path is tracked, occupied by unrelated content, or otherwise unsuitable, choose a dedicated untracked path such as .record/RECORD.md.
   • Keep the record separate from project documentation, plans, progress files, source files, and instruction files.
   • In a Git repository, keep the chosen path untracked and ignored. Add its repository-relative path to the local exclude file returned by git rev-parse --git-path info/exclude when needed, then confirm it is ignored with git check-ignore -q -- <record-path>. Use another path if git ls-files --error-unmatch -- <record-path> succeeds.

   This step is complete when the record has a dedicated path that cannot enter an ordinary commit.

2. Capture the conversation so far.

   • Read any existing managed record and all available conversation context.
   • Write a compact living record with this default shape, omitting empty sections: