Level 1 (CLAUDE.md) - Loaded in every conversation
├── Information Recording Principles ← Self-constraints to prevent future bloat
├── Reference Index (beginning)     ← Entry 1: Check here when encountering issues
├── Core Command List
├── Non-Negotiable Rules/Prohibitions (with code examples)
├── Common Error Diagnosis (Symptom → Cause → Fix)
├── Code Patterns (directly copyable)
├── Directory Mapping (Function → File)
├── Must-Read Before Modifying Code ← Entry 2: Check here before modifying code
└── Reference Trigger Index (end) ← Entry 3: Retrieval after long conversations

cp CLAUDE.md CLAUDE.md.bak.$(date +%Y%m%d_%H%M%S)

# Check if referenced files exist
grep -oh '`[^`]*\.md`' CLAUDE.md | sed 's/`//g' | while read f; do
  test -f "$f" && echo "✓ $f" || echo "✗ MISSING: $f"
done

**📖 When to read `docs/references/xxx-sop.md`**:
- [Specific error message, e.g., `ERR_DLOPEN_FAILED`]
- [Specific scenario, e.g., "when adding new native modules"]

> Includes: [Keyword 1], [Keyword 2], [Code Template].

## Reference Index (Check Here First When Encountering Problems)

| Trigger Scenario | Document | Core Content |
|----------|------|---------|
| `ERR_DLOPEN_FAILED` | `native-modules-sop.md` | ABI mechanism, lazy loading |
| `Cannot find module` after packaging | `vite-sop.md` | MODULES_TO_COPY |

## Must-Read Before Modifying Code

| What You Want to Modify | Read This First | Key Pitfalls |
|-----------|---------|---------|
| Native module related | `native-modules-sop.md` | Must use lazy loading; electron-rebuild fails silently |
| Packaging configuration | `packaging-sop.md` | DMG contents must use function form |

Complete process see `database-sop.md` (FTS5 escaping, health checks).

## Information Recording Principles (Mandatory for Claude)

This document uses a **progressive disclosure** architecture to optimize LLM working efficiency.

### Level 1 (This File) Only Records

| Type | Example |
|------|------|
| Core Command List | `pnpm run restart` |
| Non-Negotiable Rules/Prohibitions | Must lazy load native modules |
| Common Error Diagnosis | Complete Symptom → Cause → Fix workflow |
| Code Patterns | Directly copyable code blocks |
| Directory Navigation | Function → File mapping |
| Trigger Index Table | Entries pointing to Level 2 |

### Level 2 (docs/references/) Records

| Type | Example |
|------|------|
| Detailed SOP Processes | Complete 20-step operation guides |
| Edge Case Handling | Diagnosis of rare errors |
| Full Configuration Examples | Explanations of all parameters |
| Historical Decision Records | Why this design was chosen |

### When Users Request to Record Information

1. **Judge if it's frequently used**:
   - Yes → Write to CLAUDE.md (Level 1)
   - No → Write to the corresponding reference file (Level 2)

2. **References from Level 1 to Level 2 must include**:
   - Trigger conditions (when to read)
   - Content summary (what you'll gain from reading)

3. **Prohibited**:
   - Placing low-frequency detailed processes in Level 1
   - Referencing Level 2 without writing trigger conditions

<!-- CLAUDE.md Beginning (After Project Overview) -->
## Reference Index

| Trigger Scenario | Document | Core Content |
|---------|------|---------|
| ABI errors | `native-modules-sop.md` | Lazy loading mode |
| Missing packaged modules | `vite-sop.md` | MODULES_TO_COPY |

... (Main Content) ...

<!-- CLAUDE.md End (Place Another Copy) -->
## Reference Trigger Index

| Trigger Scenario | Document | Core Content |
|---------|------|---------|
| ABI errors | `native-modules-sop.md` | Lazy loading mode |
| Missing packaged modules | `vite-sop.md` | MODULES_TO_COPY |

**📖 When to read `native-modules-sop.md`**:
- Encountering `ERR_DLOPEN_FAILED` errors
- Needing to add new native modules

> Includes: ABI mechanism, lazy loading mode, manual repair commands

// ✅ Correct: Lazy loading, load only when needed
let _Database = null;
function getDatabase() {
  if (!_Database) {
    _Database = require("better-sqlite3");
  }
  return _Database;
}