docs: add CLAUDE.md for Claude Code guidance#338
Merged
Conversation
Add comprehensive documentation for future Claude Code instances working in this repository. Includes project overview, workspace structure, architecture patterns, and common commands for building, running, and testing. Emphasizes pytest integration tests in tests/ directory as the preferred testing approach for agents (no sudo required). Assisted-by: Claude Sonnet 4.5 <noreply@anthropic.com>
Use the attribution setting for commits to add the `Assisted-by` trailer when Claude creates a commit. Add .claude/*.local.* pattern to .gitignore to exclude Claude Code local configuration files from version control. Assisted-by: Claude Sonnet 4.5 <noreply@anthropic.com>
Molter73
force-pushed
the
mauro/claude-config
branch
from
bc4f3ea to
5fa5c16
Compare
Stringy
approved these changes
May 21, 2026
Contributor
Stringy
left a comment
Stringy
left a comment
There was a problem hiding this comment.
Couple of very minor points but otherwise LGTM.
| - **fact-api**: gRPC API definitions generated from protobuf files in `third_party/stackrox/proto` | ||
|
|
||
| - **fact-ebpf**: BPF program implementation | ||
| - `src/bpf/*.c`: C code for BPF programs that attach to LSM hooks |
Contributor
There was a problem hiding this comment.
might be worth including *.h here too - or simplify to src/bpf/*.{c,h}
| 1. Kernel LSM hooks trigger BPF programs (in `fact-ebpf/src/bpf/main.c`) | ||
| 2. BPF programs write events to ring buffer | ||
| 3. `Bpf` worker (in `fact/src/bpf/mod.rs`) reads from ring buffer, sends to channel | ||
| 4. `HostScanner` (in `fact/src/host_scanner.rs`) enriches events with process info |
Contributor
There was a problem hiding this comment.
this might need to be updated to include rate limiting
Collaborator
Author
Forgot auto-merge was on, I'll create a follow up PR with the comments. |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
2 participants
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Description
Add comprehensive documentation for future Claude Code instances working in this repository. Includes project overview, workspace structure, architecture patterns, and common commands for building, running, and testing. Emphasizes pytest integration tests in tests/ directory as the preferred testing approach for agents (no sudo required).
Assisted-by: Claude Sonnet 4.5 noreply@anthropic.com
Checklist
Automated testing
If any of these don't apply, please comment below.
Testing Performed
None. Will try out how claude behaves with this file in future PRs.