Skip to content

docs: add CLAUDE.md with build, test, lint and format commands - #853

Closed
Brooooooklyn wants to merge 1 commit into
mainfrom
claude/improve-claude-md-2026-10-13
Closed

Brooooooklyn wants to merge 1 commit into
mainfrom
claude/improve-claude-md-2026-10-13

Conversation

@Brooooooklyn

Copy link
Copy Markdown
Member

Requested by Brooklyn · project thread

22 agent-authored PRs read · windows searched: 2026-10-04 to 2026-10-11, then 2026-09-13 to 2026-10-11; the PRs read span 2026-10-01 to 2026-10-10 (10 days) · 0 helpers started. The PRs are a sample: agent PRs found by claude/ head branch or the Claude Code footer in the body, then every review comment on each.

Before: this repository has no CLAUDE.md. Claude Code reads CLAUDE.md files, so an agent session here starts without the repository's build, test, lint and format commands.

After: a short root CLAUDE.md lists those commands. Every line names a command that the repository's own justfile, package.json or CI workflow defines.

No rule edits: none of the 22 PRs had a review comment, so no repeated mistake was found.

Checked in the repository, not tested

Line Proof on main
just check justfile lines 32-33
just test justfile lines 38-39
just lint justfile lines 41-42
just fmt justfile lines 26-30
just doc justfile lines 53-59
just ready justfile lines 14-21

Checks

  • Ran prettier --check CLAUDE.md (passes) and git diff --check (clean).
  • Could not run the repository's own formatter (pnpm exec vp fmt inside just fmt), or a spell checker: they are not installed in this environment, and installing dependencies was out of scope.
  • The added file is the whole diff: 10 added lines, 0 removed.

This test shows that an agent now catches the mistake when it re-reads its own diff. It does not show that the mistake will never be written. (No edit was tested in this run, so this applies to nothing here yet.)

🤖 Generated with Claude Code

https://claude.ai/code/session_01XqXJZrD5seBTKh2qyvNuk9

To revert, revert this PR's single commit, or delete CLAUDE.md.


Generated by Claude Code

Claude Code loads CLAUDE.md, not AGENTS.md, so agents in this
repository start without the commands they need to verify a change.
Each line names a command defined in the repository's own scripts.

Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01XqXJZrD5seBTKh2qyvNuk9
@github-actions

Copy link
Copy Markdown

fspy benchmark

linux

dynamic/launch             change  +0.33%  [ -2.49% ..  +3.24%]  overhead   +49.35%
dynamic/access             change  -0.46%  [ -1.86% ..  +0.96%]  overhead   +11.17%
dynamic/access-relative    change  -0.11%  [ -0.88% ..  +0.77%]  overhead   +58.79%
dynamic/access-contended   change  -0.12%  [ -2.43% ..  +3.32%]  overhead   +14.20%
static/launch              change  +0.77%  [ -3.05% ..  +5.25%]  overhead  +177.99%
static/access              change  +0.11%  [ -1.06% ..  +1.77%]  overhead  +807.54%
static/access-relative     change  -0.45%  [ -1.59% ..  +0.88%]  overhead +1363.67%
static/access-contended    change  +0.30%  [ -0.88% ..  +1.14%]  overhead +3232.13%

macos

dynamic/launch             change  +0.13%  [ -2.26% ..  +2.73%]  overhead  +225.24%
dynamic/access             change  +0.24%  [ -2.14% ..  +2.93%]  overhead    +2.66%
dynamic/access-relative    change  +0.32%  [ -3.95% ..  +3.99%]  overhead  +217.32%
dynamic/access-contended   change  -0.12%  [ -2.09% ..  +1.49%]  overhead    +0.25%

windows

dynamic/launch             change  -1.31%  [-14.45% .. +12.81%]  overhead   +24.11%
dynamic/access             change  +0.66%  [-19.61% .. +36.56%]  overhead    +0.50%
dynamic/access-relative    change  +0.38%  [-20.08% .. +29.80%]  overhead    +2.41%
dynamic/access-contended   change  +0.66%  [ -8.20% ..  +7.45%]  overhead    +3.10%

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants