Skip to content

docs: Add comprehensive CLAUDE.md for AI-assisted development#2889

Merged
dguido merged 3 commits intomasterfrom
docs/claude-md-improvements
Jan 16, 2026
Merged

docs: Add comprehensive CLAUDE.md for AI-assisted development#2889
dguido merged 3 commits intomasterfrom
docs/claude-md-improvements

Conversation

@dguido
Copy link
Member

@dguido dguido commented Jan 16, 2026

Summary

Adds project-specific coding standards and Slither internals documentation to help developers using Claude Code (or similar AI tools) work effectively on the codebase.

CLAUDE.md includes:

  • Architecture overview and development setup
  • Code standards (philosophy, quality, hard limits)
  • Working on code (incremental improvement, git conventions)
  • Testing guidelines
  • Slither internals (APIs, traversal patterns, SlithIR/SSA, detector quality)

CONTRIBUTING.md additions:

  • PR description guidelines
  • Commit message conventions
  • Markdown documentation standards

Test plan

  • Verify CLAUDE.md follows its own formatting standards
  • Verify make lint passes

🤖 Generated with Claude Code

dguido and others added 2 commits January 15, 2026 21:20
Prevent git worktree directories from being tracked.

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
Add project-specific coding standards and Slither internals documentation
to help developers using Claude Code (or similar AI tools) work effectively
on the codebase.

CLAUDE.md includes:
- Architecture overview and development setup
- Code standards (philosophy, quality, hard limits)
- Working on code (incremental improvement, git conventions)
- Testing guidelines
- Slither internals (APIs, traversal patterns, SlithIR/SSA, detector quality)

CONTRIBUTING.md additions:
- PR description guidelines
- Commit message conventions
- Markdown documentation standards

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
@dguido dguido requested a review from smonicas as a code owner January 16, 2026 03:45
- Code section: Remove verbose PR model explanation, fork link, "work from master"
- Testing section: Tighten test categories to scannable list
- Tips: Condense while adding coverage commands
- crytic-compile section: Rename and simplify to numbered steps with example
- CLAUDE.md: Add analyses/ to architecture, alphabetize directories

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
@dguido dguido merged commit 9277def into master Jan 16, 2026
35 checks passed
@dguido dguido deleted the docs/claude-md-improvements branch January 16, 2026 04:11
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant

Comments