http-rest-fundamentals-stinger

name

http-rest-fundamentals-stinger

description

'HTTP and REST protocol authority: audits HTTP method safety/idempotency contracts, status-code honesty, header correctness (Cache-Control, ETag, Vary, CORS), conditional and range requests, HTTP/2 + HTTP/3 readiness, and REST architectural-style compliance. Activate when the user says \\\"audit this API\\\", \\\"is this status code correct?\\\", \\\"why is CORS failing?\\\", \\\"explain preflight\\\", \\\"PUT vs PATCH\\\", \\\"HTTP/3 ready?\\\", or when reviewing any route handler, OpenAPI spec, or HTTP trace. Do NOT activate for TLS/cipher config (devops-worker-bee), auth token semantics (auth-worker-bee), or crawler-facing metadata (seo-aeo-worker-bee).'

http-rest-fundamentals Stinger

Procedural arsenal for http-rest-fundamentals-worker-bee, the HTTP and REST protocol authority in the Hive.

This stinger encodes the practical reference material needed to audit HTTP and REST usage authoritatively against RFC semantics. It is organized around eight concern areas, each with its own guide, plus templates for common deliverables and worked examples for the most frequently misunderstood scenarios.

Paired Bee: .claude/agents/http-rest-fundamentals-worker-bee.md Command Brief: ai-tools/command-briefs/http-rest-fundamentals-worker-bee-command-brief.md

---

First action when this stinger is loaded

Read these in order before doing anything:

1. guides/00-principles.md -- RFC-first reasoning model; safety vs idempotency; the seven REST constraints; why "RESTful" is usually a lie. This is the foundation every other guide builds on.
2. guides/10-failure-modes.md (if it exists; otherwise check reports/README.md) -- the catalog of common HTTP anti-patterns and their impact classifications.
3. The guide most relevant to the current task (see index below).

Then pick the appropriate template from for the deliverable the Bee is producing.