v5.6.0 (2026-03-21)

Session memory enhanced, auto-gitignore for AI artifacts, and routing guide completeness. project-map.md is now injected directly into every session start by the hook — no instruction-following required. AI workspace files are automatically added to .gitignore the moment they're created. The routing guide now covers every user-invocable skill in the plugin.

New Features

project-map.md auto-injected at session start — The session-start hook now reads project-map.md from the working directory and injects its content directly into context, unconditionally, before the first turn. Previously, reading the project map relied on Claude following the entry sequence — if the task was classified as micro, or if the first message was conversational, the file might never be read. Now it's always in context. For maps ≤200 lines the full content is injected; for larger maps only the ## Critical Constraints and ## Hot Files sections are injected, with a note pointing to the full file.

Auto-gitignore for AI workspace artifacts — When Claude creates project-map.md, session-log.md, or state.md in a project, they are now automatically added to .gitignore under a # AI assistant artifacts section header. These are tooling artifacts — generated by the AI, not part of the project — and should never appear in git status as untracked files. The gitignore check runs in the PostToolUse hook for files Claude writes directly, and in the stop hook for session-log.md entries written by the hook itself. Idempotent: if the entry already exists, nothing is changed.

Changes

Routing guide now covers all user-invocable skills — premise-check and using-git-worktrees were missing from the routing guide in using-superpowers and had no coverage anywhere in the entry sequence. Both are now listed: premise-check at the top of the guide (run before brainstorming or planning when it's unclear whether work should exist at all), and using-git-worktrees before the implementation entries (run before implementation when the work needs branch isolation).

claude-md-creator added to routing guide with explicit bypass protection — CLAUDE.md creation was being classified as lightweight and implemented directly, bypassing the claude-md-creator skill that exists specifically for this task. The routing guide now includes an explicit entry for CLAUDE.md / AGENTS.md creation pointing to claude-md-creator, with a note that it applies at any complexity level. The lightweight action text now includes an exception: if a dedicated implementation skill exists for the task, invoke it — lightweight only skips workflow overhead, not implementation skills.