CR-2026-03-25: CLAUDE.md Modernization — Implementation

Implementation Plan

Phase 1: Remove Outdated Content

Action	Current	New
"2-Week Journey" section	"User has been in Linux for 2 weeks…"	Remove timeline, keep CLI mastery methodology
Principia migration mention	"From: Principia/02_Assets…"	"All documentation in domus-* ecosystem"
Common Attributes table	Hardcoded values in CLAUDE.md	Reference: "See component antora.yml for current values"

Action

Current

New

"2-Week Journey" section

"User has been in Linux for 2 weeks…"

Remove timeline, keep CLI mastery methodology

Principia migration mention

"From: Principia/02_Assets…"

"All documentation in domus-* ecosystem"

Common Attributes table

Hardcoded values in CLAUDE.md

Reference: "See component antora.yml for current values"

Phase 2: Add Modern Features Section

Add new section: ## Claude Code Configuration Architecture

## Claude Code Configuration Architecture

The full configuration is documented in domus-captures:
- **Reference:** xref:projects/personal/claude-code-features/index.adoc[]

### Quick Reference

| Component | Purpose | Location |
|-----------|---------|----------|
| **Skills** | On-demand workflows | `~/.claude/skills/*/SKILL.md` |
| **Agents** | Specialized subagents | `~/.claude/agents/*.md` |
| **Rules** | Path-specific instructions | `~/.claude/rules/*.md` |
| **Hooks** | Lifecycle automation | `~/.claude/hooks.json` |
| **Settings** | Permissions, sandbox | `~/.claude/settings.json` |

### Active Skills

- `/deploy` - Push spoke repo + trigger domus-docs rebuild
- `/worklog` - Create WRKLOG with 8 partials

### Active Hooks

- **PreToolUse**: Auto-backup before Edit/Write
- **PostToolUse**: ShellCheck + AsciiDoc attribute validation
- **SessionStart**: Professional environment confirmation

Phase 3: Consolidate Secrets Protection

The FORBIDDEN section and settings.json deny rules are redundant. Keep FORBIDDEN section (guidance) and note that settings.json enforces it:

## FORBIDDEN: Secrets Access

**NEVER access user secrets directly.**

This is enforced by `settings.json` deny rules:
- `Read(./.env)`, `Read(~/.secrets/*)`
- `Bash(age -d:*)`, `Bash(gopass show:*)`

Phase 4: Update Skill Level

Change from:

User has been in Linux for 2 weeks, typing commands daily...

To:

User is building Linux proficiency through deliberate practice.
Focus: awk, sed, grep, find, xargs mastery.