Phase 2: Proof

Phase 2: Proof — Document GitHub + Cloudflare Using Universal Patterns

Status: ❌ Not Started
Depends on: Phase 1 completion (build verification)

Objective

Prove the universal patterns work outside ISE by documenting two vendors that already have code implementations but minimal documentation.

Why These Two Vendors

Vendor Code State Why It Proves the Pattern

GitHub

vendors/github/client.py (482 lines, ~40 methods), cli/github.py (930 lines)

Bearer token (PAT), Link header pagination, X-RateLimit-* headers. Tests every universal pattern against a well-known public API.

Cloudflare

vendors/cloudflare/init.py (stub), cli/cloudflare.py

Bearer token, cursor pagination. Second proof point with different pagination and rate limit patterns.

Deliverables

  • GitHub vendor documentation using only universal pattern xrefs + vendor-specific pages

  • Cloudflare vendor documentation using same approach

  • Validate that zero ISE-specific assumptions leak into universal patterns

  • Template refinement based on lessons learned

Success Criteria

A reader with no ISE knowledge can follow the GitHub integration docs end-to-end, using universal patterns for auth, pagination, and error handling.