rocksdb/build_tools
Xingbo Wang 92378eb3b8 Add CLAUDE.md and optimize tooling for claude code (#14293)
Summary:
* Add CLAUDE.md This CLAUDE.md is generated through the analysis of 9,012 commits from the RocksDB repository since 2016. It aggregate the commits into 8 major components based on the component it is changing. It selected top 100 most complex PR based on line of changes to collect the code review feedbacks. For each PR, we collected:

  • PR title and description to understand the change context
  • Files changed to identify affected components and measure complexity
  • Inline code review comments from reviewers
  • General review summaries and approval/change request feedback

The feedback was then categorized by RocksDB component and analyzed for recurring themes, patterns, and best practices.

This CLAUDE.md file could be used for guiding code generation and code review.

* Optimize tooling for claude code Add make check-progress and format-auto targets for automation

Add machine-parseable progress reporting for `make check` to support automated monitoring tools like Claude Code:

- Add `build_tools/check_progress.sh` script that outputs JSON progress
- Add `make check-progress` target to poll build/test progress
- Detects phases: compiling -> linking -> generating -> testing
- Reports failed tests with exit codes, signals, and log output
- Limits to 10 failures with last 50 lines of output each

Also add non-interactive formatting support:

- Add `-y` flag to format-diff.sh for auto-apply without prompts
- Add `make format-auto` target for CI/automation use

Pull Request resolved: https://github.com/facebook/rocksdb/pull/14293

Test Plan: Local build

Reviewed By: pdillinger

Differential Revision: D92085763

Pulled By: xingbowang

fbshipit-source-id: ba122a4ff51087aec5c06bab804edfee34e13880
2026-02-03 05:53:50 -08:00
..
ubuntu20_image Add OpenSSL to docker image (#10741) 2022-09-26 17:36:57 -07:00
ubuntu22_image Use C++20 in public API, fix CI (#13915) 2025-09-08 13:11:28 -07:00
ubuntu24_image Use C++20 in public API, fix CI (#13915) 2025-09-08 13:11:28 -07:00
amalgamate.py internal_repo_rocksdb 2024-10-14 03:01:20 -07:00
benchmark_log_tool.py internal_repo_rocksdb 2024-10-14 03:01:20 -07:00
build_detect_platform Remove remaining pieces of Lua integration (#14200) 2025-12-23 09:10:12 -08:00
check-public-header.sh Remove remaining pieces of Lua integration (#14200) 2025-12-23 09:10:12 -08:00
check-sources.sh Fix bad include (#10213) 2022-06-20 17:42:01 -07:00
check_progress.sh Add CLAUDE.md and optimize tooling for claude code (#14293) 2026-02-03 05:53:50 -08:00
dependencies_platform010.sh Remove remaining pieces of Lua integration (#14200) 2025-12-23 09:10:12 -08:00
dockerbuild.sh Add copyright headers per FB open-source checkup tool. (#5199) 2019-04-18 10:55:01 -07:00
error_filter.py internal_repo_rocksdb 2024-10-14 03:01:20 -07:00
fb_compile_mongo.sh Add copyright headers per FB open-source checkup tool. (#5199) 2019-04-18 10:55:01 -07:00
fbcode_config.sh Remove remaining pieces of Lua integration (#14200) 2025-12-23 09:10:12 -08:00
fbcode_config_platform010.sh Remove remaining pieces of Lua integration (#14200) 2025-12-23 09:10:12 -08:00
format-diff.sh Add CLAUDE.md and optimize tooling for claude code (#14293) 2026-02-03 05:53:50 -08:00
getdeps_fallback_mirror.py Fix autoconf download failure in folly build (#14226) 2026-01-09 10:43:54 -08:00
gnu_parallel Initial CircleCI -> GitHub Actions migration (#12163) 2023-12-21 15:40:21 -08:00
make_package.sh Use standard variables for installing/uninstalling with make (#7187) 2020-08-28 14:47:31 -07:00
ps_with_stack Print stack traces on frozen tests in CI (#10828) 2022-10-18 00:35:35 -07:00
regression_build_test.sh Backport an internal change to regression_build_test.sh (#11319) 2023-03-22 13:33:50 -07:00
run_ci_db_test.ps1 Fix remaining uses of "backupable" (#9792) 2022-04-05 09:52:33 -07:00
setup_centos7.sh Adding new build script for CentOS 7 (#6617) 2020-04-06 16:20:27 -07:00
update_dependencies.sh Remove remaining pieces of Lua integration (#14200) 2025-12-23 09:10:12 -08:00
version.sh Add copyright headers per FB open-source checkup tool. (#5199) 2019-04-18 10:55:01 -07:00