docs: lean CLAUDE.md (claude-md-lint)#26
Conversation
![chatgpt-codex-connector[bot]](https://avatars.githubusercontent.com/in/1144995?s=60&v=4){kind=small}
There was a problem hiding this comment.
💡 Codex Review
Here are some automated review suggestions for this pull request.
Reviewed commit: 7508c8b4e8
ℹ️ About Codex in GitHub
Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you
- Open a pull request for review
- Mark a draft as ready
- Comment "@codex review".
If Codex has suggestions, it will comment; otherwise it will react with 👍.
Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".
| ## Gotchas | ||
|
|
||
| ## Development Conventions | ||
| - **Package manager is pnpm, not npm.** `pnpm-lock.yaml` is authoritative and CI runs `pnpm install --frozen-lockfile`; `package-lock.json` is an orphan from the template. The auto-generated portfolio-context block below still claims "npm only" — that claim is wrong; trust this section. (The block regenerates from memory each auditor run, so the contradiction may reappear until the generator reads CI as ground truth.) |
There was a problem hiding this comment.
In contexts where a dependency changes, this new guidance tells agents to trust pnpm-lock.yaml and treat package-lock.json as an orphan, but the checked release workflow (.github/workflows/release.yml) still runs npm ci, which is a clean install driven by npm's lockfile. Following this instruction would let future changes update only the pnpm lock, leaving release builds to fail or ship a different dependency graph; it also conflicts with the repo-root AGENTS.md npm-only rule.
Useful? React with 👍 / 👎.
1 participant
Leaned the project CLAUDE.md via claude-md-lint, rebuilt against current main (298→95 lines). Whole-file no-loss gate: all 10 protected tokens preserved (commands, port 9876, ~/job-search-2026/). Corrected the auto-block's wrong 'npm only' claim — repo uses pnpm (pnpm-lock.yaml + CI). Auto-generated portfolio-context block left intact. Hand-leaned because its auto-block is mid-file (sandwiched), a case the batch tool doesn't handle.