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

Change Summary

Field Value

Field	Value
Change ID	CR-2026-03-25-claudemd-001
Requested By	Self
Target Date	Next session
Systems Affected	`~/.claude/CLAUDE.md`
Risk Level	Low
Rollback Time	< 1 minute (restore from backup)
Category	Normal

Change ID

CR-2026-03-25-claudemd-001

Requested By

Self

Target Date

Next session

Systems Affected

~/.claude/CLAUDE.md

Risk Level

Low

Rollback Time

< 1 minute (restore from backup)

Problem Statement

The global CLAUDE.md (772 lines) contains outdated content and missing references to modern Claude Code features implemented in this session.

Outdated Sections

Section	Location	Issue
"2-Week Journey"	Lines 90-94	Written when user was 2 weeks into Linux - skill level has advanced significantly
"Documentation Strategy"	Lines 362-373	Mentions Principia → domus-* migration as ongoing - likely complete
"Common Attributes table"	Lines 480-506	Hardcoded IP/MAC values embedded in CLAUDE.md - should reference antora.yml as source of truth

Section

Location

Issue

"2-Week Journey"

Lines 90-94

Written when user was 2 weeks into Linux - skill level has advanced significantly

"Documentation Strategy"

Lines 362-373

Mentions Principia → domus-* migration as ongoing - likely complete

"Common Attributes table"

Lines 480-506

Hardcoded IP/MAC values embedded in CLAUDE.md - should reference antora.yml as source of truth

Missing Modern Features

The following Claude Code features are implemented but NOT documented in CLAUDE.md:

Feature Location Implemented

Feature	Location	Implemented
Custom Skills	`~/.claude/skills/`	`/deploy`, `/worklog`
Custom Agents	`~/.claude/agents/`	`doc-auditor.md`
Path-Specific Rules	`~/.claude/rules/`	`asciidoc.md`, `lua-nvim.md`
Hooks Architecture	`~/.claude/hooks.json`	4 active hooks (backup, shellcheck, asciidoc-attrs, session-start)
Keybindings	`~/.claude/keybindings.json`	Custom shortcuts
Settings Deny Rules	`~/.claude/settings.json`	Secrets protection (redundant with FORBIDDEN section)

Custom Skills

~/.claude/skills/

/deploy, /worklog

Custom Agents

~/.claude/agents/

doc-auditor.md

Path-Specific Rules

~/.claude/rules/

asciidoc.md, lua-nvim.md

Hooks Architecture

~/.claude/hooks.json

4 active hooks (backup, shellcheck, asciidoc-attrs, session-start)

Keybindings

~/.claude/keybindings.json

Custom shortcuts

Settings Deny Rules

~/.claude/settings.json

Secrets protection (redundant with FORBIDDEN section)

Current State (Audit)

~/.claude/ Contents

~/.claude/
├── CLAUDE.md              # 772 lines - needs modernization
├── settings.json          # 85 lines - consolidated, clean
├── hooks.json             # 65 lines - 4 active hooks
├── keybindings.json       # 21 lines - custom shortcuts
├── skills/                # 2 skills implemented
│   ├── deploy/SKILL.md
│   └── worklog/SKILL.md
├── agents/                # 1 agent implemented
│   └── doc-auditor.md
├── rules/                 # 2 rules implemented
│   ├── asciidoc.md
│   └── lua-nvim.md
└── hooks/                 # Hook scripts
    └── validate-asciidoc-attrs.sh  # 173 lines