Audit API Consistency

Overview

Scan the codebase for API route definitions and analyze them for consistency across naming, HTTP method usage, error response shapes, pagination, auth patterns, and versioning. Produce a structured report with severity-rated findings and concrete fix recommendations. This is an audit skill -- it analyzes what exists, it does not create new APIs.

Workflow

1. Read project context -- Read .chalk/docs/engineering/ for:

   • Existing API design documents that define the intended conventions
   • Architecture docs describing the API layer
   • Any API style guides or conventions documents
   • Prior audit reports to check if previously flagged issues were resolved

2. Discover route definitions -- Scan the codebase to find all API endpoints:

   • Use Grep to search for route registration patterns:
     • Express/Koa: router.get, router.post, app.use, etc.
     • Django: path(, url(, @api_view
     • Spring: @GetMapping, @PostMapping, @RequestMapping