flipper-ble-mcp: Instructions file for Claude Code

Flipper Zero KB — agent guide

This directory is a research knowledge base (~55 markdown docs, ~70k words) about the Flipper Zero — not a code project. There is nothing to build or test. Your job when working here is to read, navigate, answer from, and extend the KB.

Where to start

1. llms.txt — generated one-line map of every doc (token-lean). Read this first to locate things.
2. README.md — the human index (richer tables, conventions, device context).
3. Grep the frontmatter (see schema below) for structured lookups — far cheaper than reading bodies.
4. use-cases.json + uc-index.json — the 64-use-case dataset and the UC-ID → docs resolver.

How to navigate efficiently

• By topic: grep -rl "^domain: wifi" . or grep -rl "wpa" --include=*.md then read only the hits.
• By use case: every doc tags its use_cases: (e.g. UC-33). To find where UC-33 lives: look it up in uc-index.json, or grep -rl "UC-33" --include=*.md.
• By freshness: facts that may be stale are flagged inline with (verify). grep -rn "(verify)" . lists every volatile claim.
• Follow related: in frontmatter — it's the explicit cross-link graph between docs.
• Each sub-domain (cards/ wifi/ bluetooth/ firmware/ hardware/ resources/) has a README.md hub.

Doc format (the house style — follow it when adding/editing)

Every .md content doc has this shape:

---
title: WPA Handshake + PMKID Capture
domain: wifi
type: reference
status: detailed
summary: Capture the WPA 4-way handshake / PMKID and crack it offline with hashcat.
hardware: [esp32-marauder]
use_cases: [UC-33]
related: [wifi/own-network-audit.md, wifi/deauth.md, theory/human-layer.md]
tags: [wpa, pmkid, eapol, hashcat, offline-cracking]
last_verified: 2026-06-19
---

# WPA Handshake + PMKID Capture

> **TL;DR —** One or two sentences a reader/agent can use to judge relevance without reading the body.
> Cross-links to related docs. Part of the [KB](README.md).

<body…>

## Open questions / to research
- …

## Sources
- …