session recap · 2026-05-29

sonnet-4-6

Wired up layered search exclusions for docs/plans/archive/ at three levels, generated a multi-platform diff card, and merged PR #182 — all in a single 60-minute Claude Code session.

Added docs/plans/archive/ exclusion to project CLAUDE.md and user-level ~/.claude/CLAUDE.md
Enforced Read(*/plans/archive/*) via settings.json permissions.deny at the tool layer
Generated LinkedIn, Twitter/X, and Bluesky diff cards for the config change
Resolved merge conflict with main and merged PR #182

65,689 tokens 60 min 95.9% cache hit 19 files 3 commits

Quick session: wired up layered search exclusions for an archive directory in Claude Code, shipped a social card for the change, and merged PR #182 — ~60 minutes start to finish.

The setup uses two layers that reinforce each other:
1. CLAUDE.md instruction (`*/plans/archive`) — tells the model not to look there
2. `settings.json` `permissions.deny` (`Read(*/plans/archive/*)`) — blocks the Read tool if it tries anyway

Instructions can drift or be ignored by subagents; permission denies can't. Pairing both means the exclusion holds across all contexts.

Generated a multi-platform diff card for the change, then resolved a merge conflict with main before landing the PR.

3 commits · 19 files · ~66k tokens · 95.9% cache hit rate

More Claude Code configuration patterns coming — follow to catch them.

#ClaudeCode #AIEngineering #DeveloperTools #LLMOps

Twitter/X

Two-layer search exclusions in Claude Code: CLAUDE.md instruction + `permissions.deny` to block the Read tool if it tries anyway. Instructions can drift; deny rules can't. 3 commits, ~66k tokens, 95.9% cache.

Bluesky

"Is there a setting for this?" — yes, `permissions.deny` in settings.json. Pair it with a CLAUDE.md rule and the exclusion holds even when a subagent doesn't inherit session context. Useful pattern for any "don't touch" directory.