Quality Gate Reference
- Checklist Item: ARC-004 (API Contract Design)
- Current Score: 0.35/1.0
- Impact: High — blocks Tier 1 floor (0.5 minimum)
- Effort: Low
Description
ARC-004 checks for formal API contracts (OpenAPI, JSON Schema, Protocol Buffers). This Claude Code plugin's interface is markdown files (agents/.md, skills//SKILL.md) consumed by Claude Code's runtime — not HTTP endpoints or programmatic interfaces.
The correct action is a documented suppression: "Plugin interface is defined by markdown file conventions per Claude Code plugin spec; no programmatic API surface exists that would benefit from OpenAPI/JSON Schema contracts."
Optionally, add a PLUGIN-SPEC.md documenting the expected markdown structure as a lightweight contract.
Acceptance Criteria
Quality Gate Reference
Description
ARC-004 checks for formal API contracts (OpenAPI, JSON Schema, Protocol Buffers). This Claude Code plugin's interface is markdown files (agents/.md, skills//SKILL.md) consumed by Claude Code's runtime — not HTTP endpoints or programmatic interfaces.
The correct action is a documented suppression: "Plugin interface is defined by markdown file conventions per Claude Code plugin spec; no programmatic API surface exists that would benefit from OpenAPI/JSON Schema contracts."
Optionally, add a
PLUGIN-SPEC.mddocumenting the expected markdown structure as a lightweight contract.Acceptance Criteria
.cogitations/config.yamlwith justification