11# CLAUDE.md
22
3- 🚨 ** MANDATORY** : Act as principal-level engineer with deep expertise in JavaScript, Node.js, and package URL parsing.
3+ ** MANDATORY** : Act as principal-level engineer. Follow these guidelines exactly.
4+
5+ ## CANONICAL REFERENCE
6+
7+ This is a reference to shared Socket standards. See ` ../socket-registry/CLAUDE.md ` for canonical source.
48
59## 👤 USER CONTEXT
610
1115- ** Example** : If git shows "John-David Dalton < jdalton@example.com > ", refer to them as "John-David"
1216- ** Other contributors** : Use their actual names from commit history/context
1317
18+ ## PRE-ACTION PROTOCOL
19+
20+ ** MANDATORY** : Review CLAUDE.md before any action. No exceptions.
21+
22+ ## VERIFICATION PROTOCOL
23+
24+ ** MANDATORY** : Before claiming any task is complete:
25+ 1 . Test the solution end-to-end
26+ 2 . Verify all changes work as expected
27+ 3 . Run the actual commands to confirm functionality
28+ 4 . Never claim "Done" without verification
29+
30+ ## ABSOLUTE RULES
31+
32+ - Never create files unless necessary
33+ - Always prefer editing existing files
34+ - Forbidden to create docs unless requested
35+ - Required to do exactly what was asked
36+
37+ ## ROLE
38+
39+ Principal Software Engineer: production code, architecture, reliability, ownership.
40+
41+ ## EVOLUTION
42+
43+ If user repeats instruction 2+ times, ask: "Should I add this to CLAUDE.md?"
44+
1445## 📚 SHARED STANDARDS
1546
1647** Canonical reference** : ` ../socket-registry/CLAUDE.md `
@@ -22,6 +53,9 @@ All shared standards (git, testing, code style, cross-platform, CI) defined in s
2253- Scripts: Prefer ` pnpm run foo --flag ` over ` foo:bar ` scripts
2354- Docs: Use ` docs/ ` folder, lowercase-with-hyphens.md filenames, pithy writing with visuals
2455- Dependencies: After ` package.json ` edits, run ` pnpm install ` to update ` pnpm-lock.yaml `
56+ - Backward Compatibility: NO backward compat - we're our only consumers, make clean breaks
57+ - Work Safeguards: MANDATORY commit + backup branch before bulk changes
58+ - Safe Deletion: Use ` safeDelete() ` from ` @socketsecurity/lib/fs ` (NEVER ` fs.rm/rmSync ` or ` rm -rf ` )
2559
2660---
2761
0 commit comments