Skip to content

Commit 85a13d4

Browse files
committed
docs(claude): align CLAUDE.md with canonical standards
- Add canonical reference to socket-registry/CLAUDE.md - Add mandatory protocol sections (PRE-ACTION, VERIFICATION) - Add ABSOLUTE RULES, ROLE, and EVOLUTION sections - Enhance SHARED STANDARDS with backward compat, work safeguards, safe deletion - Standardize header formatting across Socket projects
1 parent d2c65d8 commit 85a13d4

File tree

1 file changed

+35
-1
lines changed

1 file changed

+35
-1
lines changed

CLAUDE.md

Lines changed: 35 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,10 @@
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

@@ -11,6 +15,33 @@
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

Comments
 (0)