* improve: enhance api-designer based on automated review
- Add real gRPC/protobuf service design coverage (proto example, service checklist, service.proto deliverable) to match the agent's advertised REST/GraphQL/gRPC scope
- Adopt RFC 9457 Problem Details for REST error responses, replacing the bespoke ApiError schema
- Update target spec version from OpenAPI 3.1 to OpenAPI 3.2, noting new streaming/SSE, additionalOperations, and OAuth2 Device Flow capabilities
- Add machine-readable/AI-agent discoverability guidance (predictable spec path, llms.txt/agents.json)
- Bring rate-limiting header guidance to parity with api-architect (RateLimit/RateLimit-Policy alongside Retry-After)
- Add permissionMode: acceptEdits and missing cross-agent references (graphql-architect, graphql-security-specialist, graphql-performance-optimizer)
- Pin Apollo Federation 2.10+ with required @link directive; reference AsyncAPI 3.0 for webhook specs
Automated review cycle | Co-Authored-By: Claude Code <noreply@anthropic.com>
* fix: correct protobuf field-deprecation guidance in api-designer
A field number cannot be simultaneously declared (even as deprecated)
and listed in `reserved` - protoc rejects that. Clarify the two valid
patterns: keep a deprecated field's number declared, or reserve the
number only after removing the field entirely.
Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01QAafnmzU8wyRwuyjr7hGg9
* fix: correct RFC 9457 ProblemDetails schema in api-designer example
Per RFC 9457 §3.1, all Problem Details members are optional (drop the
`required` constraint), and `type`/`instance` should use format
`uri-reference` since relative references like `/v1/transactions/abc123`
are valid but not valid absolute `uri` values.
Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01QAafnmzU8wyRwuyjr7hGg9
---------
Co-authored-by: Claude <noreply@anthropic.com>
Remove `model: sonnet/haiku/opus` from 396 component files. The Anthropic
API requires full model IDs (e.g., claude-sonnet-4-6), so shorthand names
cause 404 errors. Removing the field lets Claude Code use the user's
configured default model instead.
Fixes#99https://claude.ai/code/session_01Hqx78XZNbdfh38YGZn4g4T
Co-authored-by: Claude <noreply@anthropic.com>
Daniel Avila