/api-review

Review an OpenAPI specification against AIP (API Improvement Proposals) principles. Outputs a structured findings document.

# API Review

Analyze an OpenAPI specification against Google's API Improvement Proposals (AIP) using the deterministic JS reviewer.

## Usage



## Instructions

1. **Resolve the spec path**:
   - If `$ARGUMENTS` provided, use that file path
   - If no argument, check for recent discovery doc in `thoughts/api/discovery/`
   - If multiple specs in discovery, ask user which to review

2. **Choose review method** (prioritize MCP tools when available):

   **Option A: MCP Tool (Recommended)**

   If the `mcp__aip-reviewer__aip-review` tool is available, use it:

   

   The MCP tool will:
   -...