Persistent state tracking across sessions — records decisions with rationale, progress, risks, ADRs to .rune/ files. Called by surgeon, deploy, rescue for cross-session continuity.
How to install journal?
rune-kit/rune/journal
$curl -o .claude/agents/journal.md https://raw.githubusercontent.com/rune-kit/rune/HEAD/agents/journal.mdInstalls into the current project.
›Prefer a prompt? Paste this to your agent
Install journal by running `curl -o .claude/agents/journal.md https://raw.githubusercontent.com/rune-kit/rune/HEAD/agents/journal.md`, then use it for the current task and follow its documentation at https://github.com/rune-kit/rune.
agents/journal.md
| 1 | You are the **journal** skill — Rune's cross-session state recorder. |
| 2 | |
| 3 | ## Quick Reference |
| 4 | |
| 5 | **Workflow:** |
| 6 | 1. Load current `.rune/RESCUE-STATE.md` and `module-status.json` |
| 7 | 2. Update progress for completed modules |
| 8 | 3. Record decisions with rationale as ADR entries (not just "decided X") |
| 9 | 4. Record risks with severity, mitigation, trigger conditions |
| 10 | 5. Update dependency graph if module relationships changed |
| 11 | 6. Save all files; verify consistency |
| 12 | |
| 13 | **Critical Rules:** |
| 14 | - MUST record decisions with rationale (why, not just what) |
| 15 | - MUST timestamp all entries |
| 16 | - MUST NOT log sensitive data (secrets, tokens, credentials) |
| 17 | - MUST check if ADR file exists before writing (never overwrite) |
| 18 | |
| 19 | Read `skills/journal/SKILL.md` for the full specification. |
Related
6 picksType
- cavecrew-builderSurgical 1-2 file edit. Typo fixes, single-function rewrites, mechanical renames, comment removal, format-preserving tweaks. Hard refuses 3+ file scope. Returns caveman diff receipt. Use when scope…Jul 2026
- cavecrew-investigatorRead-only code locator. Returns file:line table for "where is X defined", "what calls Y", "list all uses of Z", "map this directory". Output is caveman-compressed so the main thread eats ~60% fewer…Jul 2026
- cavecrew-reviewerDiff/branch/file reviewer. One line per finding, severity-tagged, no praise, no scope creep. Output format `path:line: <emoji> <severity>: <problem>. <fix>.` Use for "review this PR", "review my…Jul 2026
- executorFocused task executor for implementation work (Sonnet)Jul 2026
- brag-spotterProactively scans for achievements and wins that aren't in the brag doc yet. Checks recent work notes, incident resolutions, git history, and 1:1 feedback for brag-worthy items.Jul 2026
- review-prepAggregate performance review material from the vault for a given period. Scans brag doc, decisions led, incidents handled, competency evidence, 1-on-1 feedback, and PR deep scans. Invoke via…Jul 2026
