api-integration-checklist
/api-integration-checklist
Run this checklist before finalising architecture for any project that fetches data from a third-party API. Catches integration blockers at design time instead of runtime.
Step 0: Verify endpoint documentation against live API
Before writing any code, confirm that every endpoint in the API docs (or api.md) actually works as documented. Documentation errors are the #1 source of wasted implementation cycles.
# For each documented endpoint, run a real curl and confirm:
# 1. Status 200 (or expected success code)
# 2. Parameters match exactly (name, casing, required vs optional)
# 3. Response shape matches documented schema
# Example — compare documented ?id= vs actual parameter name:
curl -si "https://api.example.com/search?id=abc123" | head -5
# vs
curl -si "https://api.example.com/search?i=abc123" | head -5
More from dididy/ralph-kage-bunshin
ralph-kage-bunshin-debug
Use when a ralph worker has 3+ consecutive failures and needs diagnosis — reads error output and code to find root cause with file:line evidence, proposes ONE fix (does not implement it), writes debug_session to state.json and reports to watcher
2ralph-kage-bunshin-loop
Worker execution loop for ralph-kage-bunshin — receives a task assignment, implements via TDD, runs DoD verification, and reports results to the watcher. Invoked by the watcher, not manually.
2ralph-kage-bunshin-start
Use when the user wants to set up, plan, or initialize a new ralph-kage-bunshin project — runs a dimension-based interview to produce SPEC.md, tasks.json (with dependency waves), and CLAUDE.md so workers can start
2ralph-kage-bunshin-verify
Use to independently validate a ralph worker's completed task without changing state — re-runs tests and build, checks each acceptance criterion and E2E scenario, returns PASS/FAIL/INCOMPLETE verdict. Read-only; does not write to state.json or tasks.json (use /ralph-kage-bunshin-architect to approve/reject).
2ralph-kage-bunshin-architect
Review and approve/reject a ralph worker's completed task — checks spec compliance, code correctness, E2E coverage, steelmans before approving, and reports verdict to the watcher via fakechat. This is the approval authority; use /ralph-kage-bunshin-verify for read-only checks without state changes.
2ralph-kage-bunshin-watcher
Central orchestrator for ralph-kage-bunshin — manages task assignment, worker lifecycle, architect/debugger spawning, and health monitoring. Invoked automatically by `ralph team`, not manually.
1