AI Briefing
KO

Yaw Mode for Claude Code

·2026.04.25 00:29

Key point

Yaw Mode adds session-level overlay configuration to Claude Code.

Details

Yaw Mode extends Claude Code's ~/.claude/ as a session-level overlay without overwriting it.

  • It layers CLAUDE.md, skills, permissions, OAuth credentials, and session history onto a separate temporary overlay, then removes it on exit.
  • In Augment mode, it keeps the user's existing ~/.claude/ intact while adding Yaw's rules and skills.
  • In Fresh mode, it excludes user settings and applies only the Yaw bundle to create a reproducible base environment.
  • CLAUDE.md merges in rule files such as agent-setup, code-quality, deploy, git, npm, and testing.
  • It provides curated skills such as implement, review, ship-ready, coverage, full-pass, and simplify.
  • Each session points CLAUDE_CONFIG_DIR to the overlay, while conversation history is written directly to the actual home directory to preserve --resume behavior.
  • On teardown, junctions/symlinks are unlinked first to prevent history corruption, and tests also cover .claude.json backup, concurrent-run merging, and ghost entry cleanup.

Augment/Fresh can be toggled on in the settings panel, applying from new sessions onward while existing sessions remain unaffected.

This summary was generated automatically by AI. Check the original for the author's claims and context. Copyright belongs to the original author.

Our guide explains how the AI works. Report summary errors, attribution issues, or removal requests via Contact.