v6.2.0

[REPOZY]

Cross-session memory overhaul: the full memory stack is now injected automatically at session start, stop-reminders actually writes to session-log.md, and agents can no longer waste tokens as content relays.

New Features

Full memory stack injected at session start — session-log.md (last 2 [saved] decisions), state.md (active task snapshot), known-issues.md (error map), and context-snapshot.json (changed files + recent commits) are now all injected into session context by the session-start hook — unconditionally, without requiring the AI to remember to read them. Previously only project-map.md was injected; the rest depended entirely on AI compliance with the entry sequence.

Decision-log reminder in stop-reminders — When the session modified SKILL.md files, hooks, or plugin config, the Stop hook now surfaces an explicit prompt to invoke context-management before ending the session. These are the sessions where the "why" matters most and is most likely to be lost.

Changes

Agent & External Content Rules added to token-efficiency — Five new rules cover the behavioral characteristics of the Agent tool and WebFetch that the AI previously had to discover by failure: agent results are always compressed on return (never use agents as content relays), WebFetch returns AI summaries not raw text (use curl -sf for verbatim URL content), and local files should always be Read directly. These rules are always-on from session start.

"When the User Names a Specific Skill" section added to using-superpowers — Clarifies that phrases like "use brainstorming" or "use context management" are Skill tool invocations, not conceptual goals to achieve ad-hoc. This was the root cause of entry sequence bypass in analyzed session transcripts: the AI improvised with agents instead of calling the Skill tool.

Mandatory first actions surfaced at injection point — The session-start hook now prepends three concrete steps before the full using-superpowers body: activate token-efficiency, classify complexity, and invoke named skills via the Skill tool. Previously these were buried in the skill text where they competed with everything else for attention.

Content-relay anti-pattern added to dispatching-parallel-agents — "The task is content relay" is now an explicit entry in the "Do not use when" list, with a one-line explanation: agent results are compressed, raw content will be lost.

using-superpowers step 4 extended — Now requires a [saved] entry at the end of any session where significant decisions were made, not just sessions with ongoing incomplete work.

known-issues.md added to auto-gitignore list — track-edits.js now includes known-issues.md in the AI_ARTIFACTS list so it is automatically added to .gitignore on first write.

Fixes

stop-reminders.js never wrote to session-log.md — The hook was documented as "auto-writes session-log.md [auto] entry" but only wrote to a private temp file at ~/.claude/hooks-logs/edit-log.txt. The [auto] entries visible in prior session logs were written manually by the AI. Fixed: the hook now writes a proper [auto] entry to session-log.md in the project root on session stop, gated by the existing 2-minute guard to prevent duplicates.

MANDATORY FIRST ACTIONS had invalid JSON — The preamble added in the previous session contained literal unescaped double-quotes ("use brainstorming") inside the bash string that produced the hook's JSON output. This caused JSON.parse failures on every session start for any platform that validated the JSON. Fixed by removing the quotes from the example text.

---

This discussion was created from the release v6.2.0.