Skip to content

docs(readme): reconcile with the 8-lens + baseline/verdict feature set - #7

Merged
eric-sabe merged 1 commit into
mainfrom
docs/readme-clarity
Jul 8, 2026
Merged

docs(readme): reconcile with the 8-lens + baseline/verdict feature set#7
eric-sabe merged 1 commit into
mainfrom
docs/readme-clarity

Conversation

@eric-sabe

Copy link
Copy Markdown
Owner

The five merged PRs added four lenses, the suppression baseline, and the verdict policy — but left the README's intro table, Quickstart, layout tree, and the 'offline vs external' paragraph stale or self-contradictory. This is a docs-only pass fixing the confusions a fresh reader would hit.

Notable corrections

  • Quickstart told readers to read manifest.json for the verdict — that's bumblebee alone (reads clean even when a lens fires). Corrected to report.sh's OVERALL: line, the same thing the routine prompt warns about.
  • 'Offline vs external' miscounted ('first six'), silently dropped skillspector, and said 'nothing leaves your machine' while osv-scanner/govulncheck query public vuln DBs. Rewritten accurately: only mcp-scan/garak phone out, both opt-in.
  • Intro table (4→all native lenses), layout tree, 'how a scan cycle works' (now notes lenses + worst-wins), and HONEY_SKILL_ROOTS text updated.

🤖 Generated with Claude Code

The merges added four lenses (smuggle, mcp, ocr, mcp-scan, garak), the
suppression baseline, and the verdict policy, leaving several sections stale or
self-contradictory. Fixes:
- intro lens table listed 4 of 8 lenses → now shows all native lenses + a
  signpost to the opt-in pair and the baseline/verdict features;
- Quickstart told readers to read manifest.json 'for the verdict' → corrected to
  report.sh's OVERALL line (manifest is bumblebee alone — the #1 mistake);
- 'How a scan cycle works' read as bumblebee-only → notes lenses run + worst-wins;
- 'offline vs external' miscounted ('first six'), dropped skillspector, and
  claimed 'nothing leaves your machine' while osv/govulncheck query public DBs →
  rewritten accurately (only mcp-scan/garak phone out, and they're opt-in);
- 'what each answers' + Layout tree + HONEY_SKILL_ROOTS text updated for the new
  lenses and lib/verdict.sh.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
@eric-sabe
eric-sabe merged commit 6554913 into main Jul 8, 2026
2 checks passed
@eric-sabe
eric-sabe deleted the docs/readme-clarity branch July 8, 2026 03:27
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