Bug Hunt Method Kit

Public-safe method kit and AI-OS for responsible bug hunting, evidence review, redaction, and report preparation.

View the Project on GitHub PrzemyslaV88/bug-hunt-method-kit

Getting Started

This guide is the shortest safe path through Bug Hunt Method Kit.

Who This Guide Is For

Use this if you are learning bug bounty workflow, organizing authorized security notes, reviewing a possible finding, or teaching safe evidence habits with fake examples.

Before You Test Anything

This repo does not give permission to test any real system. Scope means the exact places you are allowed to test. If scope is unclear, stop.

Do not use random guessing, brute force, OTP probing, credential attacks, payment manipulation, or repeated notification sends. If unexpected third-party data appears, stop and follow the program’s disclosure rules.

The Safe Workflow

The basic loop is:

permission -> boundary -> one hypothesis -> controlled test -> minimal evidence -> review -> decision

Step 1: Confirm Permission

Write down where permission comes from, what assets are in scope, what actions are allowed, and what actions are forbidden. Start with Session Brief.

Step 2: Define the Boundary

A boundary is the rule that separates what one user, account, role, tenant, or object is allowed to do from what it is not allowed to do.

Toy example:

USER_A owns OBJECT_1.
USER_B owns OBJECT_2.
USER_B should not read OBJECT_1.

Step 3: Write One Hypothesis

A hypothesis is one testable idea, not a pile of guesses.

Good:

USER_B may be able to read OBJECT_1 when only the object reference changes.

Weak:

Maybe authorization is broken everywhere.

Step 4: Use Tester-Controlled Accounts and Objects

Use only accounts and objects you control and are allowed to test. Never guess random object IDs. Never touch third-party data.

Step 5: Collect Minimal Evidence

Evidence means facts that prove what happened, not private data dumps. Record marker booleans, status, response length, cache headers when useful, and redacted summaries. Keep private evidence outside this public repo.

Step 6: Challenge the Finding Before Reporting

Ask:

Use Pre-Submission Red Team Review.

Step 7: Decide What to Do Next

Impact means what unauthorized access, action, exposure, or privilege was actually proven.

Choose one:

Common Beginner Mistakes