Skip to content

docs: add AGENTS.md to help AI agents guide new users building a LibAFL fuzzer - #3907

Open
Aditya30ag wants to merge 1 commit into
AFLplusplus:mainfrom
Aditya30ag:docs/add-agents-md
Open

docs: add AGENTS.md to help AI agents guide new users building a LibAFL fuzzer#3907
Aditya30ag wants to merge 1 commit into
AFLplusplus:mainfrom
Aditya30ag:docs/add-agents-md

Conversation

@Aditya30ag

@Aditya30ag Aditya30ag commented Aug 29, 2026

Copy link
Copy Markdown
Contributor

Closes #3896

What

Adds AGENTS.md at the repo root a structured guide for AI coding agents (Claude Code, Cursor, Codex, etc.) to help new users build a LibAFL-based fuzzer without having to browse all 69 examples in fuzzers/ and guess which one fits their target.

Why

Following @domenukk suggestion in #3896 that a good AGENTS.md would be more practical than a dedicated scaffolding tool.

What's in it

  • Decision table mapping target type → correct fuzzers/ example to start from (source-available, binary-only, QEMU, Frida, full-system, grammar-based, etc.)
  • Concrete scaffolding steps (copy example → fix deps → swap harness → wire real coverage → verify it runs)
  • Relevant build/lint commands (just fmt, scripts/clippy.sh, scripts/precommit.sh, no_std check)
  • Explicit section deferring to CONTRIBUTING.md's AI-assistance policy — scoped to helping agents assist downstream users, not to inviting AI-assisted PRs against this repo

What it does NOT do

  • Does not touch CONTRIBUTING.md (zero diff, verified)
  • No new code, dependencies, or workspace members

Checklist

  • I have run ./scripts/precommit.sh and addressed all comments

Bumps [vergen-git2](https://github.com/rustyhorde/vergen) from 10.0.2 to 10.0.3.
- [Release notes](https://github.com/rustyhorde/vergen/releases)
- [Commits](https://github.com/rustyhorde/vergen/commits)

---
updated-dependencies:
- dependency-name: vergen-git2
  dependency-version: 10.0.3
  dependency-type: direct:production
  update-type: version-update:semver-patch
...

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
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.

docs: add AGENTS.md for AI agents to help someone build a new LibAFL-based fuzzer

1 participant